跳到主要内容

派彩通知接口格式

1、派彩通知接口格式​

接口路径​

  • POST
  • /aigame/v1/wallet/payout

请求参数​

参数名称类型必填说明
agent_id商户 IDstring必填商户 ID
user_id商户侧用户 IDstring必填商户侧用户 ID
game_id游戏 IDstring必填游戏 ID，101: 百家乐
inst_id台桌 IDstring必填台桌 ID
shoe_id牌靴 IDint必填牌靴 ID
round_id牌局 IDint必填牌局 ID
bet_txn_id下注订单 IDstring必填下注订单 ID
win_amount派彩金额string必填派彩金额
pay_out_time派彩时间int必填派彩时间（单位毫秒）
currency币种string必填币种
timestamp当前时间戳int必填传调用接口时的时间戳（单位毫秒，有效期十分钟）
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 签名错误
800101 会员不存在
800102 币种不存在
800107 订单ID不存在
800109 派彩失败

常见问题​

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

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

2、注单多久内重算？​

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

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

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

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

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