Get Balance
Used to get the player’s current balance
API Information
- URL：
POST /v2/members/balance - Authentication：Bearer Token
- Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
request
request Headers
POST /v2/members/balance HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67
Request Parameters
Request Body Before Encryption
{
"username": "player001"
}
Encrypted Request Body
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
Response
Success Response
{
"code": 0,
"message": "No Error.",
"data": {
"agentId": "AGENTTHB01",
"username": "gameTest1",
"currency": "THB",
"balance": 993.92,
},
}
| Field | Type | Description |
|---|---|---|
data.agentId | string | The agentId which this player belongs |
data.username | string | Player Account |
data.currency | string | Currency |
data.balance | number | Current Balance |
Error Response
{
"code": 8,
"message": "The User is not exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
Common Error Codes
| Code | Description |
|---|---|
| 8 | The member does not exist. |
| 11 | Parameters error |
| 19 | Invalid account |
| 81 | Branch config not found |
| 83 | Authentication Failed |
| 84 | Decryption Failed |
Important Notes
- Real-time: Returns the current real-time balance
- Currency Consistency: The balance is displayed in the currency set when the member was created
- Precision: The balance is rounded to a maximum of 6 decimal places