List Primary Virtual Accounts

Purpose:
Retrieve primary (master) virtual accounts for the authenticated Stable merchant. Each item is a condensed view suitable for selection UI or routing to balance/detail APIs.

What this endpoint does:

Calls the wallet getPrimaryAccountList once with merchantId and userId resolved from the gateway context. Returns an array of primary accounts with accountId, accountName, and currency only (no pagination at this layer).

Keynotes:

No query parameters — context-only identification.

accountId is the internal primary VA id (same as wallet virtualAccountId).

On success, data is a JSON array (may be empty). On business failure, data may be null and code / msg describe the error.

Envelope fields align with JsonRes: status, msg, optional code, data, traceId.

traceId is always present for troubleshooting and request correlation.

Responses

🟢200

application/json

Success or business error envelope; check status and code.

Body

Examples

Success with multiple primariesSuccess with no primary accountsBusiness error (example)

{
    "status": 200,
    "msg": "OK",
    "code": null,
    "data": [
        {
            "accountId": "1000123456",
            "accountName": "Acme Ltd BRL Master",
            "currency": "BRL"
        },
        {
            "accountId": "1000123457",
            "accountName": "Acme Ltd USD Master",
            "currency": "USD"
        }
    ],
    "traceId": "39d760f9a1814c4896a774bcf79da528"
}

List Primary Virtual Accounts

Request

Request Code Samples

Responses