Balance - Query Balance

Query the member’s current available balance.

Request Parameters

Request Body Before Decryption

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}

info

For the decryption algorithm, please refer to the Operator API Implementation Description

Request Body After Decryption

{
  action: 'balance',
  uid: 'gameTest1',
  currency: 'PHP',
  brand: 'VP'
}

參數	Type	Required	Description
action	string	Yes	Fixed to "balance"
uid	string	Yes	Player Account
currency	string	Yes	Currency
brand	string	Yes	Game Brand

Response Format

info

The response is returned as plaintext JSON and does not require encryption.

Success response

{
  status: '0000',
  errText: '',
  balance: 12345.67,
  responseTime: '2024-12-11T01:23:38.271Z'
}

Field	Type	Description
status	string	Transaction status
errText	string	Error message; empty string on success
balance	number	Current available balance
responseTime	string	Response time

Important Notes

1. Token Validation: The token is validated for every query to ensure it is still valid
2. Real-time Balance: The returned balance represents the real-time available balance
3. Currency Consistency: Ensure the currency matches the platform configuration
4. Caching Strategy: It is recommended to apply moderate client-side caching to reduce query frequency
5. Concurrency Control: Under high concurrency, the request may need to wait for lock release
6. Query Frequency: Requests are sent once every 10 seconds after a player enters the game, until the player exits.