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 的有效性
- 即时余额: 返回的余额为即时可用余额
- 币别一致性: 确保与VP设定的币别一致
- 快取策略: 建议在平台端适度快取余额，减少查询頻率
- 并发控制: 高并发情况下可能需要等待鎖定釋放
- 查询頻率: 玩家进入游戏后 10 秒传送 1 次，直到玩家离开游戏