Seamless
單一錢包 API
功能项目
Action 6:取得余额

Action 6:取得余额

功能说明

  • 回传玩家剩余金额。
  • 玩家登入游戏后,游戏大厅每三秒会呼叫一次,进入游戏每五秒会呼叫一次,直到玩家离开游戏。
  • 我方有机会于玩家离线时呼叫此 API 取得馀额,并用于部分交易失败重试场景。

请求参数

参数格式说明
actionInteger6
tsLong当前系统时间
uidString(50)玩家账号,只限 a-z 与 0-9、底线(_)、连字符(-)。
currencyString(10)参照附录:货币代码
gTypeInteger游戏类型
参照附录:游戏提供商

若请求目的为操作钱包,则该值将回传游戏类型代码
(操作钱包泛指下注、结算、取消及对应之重试的行为)

若为其他目的则回传「999」
(例如:游戏大厅余额...等)
mTypeInteger机台类型

若请求目的为操作钱包,则该值将回传机台类型代码
(操作钱包泛指下注、结算、取消及对应之重试的行为)

若为其他目的则回传「999」
(例如:游戏大厅余额...等)
systemSessionIdString(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
}

返回参数

参数格式说明
statusString(4)成功:0000
其余错误代码视同取得余额失败,可以把错误原因补充在 err_text
balanceDouble余额
当玩家余额为 0 时,请回传 status 0000 且 balance 0
err_textString(255)错误讯息

返回范例

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