Win

When a player wins, our API will send a callback request to credit the win amount to the player's balance and retrieve the updated balance.

This is an idempotent operation. If the wallet receives more than one request with the same transactionId the transaction must be registered only once in the wallet.

URL	{operatorCallbackURL}
Method	POST
Headers	X-Request-Signature Content-Type Accept
Request Body	{ command: "win", transactionId: "SP215202", playerId: "1101", roundId: "65215842315484512", providerId: 2, providerName: "EGT Digital", gameCode: "FSHBLSlot", gameName: "40 Burning Hot Bell Link", currency: "EUR", amount: 100, isRoundFinished: true, isCall: false, timestamp: 1586335186372 }
Response Body	{ balance: 1591.52, statusCode: "OK" }

Request

Parameter	Values	Mandatory	Description
command	string	Y	Indicates the request type.
transactionId	string	Y	Unique reference of the transaction created in our API.
playerId	string	Y	Unique identifier of the player from the operator's system.
roundId	string	Y	Unique reference of the game round.
providerId	number	Y	Unique identifier of the provider in our API.
providerName	string	Y	The name of the provider.
gameCode	string	Y	Unique identifier of the game in our API
gameName	string	Y	The name of the game.
currency	string	Y	Player currency, according to ISO-4217 (EUR, USD ...)
amount	number	Y	Transfer amount.
isRoundFinished	boolean	Y	Indecates whether the round is finished or not. If true, no other "win" callbacks will be sent after this callback, but if false, other corresponding callbacks will be sent.
isCall	boolean	Y	If true, Player is in undergoing bonus call event.
timestamp	number	Y	Timestamp of the request.

Response

Parameter	Values	Mandatory	Description
balance	number	Y	Player balance.
statusCode	string	Y	Status code of the execution.

Possible Status Codes

Status codes	Reason
OK	Request successful
ERR_INTEGRITY_CHECK_FAILED	Message integrity check failed.
ERR_NOT_AUTHENTICATED	Player is not authenticated
ERR_UNKNOWN	Internal server error

In case statusCode is different than "OK", the request will be treated as unsuccessful.

A response must be provided within 4 seconds. If the callback request times out or returns a specific error, our API will automatically retry the request up to two more times.

Example

Request

{
   command: "win",
   transactionId: "SP215202",
   playerId: "1101",
   roundId: "65215842315484512",
   providerId: 2,
   providerName: "EGT Digital",
   gameCode: "FSHBLSlot",
   gameName: "40 Burning Hot Bell Link",
   currency: "EUR",
   amount: 100,
   isRoundFinished: true,
   isCall: false,
   timestamp: 1586335186372
}

OK Response

{
    "balance": 19839891,
    "statusCode": "OK"
}

Error Response

{
    "statusCode": "ERR_UNKNOWN",
    "balance": 19839880
}