Balance - 查询余额

查询玩家当前可用余额。

请求参数

解密前 Request

{
  "cipherText": "asdqwcqwqe"
}

信息

加密说明请参考 平台端 API 实作说明

解密后 Request

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

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

回应格式

信息

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

成功回应

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

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

响应状态与交易结果

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

注意事项

1. Token 验证: 每次查询都会验证 Token 的有效性
2. 即时余额: 返回的余额为即时可用余额
3. 币别一致性: 确保与VP设定的币别一致
4. 快取策略: 建议在平台端适度快取余额，减少查询频率
5. 并发控制: 高并发情况下可能需要等待锁定释放
6. 重试策略: 查询逾时或失败时会持续重试，机制与 BetNSettle 相同
   • 重试频率: 重试 5 次，每次重试之间都会使用退避指数值政策重试，(1s, 3s, 5s, 7s, 9s)