Seamless
單一錢包 API
功能项目
Action 10:结算

Action 10:结算

功能说明

  • 当游戏結算时呼叫该 API,通知该局游戏结果。
  • 使用 amount 派彩后,回传玩家最新余额。
  • 若收到请求且此笔请求已处理成功过,请回传 0000
  • 当呼叫该 API 失败时,JDB 将每分钟重送一次,直到回应 status 0000 或已重送达 1 个小时。
seamless wallet settle flow chart

请求参数

参数格式说明
actionInteger10
tsLong当前系统时间
transferIdLong交易序号,能关联到游戏记录
uidString(50)玩家账号
currencyString(10)参照附录:货币代码
amountDouble要返还给玩家的金额(永远为正数)
refTransferIdsArray of Long此次结算了哪些注单;对应至 Action 9 的 transferId
gameRoundSeqNoString(100)游戏局号
historyIdString(100)游戏序号
参照附录 historyId 说明
gTypeInteger游戏类型,参照附录:游戏提供商
mTypeInteger机台类型
reportDateString(10)报表日期(dd-MM-yyyy)
gameDateString(19)游戏日期(dd-MM-yyyy HH:mm:ss)
lastModifyTimeString(19)最后修改时间(dd-MM-yyyy HH:mm:ss)
betDouble押注金额
validBetDouble有效投注金额
winDouble游戏赢分
netWinDouble总输赢
taxDouble
commissionDouble回馈金
sessionNoString(50)序号,登入每款游戏会获得不同值。当没使用 JDB 大厅时推荐使用。
预设无此参数,如需要请洽业务人员
systemSessionIdString(150)系统阶段唯一码,每次 action 21 取得游戏连结会获得不同值。

游戏类型支援范围:街机 (9)、棋牌 (18)

预设无此参数,如需要请洽业务人员
roundClosedBoolean当局是否结束。
true:当局已结束
false:当局未结束,后续仍有action10。

接续上面表格,以下将依 gType 分类,列出对应的参数表格

请求范例

{
  "action": 10,
  "ts": 1700029145035,
  "transferId": 272017,
  "uid": "john",
  "currency": "XX",
  "amount": 0.1,
  "refTransferIds": [272016],
  "gameRoundSeqNo": "5250228497993",
  "historyId": "1944036707",
  "reportDate": "15-11-2023",
  "gameDate": "15-11-2023 14:18:57",
  "lastModifyTime": "15-11-2023 14:19:04",
  "win": 0.1,
  "bet": 0.2,
  "validBet": 0.2,
  "netWin": -0.1,
  "tax": 0,
  "commission": 0,
  "gType": 58,
  "mType": 58016,
  "roundClosed": true
}

返回参数

参数格式说明
statusString(4)成功:0000
其余错误代码视同交易失败,将再次重送
balanceString余额
err_textString(255)错误讯息

返回范例

{
  "status": "0000",
  "balance": "12345.67",
  "err_text": ""
}