派彩通知接口格式

1、派彩通知接口格式

接口路径

• POST
• /aigame/v1/wallet/payout

请求参数

参数	名称	类型	必填	说明
agent_id	商户 ID	string	必填	商户 ID
user_id	商户侧用户 ID	string	必填	商户侧用户ID, 字符串长度最小3，最大64, 只支持英文、数字以及_
game_id	游戏 ID	string	必填	游戏 ID，101: 百家乐
inst_id	台桌 ID	string	必填	台桌 ID
shoe_id	牌靴 ID	int64	必填	牌靴 ID
round_id	牌局 ID	int64	必填	牌局 ID
bet_txn_id	下注订单 ID	string	必填	下注订单 ID
win_amount	派彩金额	string	必填	派彩金额
pay_out_time	派彩时间	int64	必填	派彩时间（单位毫秒）
currency	币种	string	必填	币种
timestamp	当前时间戳	int64	必填	传调用接口时的时间戳（单位毫秒，有效期十分钟）
sign	签名	string	必填	签名算法详见接口说明

响应参数

参数	名称	类型	说明
code	响应码	int	错误码
message	响应信息	string	错误信息
data	响应数据	dict	响应数据详情
--balance	玩家余额	string	玩家余额
--currency	币种	string	币种

请求范例

curl --location 'https://商户侧地址/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"
}'

响应范例

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

错误码

200 成功
800100 服务异常
408000 参数错误
600100 签名错误
600101 参数不合法
800101 会员不存在
800102 币种不存在
800107 订单ID不存在
800109 派彩失败

常见问题

1、注单重算/二次结算机制

一些异常情况下（例如，商户侧收到结算通知并进行结算处理，但游戏方没有收到商户返回，判定结算失败），游戏方会重复发送结算通知， 如果商户侧已经对该订单进行过结算处理，直接返回结算成功即可

2、注单多久内重算？

如果结算失败，注单会每个一分钟重试一次

3、若即商户侧无响应，游戏方的重试机制

注单结算时，如果商户侧无响应导致结算失败，后续会每隔一分钟尝试进行结算直到结算成功

4、未完成注单的自动结算机制

如果注单在本轮游戏结算失败或未处理结算，会自动在两分钟后进行重新结算