Seamless
单一钱包 API
功能项目
Action 19: 打赏

Action 19: 打赏

功能说明

  • 当玩家打赏时呼叫该 API,通知客户执行打赏操作。
  • 请使用 amount 确认玩家余额是否足够,并在使用 amount 扣款后,回传玩家剩余金额。
    • amount:
      • 当 玩家余额 >= amount 则此笔请求要被处理
      • 当 玩家余额 < amount 请返回错误代码 6006
  • 为符合幂等性设计,若收到请求且该笔 transferId 曾经完成打赏,请勿重复处理,应返回状态码 0000。

请求参数

参数格式说明
actionInteger19
tsLong当前系统时间
transferIdLong交易序号,无法关联至游戏纪录
uidString(50)玩家帐号
amountDouble打赏金额(永远为正数)
currencyString币别
gTypeInteger游戏类型
参照附录 游戏提供商
mTypeInteger机台类型

请求范例

{
  "action": 19,
  "ts": 1752121463107,
  "transferId": 411177,
  "uid": "john",
  "amount": 15.0,
  "currency": "RB",
  "gType": 7,
  "mType": 210001
}

返回参数

参数格式说明
statusString(4)成功:0000
若收到请求且该笔 transferId 曾经完成打赏,请回传 0000

其余错误代码视同取得余额失败,可以把错误原因补充在 err_text
balanceDouble余额
err_textString(255)错误讯息

返回范例

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