create virtaul account

This endpoint lets you create a fiat receiving account (Virtual Account, “VA”) for a specific currency. A VA is a bank-style deposit handle issued to you (or to your end-customer under your tenancy) so funds can be received and reconciled automatically and later used in transfer flows.

💡

Supported VA types & rails: see Supported Virtual Accounts (link to be provided). Different rails may have different attributes (e.g., bank code, branch, IBAN/CLABE/PIX key).

Currency: pass the 3-letter ISO 4217 code (e.g., BRL, USD, EUR). The VA will be issued on the corresponding fiat rail for that currency.

Two creation modes

Create for your own

Create for your customer (sub-user)

First Step

Provide only the currency.

Second Step

A VA will be issued in your merchant’s name. Use it to collect funds that will be settled into your BPN balance and available for subsequent FX/transfer operations.

Notes

The response returns the virtual account details issued by the rail (e.g., account number / bank code / holder name / PIX key, depending on the rail).

Use the VA only for the specified currency. Cross-currency deposits are not supported.

For compliance (e.g., Travel Rule / payer data), some rails may require payer metadata at deposit time; follow the rail-specific guidance in the Supported Virtual Accounts page.

To remove a VA that is no longer needed, use the Delete Account endpoint.

curl --location --request POST '/v1/virtual-account/sub/create' \ --header 'Content-Type: application/json' \ --data-raw '{ "currency": "string", "companyName": "string", "accountSubType": "STATIC" }'

{ "status": 0, "message": "string", "data": { "virtualAccountId": "string", "accountName": "string", "currency": "string", "status": "string", "qrCode": "string", "qrCodeImage": "string", "subAccountType": "string", "expireTime": "string" }, "traceId": "string" }

create virtaul account

Request

Responses