Skip to main content
iGamingAce sends the balance callback when a player launches a game and every minute during gameplay to keep their displayed balance up to date. Before returning the player’s balance, you must verify that the player’s session is still active and authenticated. Any status code other than OK terminates the current process flow and displays an error message to the player.
  • URL: Your configured Callback URL
  • Method: POST
  • Headers: X-Request-Signature, Content-Type, Accept

​
Request parameters

​
command
string
required
Always "balance" for this callback type.
​
playerId
string
required
Unique identifier of the player from your system.
​
timestamp
number
required
Unix timestamp of the request.

​
Response fields

Your server must respond with HTTP 200 and a JSON body containing the following fields:
​
balance
number
The player’s current balance.
​
statusCode
string
required
Result of the operation. Must be "OK" on success. See the status codes table below for all possible values.

​
Status codes

Status codeDescription
OKRequest successful
ERR_INVALID_ACCOUNTThe player’s currency does not match the currency code in the request
ERR_NOT_AUTHENTICATEDThe player is not authenticated
ERR_INVALID_PLAYER_IDThe player ID is invalid
ERR_INTEGRITY_CHECK_FAILEDMessage integrity check failed
ERR_UNKNOWNInternal server error
Any status code other than OK is treated as unsuccessful. No retry will be scheduled — the current process flow is terminated immediately and an error message is shown to the player.

​
Examples

{
  "command": "balance",
  "playerId": "1101",
  "timestamp": 1586335186372
}