跳到主要内容

Balance - 查询余额

查询会员当前可用余额。

请求参数

解密前 Request

{
  "cipherText": "asdqwcqwqe"
}

信息

加密说明请参考营运商 API 实作说明

解密后 Request

{
  action: 'balance',
  uid: 'gameTest1',
  currency: 'PHP',
  brand: 'VP'
}

参数	类型	必填	说明
action	string	是	固定为 "balance"
uid	string	是	会员账号
currency	string	是	币别代码
brand	string	是	品牌代码

回应格式

信息

回应为明文 JSON，不需加密。

成功回应

{
  status: '0000',
  errText: '',
  balance: 12345.67,
  responseTime: '2024-12-11T01:23:38.271Z'
}

欄位	类型	说明
status	string	状态码，見下方状态码说明
errText	string	错误讯息，成功时为空字串
balance	number	当前可用余额
responseTime	string	回应时间

响应状态与交易结果

状态	查询状态	是否觸发重试
0000	成功	不会
9999	失敗	会
超时	失敗	会

注意事项

Token 验证: 每次查询都会验证 Token 的有效性
即时余额: 返回的余额为即时可用余额
币别一致性: 确保与游戏商设定的币别一致
快取策略: 建议在客户端适度快取余额,减少查询頻率
并发控制: 高并发情况下可能需要等待鎖定釋放
查询頻率: 玩家进入游戏后 10 秒传送 1 次，直到玩家离开游戏

请求参数
- 解密前 Request
- 解密后 Request
回应格式
- 成功回应
- 响应状态与交易结果
注意事项