latestOpenAPI 3.1.02026-08-102051102.0 KB

40ed0bdb89e1

Virtual Accounts

Create or replace the active destination for a virtual account

put/api/v1/customers/{customerId}/virtual-accounts/{virtualAccountId}/destination

Path parameters

customerIdstring uuid required

Customer UUID

Customer UUID

virtualAccountIdstring uuid required

Headers

idempotency-keystring uuid required

Required for mutating calls. Use a V4 UUID. The server stores the first result for 24h and returns it on subsequent retries with the same key.

Required for mutating calls. Use a V4 UUID. The server stores the first result for 24h and returns it on subsequent retries with the same key.

Request body

currency'usdc' | 'usdt' | 'dai' | 'pyusd' | 'eurc' required
payment_rail'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tron' required
addressstring required
memostring

Response

Default Response

idstring uuid required
status'activated' | 'deactivated' | 'pending' | 'closed' required
customer_idstring uuid required
developer_fee_percentstring
created_atstring date-time required
deposit_handling_mode'auto_payout' | 'hold' | 'manual' required
workflow_type'fiat_to_crypto' | 'fiat_to_fiat' required
metadataobject nullable