Debit

Description

• This interface is called when a player places a bet.
• Verifies if the player has sufficient balance, deducts the amount, and returns the player's remaining balance.
• If no response is received from the operator due to network or other factors, the player's bet will be cancelled.
• Ensure transactional integrity of the debit operation to maintain atomicity and prevent partial success scenarios.
• The interface must be idempotent, using biz_id as the idempotency key. For duplicate requests, return the result of the first successful request.

Request Method

Item	Name	Sample
Path	Path	<MerchantHost>/debit Like: http://www.game.com/debit
Request Method	Post

Request Parameters

Name	Type	Required	Description
Sign Params		Y	API Integration Specification
biz_id	string	Y	Transaction ID, globally unique, used for idempotency
round_id	string	Y	Game Round ID
game_id	int	N	Game ID
game_code	string	Y	Game index used to retrieve game data
user_id	string	Y	User Unique Identifier
currency	string	Y	Currency
amount	string	Y	Amount
reason	string	Y	Description
game_name	string	Y	game name
is_free_bet	bool	Y	true if this round is funded by a free bet, otherwise false

Free Bet

When is_free_bet is true, the round is funded by a free bet activity created by the merchant, and amount is the bet amount configured in that activity. The merchant decides how to handle it, for example by not deducting the player's real balance. false means a normal bet.

Return Parameters

Name	Type	Required	Description
code	int	Y
msg	string	Y	Error description for the code
data	object	Y	Body
data.balance	object	Y	Balance object
balance.user_id	string	Y	User unique identifier
balance.currency	string	Y	Currency
balance.amount	string	Y	Amount

Request Example

Http Request
    Post Method
    URL : <MerchantHost>/debit?mid=1697028447&sign=7e0c05f463f4a4111202b948f20a10d77263d5bb347ff2f339e77ef32062556e&ts=1713768205
    Content-Type：application/json
    {"biz_id":"1782299428894699520","round_id":"1782299428861145088","game_code":"gp_classic_4","user_id":"jUhNj+meQ16inuksiKj0zR88","currency":"PHP","amount":"12.52","reason":"","game_name":"scratch_match"}

Http Response(success)
    {
        "code": 0,
        "msg": "",
        "data": {
            "balance": {
                "amount": "23.12",
                "currency": "PHP",
                "user_id": "jUhNj+meQ16inuksiKj0zR88"
            }
        }
    }