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.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

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