POST /api/v1/customers/:customerId/virtual-accounts

Create a virtual account for a customer. deposit_handling_mode is set server-side (defaults to auto_payout).

customerIdstring uuid required

Customer UUID

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.

Request body

developer_fee_percentstring

metadataobject

workflow_type'fiat_to_crypto' | 'fiat_to_fiat'

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