Skip to main content
The win callback is sent when a player wins a round. Your server must credit the win amount to the player’s balance and return the updated balance. This operation is idempotent — if your wallet receives more than one request with the same transactionId, you must register the transaction only once. No need to add “Win” 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 "win" for this callback type.
​
long
required
Unique reference of the transaction created in our system. Use this to enforce idempotency.
​
string
required
Unique identifier of the player from your system.
​
long
required
Unique reference of the game round.
​
number
required
Unique identifier of the game provider in our system.
​
number
required
Unique game id of the game in our system.
​
number
required
Win amount to credit to the player’s balance.
​
boolean
required
Indicates whether the round is complete after this win. If true, no further win callbacks will be sent for this round. If false, additional win callbacks may follow.
​
long
required
0: no bonus, else the bonus id related
​
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
required
The player’s updated balance after the win amount is credited.
​
string
required
Result of the operation. Must be "OK" on success. See the status codes table below for all possible values.

​
Status codes

Your response must be returned within 4 seconds. If the request times out or returns an error, we will automatically retry the request up to 2 more times.

​
Examples