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.

API Key

Add parameter in header

API-KEY

Example:

API-KEY: ********************

API Key

Add parameter in header

API-SIGNATURE

Example:

API-SIGNATURE: ********************

API Key

Add parameter in header

API-TIMESTAMP

Example:

API-TIMESTAMP: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Success or business error envelope; check status and code.

Bodyapplication/json

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"
}