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 | Merchant User ID |
game_id | Game ID | string | Required | Game ID, 101: Baccarat |
inst_id | Table ID | string | Required | Table ID |
shoe_id | Shoe ID | int | Required | Shoe ID |
round_id | Round ID | int | 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 | int | Required | Payout Time (in milliseconds) |
currency | Currency | string | Required | Currency |
timestamp | Current Timestamp | int | 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
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.