Wallet Adapter
Balance
Balance lookup contract for the operator wallet adapter.
Balance
Return current operator-owned wallet balance for one user.
Path
GET /balance
Query params
| Parameter | Type | Requirement | Notes |
|---|---|---|---|
external_user_id | string | Required | Stable operator-side user ID. |
currency_code | string | Required | Expected wallet currency. Current REST v1 value: IDR. |
Example
GET /balance?external_user_id=operator-user-123¤cy_code=IDR
Response
{
"external_user_id": "operator-user-123",
"currency_code": "IDR",
"balance_minor": 150000,
"remote_reference": "wallet-lookup-123"
}
| Field | Type | Requirement | OpenPoly behavior |
|---|---|---|---|
balance_minor | integer | Required | Must be numeric and finite. Missing, non-numeric, or non-finite values produce REST_V1_INVALID_BALANCE_RESPONSE. This is the only response field required by the parser. |
external_user_id | string | Optional | Falls back to the requested ID when omitted. Connection tests reject a mismatched non-empty value. |
currency_code | string | Optional echo | The current parser uses the requested operator currency. |
remote_reference | string | Optional | Preserved for observability when non-empty. |
Rules
- return integer
balance_minor; do not send major-unit decimals - currency must match operator integration currency
- no floating values
- signing header is not sent for this GET request