MEmeld
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

Request

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

customerIdstring required

Meld customer id

depositInstructionsIdstring required

Unique id for this deposit instruction row

destinationCurrencyCodestring required

Destination cryptocurrency code

destinationWalletAddressstring required

Destination wallet address for the purchased crypto

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

Type of the virtual account created

serviceProvider'NOAH' | 'DUENETWORK' required

Service provider

serviceProviderDetailsobject

Raw provider-specific fields not mapped into receivingBankInformation

sourceCurrencyCodestring required

Source fiat currency code

Example response

{
  "destinationWalletAddress": "0x000000000000000000000000000000000000dEaD",
  "serviceProvider": "NOAH"
}

Changes

No recorded changes to this operation across all 1 revision of this API.