Action 6:取得余额
功能说明
- 回传玩家剩余金额。
- 玩家登入游戏后,游戏大厅每三秒会呼叫一次,进入游戏每五秒会呼叫一次,直到玩家离开游戏。
- 我方有机会于玩家离线时呼叫此 API 取得馀额,并用于部分交易失败重试场景。
请求参数
参数 | 格式 | 说明 |
---|---|---|
action | Integer | 6 |
ts | Long | 当前系统时间 |
uid | String(50) | 玩家账号,只限 a-z 与 0-9、底线(_)、连字符(-)。 |
currency | String(10) | 参照附录:货币代码 |
gType | Integer | 游戏类型 参照附录:游戏提供商 若请求目的为操作钱包,则该值将回传游戏类型代码 (操作钱包泛指下注、结算、取消及对应之重试的行为) 若为其他目的则回传「999」 (例如:游戏大厅余额...等) |
mType | Integer | 机台类型 若请求目的为操作钱包,则该值将回传机台类型代码 (操作钱包泛指下注、结算、取消及对应之重试的行为) 若为其他目的则回传「999」 (例如:游戏大厅余额...等) |
systemSessionId | String(150) | 系统阶段唯一码,每次 action 21 取得游戏连结会获得不同值。 游戏类型支援范围:老虎机(0)、捕鱼机(7)、街机(9)、电子彩票(12)、棋牌(18) 若玩家已离线,则回传「PLAYER_IS_OFFLINE_SYSTEM_SESSION_ID」 预设无此参数,如需要请洽业务人员 |
请求范例
{
"action": 6,
"ts": 1447452951820,
"uid": "testpl01",
"currency": "RB",
"gType": 0,
"mType": 8001
}
返回参数
参数 | 格式 | 说明 |
---|---|---|
status | String(4) | 成功:0000其余错误代码视同取得余额失败,可以把错误原因补充在 err_text |
balance | Double | 余额当玩家余额为 0 时,请回传 status 0000 且 balance 0 |
err_text | String(255) | 错误讯息 |
返回范例
{
"status": "0000",
"balance": 12345.67,
"err_text": ""
}