Virtual Accounts

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).

Request

Base URL
https://api.stables.money
Auth
- HTTP bearer
- or API key in header X-Api-Key
TypeScript
https://skmtc.dev/stables/apis/stables-api/docs/api/v1/customers/:customerId/virtual-accounts/post.ts
A function with typed inputs. Its response is checked against the schema.

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.

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

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