Inquiry Master VA Balance

Query the available balance of the Master Virtual Account (Master VA) for a given fiat currency (ISO 4217). Returns usable balance, internal primary account id (primaryAccountId, same as wallet virtualAccountId), and balanceString for display.

Query parameters

currency (required): ISO 4217 code (e.g. BRL, USD, EUR).

externalAccountId (optional): forwarded to the wallet service when applicable.

Use cases

Pre-check balance before payout or transfer.

Treasury monitoring by currency.

Obtain primaryAccountId for APIs that require the master VA id.

Responses

🟢200Success

application/json

Success or business error envelope; check status and code.

Bodyapplication/json

Examples

Success (BRL)Success (USD)Business error (example)

{
    "status": 200,
    "msg": "OK",
    "code": null,
    "data": {
        "primaryAccountId": "1000123456",
        "currency": "BRL",
        "balance": 1999.5,
        "balanceString": "1999.5"
    },
    "traceId": "39d760f9a1814c4896a774bcf79da528"
}

Inquiry Master VA Balance

Request

Request Code Samples

Responses