Skip to main content
Create a virtual bank account for a customer. The customer must have KYC approved (is_va_approved: true) before a virtual account can be issued. 
POST /v1/business/virtual-account/create
Requires an Idempotency-Key header. Each customer can hold one virtual account per currency.

​
Request Body

​
currency
string
required
Currency for the virtual account. Supported values: MXN, BRL, USD, EUR, MXN_USD, MXN_BASE, MXNBASE, EURBASE, USDBASE, EUR_BASE, USD_BASE, EURDE, USDDE, GBP, USD_KIRA, USDKIRA.
​
customer_id
string
The UUID of the KYC-approved customer. Required when currency is USD; optional for other currencies.
curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-key-here' \
  -d '{
    "currency": "BRL"
  }'

curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-key-here' \
  -d '{
    "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
    "currency": "USD"
  }'

{
  "status": "success",
  "status_code": 201,
  "message": "Virtual account creation in progress",
  "data": {
    "account_id": "va_xxxxxx",
    "account_number": "9900123456",
    "account_type": "savings",
    "currency": "BRL",
    "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
    "created_at": "2026-04-01T10:00:00Z"
  }
}