Bet

Called when the player places a bet. The wallet must debit amount from the player’s balance and return the new balance.

Request


[GET] {WALLET_URL}/?user_id=10000&action=bet&amount=0.25&currency=USD&game_id=19773&transaction_id=2412fb89e9e94b28b0f35d28cd818202&round_id=f85eb4d5a67940f7b4ab06958be5a908&ext_round_id=f85eb4d5a67940f7b4ab06958be5a908

Parameter	Type	Required	Description
action	string	yes	always `bet`
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 debit, 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 bet 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 bet closes the external round
freespins_id	string	no	the Gift Spin id, when the bet is part of a gift spin session
freespins_finished	string	no	set when this bet 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 debit 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 bet
currency	string(3)	yes	currency code in ISO 4217 format

If the player cannot cover the bet, respond with error 1006 instead of a success payload.