Payout Notification Interface Format

1. Payout Notification Interface Format

Interface Path

• POST
• /aigame/v1/wallet/payout

Request Parameters

Parameter	Name	Type	Required	Description
agent_id	Merchant ID	string	Required	Merchant ID
user_id	Merchant User ID	string	Required	User ID on Merchant Side, string length minimum 3, maximum 64, Only English, numbers, and _
game_id	Game ID	string	Required	Game ID, 101: Baccarat
inst_id	Table ID	string	Required	Table ID
shoe_id	Shoe ID	int64	Required	Shoe ID
round_id	Round ID	int64	Required	Round ID
bet_txn_id	Bet Order ID	string	Required	Bet Order ID
win_amount	Payout Amount	string	Required	Payout Amount
pay_out_time	Payout Time	int64	Required	Payout Time (in milliseconds)
currency	Currency	string	Required	Currency
timestamp	Current Timestamp	int64	Required	Timestamp when calling the interface (in milliseconds, valid for ten minutes)
sign	Signature	string	Required	Signature algorithm details in the interface description

Response Parameters

Parameter	Name	Type	Description
code	Response Code	int	Error Code
message	Response Message	string	Error Message
data	Response Data	dict	Response Data Details
--balance	Player Balance	string	Player Balance
--currency	Currency	string	Currency

Request Example

curl --location 'https://merchant_address/aigame/v1/wallet/payout' \
--header 'Content-Type: application/json' \
--data '{
    "agent_id": "agent001",
    "user_id": "testUid03",
    "game_id": "101",
    "inst_id": "000002",
    "shoe_id": 10231,
    "round_id": 41,
    "bet_txn_id": "67453d0c23c36d2571d40817",
    "win_amount": "100",
    "pay_out_time": 1732589121000,
    "currency": "VND2",
    "timestamp": 1732589849000,
    "sign": "ac596804f9b76ec6be8f38ad71e4fdb0"
}'

Response Example

{
    "code": 200,
    "message": "success",
    "data": {
        "balance": "1282.66",
		"currency": "VND2"
    }
}

Error Codes

200 Success
800100: Service exception
408000: Parameter error
600100: Signature error
600101 Invalid parameters
800101: Member does not exist
800102: Currency does not exist
800107: Order ID does not exist
800109: Payout failure

Frequently Asked Questions

1. Order Recalculation/Secondary Settlement Mechanism

In some exceptional cases (e.g., the merchant receives a settlement notification and processes it, but the gaming platform does not receive the merchant's response, resulting in a settlement failure), the gaming platform will resend the settlement notification. If the merchant has already processed the settlement for the order, it can directly return a settlement success response.

2. How Long Before an Order is Recalculated?

If a settlement fails, the order will be retried every minute.

3. Retry Mechanism if the Merchant Side Does Not Respond

If the merchant side does not respond during order settlement, leading to a settlement failure, the system will attempt to resettle every minute until the settlement is successful.

4. Automatic Settlement Mechanism for Uncompleted Orders

If an order fails to settle or is not processed during the current game settlement, it will automatically be resettled two minutes later.