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.
No need to add “Balance” at the end of your callback URL; you can get the request body “command” to identify which callback is coming.
- URL: Your configured Callback URL(ex: https://mycallback.com/cb)
- Method: POST
- Headers:
X-Request-Signature,Content-Type,Accept
Request parameters
string
required
Always
"balance" for this callback type.string
required
Unique identifier of the player from your system.
number
required
Unique identifier of the game provider in our system.
int
required
Unique game ID of the game in our system.
number
required
Unix timestamp of the request.
Response fields
Your server must respond with HTTP 200 and a JSON body containing the following fields:number
The player’s current balance.
string
required
Result of the operation. Must be
"OK" on success. See the status codes table below for all possible values.Status codes
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.