v1

latestOpenAPI 3.1.0Apache 2.02026-07-2265186296.2 KB

Headless

Create or retrieve standing virtual-account onramp deposit instructions

Provisions a standing virtual bank account for recurring onramp deposits, or returns the existing instructions when the same customer, provider, payment method, currency pair, and destination wallet were already set up.

post/payments/virtual-account/deposit-instructions

Headers

X-Idempotency-Keystring uuid

Request body

customerIdstring required

Meld customer id

customerPhoneNumberstring

Customer phone number — required when paymentMethodType is MOBILE_MONEY and the provider requires it

destinationCurrencyCodestring required

Destination cryptocurrency code

destinationWalletAddressstring required

Wallet address that will receive the purchased cryptocurrency

paymentMethodType'ACH' | 'SEPA' | 'PIX' | 'MOBILE_MONEY' required

Desired type of virtual account to create for sending the fiat currency to

serviceProvider'NOAH' | 'DUENETWORK' required

Service provider used for creating the virtual deposit account

sourceCurrencyCodestring required

Source fiat currency code

Example request

{
  "destinationCurrencyCode": "USDC",
  "destinationWalletAddress": "0x000000000000000000000000000000000000dEaD",
  "serviceProvider": "NOAH",
  "sourceCurrencyCode": "USD"
}

Response

Deposit instructions created or returned successfully