Skip to main content
POST
/
payments
/
virtual-account
/
deposit-instructions
Create or retrieve standing virtual-account onramp deposit instructions
curl --request POST \
  --url https://api-sb.meld.io/payments/virtual-account/deposit-instructions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinationCurrencyCode": "USDC",
  "destinationWalletAddress": "0xe51f36521fF5D857824e615a64D34808534a55f4",
  "paymentMethodType": "ACH",
  "serviceProvider": "ACROSS",
  "sourceCurrencyCode": "USD"
}
'
{
  "customerId": "<string>",
  "depositInstructionsId": "<string>",
  "destinationCurrencyCode": "<string>",
  "destinationWalletAddress": "<string>",
  "receivingBankInformation": {
    "paymentMethodType": "<string>",
    "accountNumber": "<string>",
    "routingNumber": "<string>",
    "bankName": "<string>",
    "accountHolderName": "<string>"
  },
  "serviceProviderDetails": {},
  "sourceCurrencyCode": "<string>"
}

Authorizations

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

Headers

​
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:

"0xe51f36521fF5D857824e615a64D34808534a55f4"

​
paymentMethodType
enum<string>
required

Fiat rail used to fund the virtual account

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

Service provider for the virtual deposit account

Available options:
ACROSS,
AEROPAY,
AKOYA,
ALCHEMYPAY,
APPLEPAY,
AUTHORIZENET,
BANXA,
BILIRA,
BINANCECONNECT,
BINANCEPAY,
BLOCKCHAINDOTCOM,
BOOMFI,
BRAINTREE,
BRALE,
BTCDIRECT,
CASHAPP,
CHECKOUT,
CIRCLE,
COINBASEPAY,
COINFLOW,
DUENETWORK,
ELDORADO,
FINICITY,
FLASHNET,
FONBNK,
GUARDARIAN,
HARBOUR,
KOYWE,
KRYPTONIM,
MERCURYO,
MESH,
MESO,
MOONPAY,
MOOV,
MX,
NMI,
NOAH,
ONMETA,
ONRAMPMONEY,
PAYBIS,
PAYPAL,
PLAID,
RAMP,
REVOLUT,
ROBINHOOD,
ROUTERPROTOCOL,
SALTEDGE,
SALTEDGEPARTNERS,
SARDINE,
SHIFT4,
SHOPIFY,
SIMPLEX,
SKRILLCRYPTO,
SQUARE,
STRIPE,
SUMSUB,
SWAPPED,
TANGOCARD,
TELLER,
TOPPER,
TRANSAK,
TREMENDOUS,
TRANSFI,
UNLIMIT,
UPHOLD,
WYRE,
XANPOOL,
YELLOWCARD,
YODLEE
​
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

Meld customer id

​
depositInstructionsId
string

Unique id for this deposit instruction row

​
destinationCurrencyCode
string

Destination cryptocurrency code

​
destinationWalletAddress
string

Destination wallet address for purchased crypto

​
paymentMethodType
enum<string>

Payment method type for the fiat deposit rail

Available options:
ACH,
SEPA,
PIX,
MOBILE_MONEY
​
receivingBankInformation
AchReceivingBankInformation · object

Bank information for the fiat transfer; shape depends on paymentMethodType

​
serviceProvider
enum<string>

Service provider

Available options:
ACROSS,
AEROPAY,
AKOYA,
ALCHEMYPAY,
APPLEPAY,
AUTHORIZENET,
BANXA,
BILIRA,
BINANCECONNECT,
BINANCEPAY,
BLOCKCHAINDOTCOM,
BOOMFI,
BRAINTREE,
BRALE,
BTCDIRECT,
CASHAPP,
CHECKOUT,
CIRCLE,
COINBASEPAY,
COINFLOW,
DUENETWORK,
ELDORADO,
FINICITY,
FLASHNET,
FONBNK,
GUARDARIAN,
HARBOUR,
KOYWE,
KRYPTONIM,
MERCURYO,
MESH,
MESO,
MOONPAY,
MOOV,
MX,
NMI,
NOAH,
ONMETA,
ONRAMPMONEY,
PAYBIS,
PAYPAL,
PLAID,
RAMP,
REVOLUT,
ROBINHOOD,
ROUTERPROTOCOL,
SALTEDGE,
SALTEDGEPARTNERS,
SARDINE,
SHIFT4,
SHOPIFY,
SIMPLEX,
SKRILLCRYPTO,
SQUARE,
STRIPE,
SUMSUB,
SWAPPED,
TANGOCARD,
TELLER,
TOPPER,
TRANSAK,
TREMENDOUS,
TRANSFI,
UNLIMIT,
UPHOLD,
WYRE,
XANPOOL,
YELLOWCARD,
YODLEE
​
serviceProviderDetails
object

Raw provider-specific fields not mapped into receivingBankInformation

​
sourceCurrencyCode
string

Source fiat currency code