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.
  • URL: Your configured Callback URL
  • Method: POST
  • Headers: X-Request-Signature, Content-Type, Accept

​
Request parameters

​
command
string
required
Always "win" for this callback type.
​
transactionId
long
required
Unique reference of the transaction created in iGamingAce. Use this to enforce idempotency.
​
playerId
string
required
Unique identifier of the player from your system.
​
roundId
long
required
Unique reference of the game round.
​
providerId
number
required
Unique identifier of the game provider in iGamingAce.
​
gameCode
number
required
Unique game id of the game in iGamingAce.
​
amount
number
required
Win amount to credit to the player’s balance.
​
isRoundFinished
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.
​
bonusId
long
required
0: no bonus, else the bonus id related
​
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
required
The player’s updated balance after the win amount is credited.
​
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_INTEGRITY_CHECK_FAILEDMessage integrity check failed
ERR_NOT_AUTHENTICATEDThe player is not authenticated
ERR_UNKNOWNInternal server error
Your response must be returned within 4 seconds. If the request times out or returns an error, iGamingAce will automatically retry the request up to 2 more times.

​
Examples

{
  "command": "win",
  "transactionId": "SP215202",
  "playerId": "1101",
  "roundId": "65215842315484512",
  "providerId": 1,
  "gameCode": 655,
  "amount": 100,
  "isRoundFinished": true,
  "bonusId": 0,
  "timestamp": 1586335186372
}