Win

Called when the player wins. The wallet must credit amount to the player’s balance and return the new balance.

Request


[GET] {WALLET_URL}/?user_id=10000&action=win&amount=0.20&currency=USD&game_id=19773&transaction_id=054525d7cc7f426c947d38ff35d17d30&round_id=33403baa3a374218a8d4a8c92493f055&ext_round_id=33403baa3a374218a8d4a8c92493f055

Parameter	Type	Required	Description
action	string	yes	always `win`
user_id	integer	yes	user’s ID at the casino
currency	string(3)	yes	currency code in ISO 4217 format
amount	float	yes	amount to credit, in the major currency unit
game_id	integer	yes	unique game id
transaction_id	string(32)	yes	unique transaction id, use it to reject duplicates
round_id	string(32)	yes	id of the game round the win belongs to
ext_round_id	string(32)	no	game provider’s own round id, when it differs from `round_id`
ext_round_id_finished	string	no	set when this win closes the external round
freespins_id	string	no	the Gift Spin id, when the win is part of a gift spin session
freespins_finished	string	no	set when this win is the last one of the gift spin session

transaction_id is unique per transaction. If the same transaction_id arrives twice, treat it as a duplicate and do not credit the player again — see error 1007.

Response

Response should be a json object.


{
    "status": "OK",
    "balance": 100.05,
    "currency": "USD"
}

Parameter	Type	Required	Description
status	string	yes	`OK` on success, `ERROR` otherwise
balance	float	yes	player’s balance after the win
currency	string(3)	yes	currency code in ISO 4217 format