Win

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

Request


[POST] {WALLET_URL}/

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_finished	integer	no	`1` when this win closes the round, see Round completion
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

Request body:


{
    "user_id": 10000,
    "action": "win",
    "amount": 0.20,
    "currency": "USD",
    "game_id": 19773,
    "transaction_id": "054525d7cc7f426c947d38ff35d17d30",
    "round_id": "33403baa3a374218a8d4a8c92493f055",
    "ext_round_id": "33403baa3a374218a8d4a8c92493f055"
}

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