Bet

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

Request


[POST] {WALLET_URL}/

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

Request body:


{
    "user_id": 10000,
    "action": "bet",
    "amount": 0.25,
    "currency": "USD",
    "game_id": 19773,
    "transaction_id": "2412fb89e9e94b28b0f35d28cd818202",
    "round_id": "f85eb4d5a67940f7b4ab06958be5a908",
    "ext_round_id": "f85eb4d5a67940f7b4ab06958be5a908"
}

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.