virtual_accountsCreate Virtual Account

Create Virtual Account

Create a virtual account with its stablecoin destination.

curl -X POST "https://sandbox.rasto.co/api/customers/example_string/virtual_accounts" \
  -H "Content-Type: application/json" \
  -H "Api-Key: example_string" \
  -H "Api-Version: example_string" \
  -H "Idempotency-Key: example_string" \
  -H "Api-Key: YOUR_API_KEY" \
  -d '{
  "currency": "example_string",
  "rail": "example_string",
  "destination": {
    "kind": "address",
    "chain": "example_string",
    "asset": "example_string",
    "address": "123 Main St",
    "wallet_id": "example_string",
    "memo": "example_string"
  },
  "partner_fee_bps": 3.14,
  "partner_fee_flat": 3.14,
  "partner_reference_id": "example_string"
}'
{}
POST
/api/customers/{customer_id}/virtual_accounts
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: Api-Key)
Api-Keystring
Required

API key (sent in header)

Content-Typestring
Required

The media type of the request body

Options: application/json
header
Api-Versionstring

The /api contract to serve this request under, as an ISO date. Omit to use the default (2026-08-01), omitting it always keeps today's behaviour, so a future breaking change cannot move you. Supported: 2026-08-01.

header
Idempotency-Keystring
Required

Unique per request; a retry with the same key replays the stored response byte-for-byte.

destinationobject
Required

Where delivered funds go: an external address OR a held wallet. Attributes: kind: "address" (external, the default) | "wallet" (deliver into one of the customer's held wallets, standing VA→wallet routing). chain: Required for kind=address; FORBIDDEN for kind=wallet, the wallet supplies it. asset: What to deliver, always required. address: Same rule as chain. wallet_id: Required for kind=wallet. memo: kind=address only.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Api-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

Headers

Api-Versionstring

The /api contract to serve this request under, as an ISO date. Omit to use the default (2026-08-01), omitting it always keeps today's behaviour, so a future breaking change cannot move you. Supported: 2026-08-01.

Idempotency-Keystring
Required

Unique per request; a retry with the same key replays the stored response byte-for-byte.

Body

application/json
destinationobject
Required

Where delivered funds go: an external address OR a held wallet.

Attributes: kind: "address" (external, the default) | "wallet" (deliver into one of the customer's held wallets, standing VA→wallet routing). chain: Required for kind=address; FORBIDDEN for kind=wallet, the wallet supplies it. asset: What to deliver, always required. address: Same rule as chain. wallet_id: Required for kind=wallet. memo: kind=address only.

Responses