Query Balance
Retrieve the player's balance. API provided by the game platform; called by the merchant (operator).
Request URL
POST {API_URL_ROOT}/player/getBalance
Request Parameters
Header
| Field | Required | Type | Description |
|---|---|---|---|
| sign | YES | string | Signature computed using the Signature Algorithm. |
| timestamp | YES | int | UTC timestamp in seconds since 1970-01-01, e.g. 1741837297. |
| Accept-Language | YES | string | Language codes, see Language List. |
| Content-Type | YES | string | "application/json; charset=utf-8" |
| Authorization | YES | string | JWT Bearer token, e.g. "Bearer TOKEN" |
Body
| Field | Required | Type | Description |
|---|---|---|---|
| userId | YES | string | Merchant's player ID. |
Response Parameters
| Field | Required | Type | Description |
|---|---|---|---|
| balance | YES | double | Player balance. |
| currency | NO | string | Game currency code. |
Example
{
"isSuccess": true,
"code": 0,
"data": {
"balance": 100000,
"currency": "BRL"
}
}