Skip to main content
POST
Create or retrieve standing virtual-account onramp deposit instructions

Authorizations

Authorization
string
header
default:BASIC <Meld API Key>
required

Headers

Meld-Version
string

Dated API version to use for this request, e.g. 2026-02-03.

Example:

"2023-12-19"

X-Idempotency-Key
string<uuid>

Body

application/json

Request to provision or retrieve standing virtual-account deposit instructions

customerId
string
required

Meld customer id

Minimum string length: 1
destinationCurrencyCode
string
required

Destination cryptocurrency code

Minimum string length: 1
Example:

"USDC"

destinationWalletAddress
string
required

Wallet address that will receive the purchased cryptocurrency

Minimum string length: 1
Example:

"0x000000000000000000000000000000000000dEaD"

paymentMethodType
enum<string>
required

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

Available options:
ACH,
SEPA,
PIX,
MOBILE_MONEY
serviceProvider
enum<string>
required

Service provider used for creating the virtual deposit account

Available options:
NOAH,
DUENETWORK
Example:

"NOAH"

sourceCurrencyCode
string
required

Source fiat currency code

Minimum string length: 1
Example:

"USD"

customerPhoneNumber
string

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

Response

Deposit instructions created or returned successfully

Standing virtual-account deposit instructions

customerId
string
required

Meld customer id

Minimum string length: 1
depositInstructionsId
string
required

Unique id for this deposit instruction row

Minimum string length: 1
destinationCurrencyCode
string
required

Destination cryptocurrency code

Minimum string length: 1
destinationWalletAddress
string
required

Destination wallet address for the purchased crypto

Minimum string length: 1
Example:

"0x000000000000000000000000000000000000dEaD"

paymentMethodType
enum<string>
required

Type of the virtual account created

Available options:
ACH,
SEPA,
PIX,
MOBILE_MONEY
serviceProvider
enum<string>
required

Service provider

Available options:
NOAH,
DUENETWORK
Example:

"NOAH"

sourceCurrencyCode
string
required

Source fiat currency code

Minimum string length: 1
receivingBankInformation
AchReceivingBankInformation · object

Bank information for the fiat transfer; shape depends on paymentMethodType

serviceProviderDetails
object

Raw provider-specific fields not mapped into receivingBankInformation