Action 19: 打赏
功能说明
- 当玩家打赏时呼叫该 API,通知客户执行打赏操作。
- 请使用 amount 确认玩家余额是否足够,并在使用 amount 扣款后,回传玩家剩余金额。
- amount:
- 当 玩家余额 >= amount 则此笔请求要被处理
- 当 玩家余额 < amount 请返回错误代码 6006
- amount:
- 为符合幂等性设计,若收到请求且该笔 transferId 曾经完成打赏,请勿重复处理,应返回状态码 0000。
请求参数
| 参数 | 格式 | 说明 |
|---|---|---|
| action | Integer | 19 |
| ts | Long | 当前系统时间 |
| transferId | Long | 交易序号,无法关联至游戏纪录 |
| uid | String(50) | 玩家帐号 |
| amount | Double | 打赏金额(永远为正数) |
| currency | String | 币别 |
| gType | Integer | 游戏类型 参照附录 游戏提供商 |
| mType | Integer | 机台类型 |
请求范例
{
"action": 19,
"ts": 1752121463107,
"transferId": 411177,
"uid": "john",
"amount": 15.0,
"currency": "RB",
"gType": 7,
"mType": 210001
}返回参数
| 参数 | 格式 | 说明 |
|---|---|---|
| status | String(4) | 成功:0000若收到请求且该笔 transferId 曾经完成打赏,请回传 0000其余错误代码视同取得余额失败,可以把错误原因补充在 err_text |
| balance | Double | 余额 |
| err_text | String(255) | 错误讯息 |
返回范例
{
"status": "0000",
"balance": 12345.67,
"err_text": ""
}