Virtual Accounts

Virtual accounts are dedicated bank account numbers linked to a wallet. When funds arrive at the virtual account, they are automatically credited to the associated wallet.

Create a virtual account

POST /api/v1/virtual-account

{
  "wallet_id": "wal_abc123",
  "source_currency": "USD"
}

Virtual accounts are subject to currency availability. Check can_vban: true in the GET /api/v1/currencies response.

List virtual accounts

GET /api/v1/virtual-accounts

Response

[
  {
    "id": "va_xyz789",
    "wallet_id": "wal_abc123",
    "source_currency": "USD",
    "status": "active",
    "account_name": "TurnStay - My Company",
    "bank_name": "Example Bank",
    "account_number": "9876543210",
    "routing_number": "021000021",
    "created_at": "2026-06-01T10:00:00Z"
  }
]

How deposits work

1. Create a virtual account linked to a wallet.
2. Share the bank details with your payer.
3. When funds arrive, they are automatically deposited into the linked wallet.
4. A treasury.deposit.completed webhook fires when the deposit settles.

Available fields

Depending on the currency and region, virtual accounts may include:

Field	Description
account_number	Local account number
routing_number	US routing number
iban	International Bank Account Number
bic / swift_code	Bank identifier
sort_code	UK sort code
branch_code	Branch identifier