curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Virtual Accounts
Create Virtual Account
Issue a virtual bank account to a customer to receive funds
POST
/
business
/
virtual-account
/
create
curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Create a virtual bank account for a customer. The customer must have an approved endorsement for the currency (see
GET /business/virtual-account/currencies-and-endorsements) 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.curl -X POST 'https://api.yativo.com/api/v1/business/virtual-account/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-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"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Body
application/json
Currency code for the virtual account, for example USDBASE, EURBASE, MXN or BRL. GET /business/virtual-account/currencies-and-endorsements returns every code your account can use and the endorsement each one needs.
Example:
"BRL"
The UUID of the KYC-approved customer. Required when currency is USD; optional for other currencies.