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 次，直到玩家離開遊戲