附錄
本頁面列出了單一錢包 API 中所有可能出現的錯誤碼及其說明。
狀態碼總覽
| 狀態碼 | 回應訊息 | 說明 | 相關 API |
|---|---|---|---|
| 0 | No error | 請求成功 | 所有 API |
| 5 | Game is not found | 遊戲不存在或已下線 | 開啟遊戲、查詢投注記錄、查詢投注詳情、查詢投注回放 |
| 6 | The username already exist | 用戶名已存在 | 創建會員 |
| 7 | Internal server error | 系統內部錯誤 | 所有 API |
| 8 | The User is not exist | 會員不存在 | 開啟遊戲、查詢投注詳情 |
| 10 | Agent code was not found or block | 代理商不存在或被封鎖 | 獲取 Access Token |
| 11 | Parameters error | 參數錯誤 | 所有 API |
| 14 | The BetId is not exist | 查詢投注記錄不存在 | 查詢投注詳情、查詢投注回放 |
| 19 | Invalid account | 帳號無效 | 開啟遊戲 |
| 77 | Too many request, please try again later | 請求過於頻繁 | 查詢投注記錄、查詢每日報表、查詢會員報表 |
| 81 | Branch config not found | 分支配置未找到 | 開啟遊戲、查詢投注記錄 |
| 82 | Please check siteId is for this player | siteId 與玩家不匹配 | 開啟遊戲 |
| 83 | Signature verification failed | 簽章驗證失敗 | 所有需要驗證的 API |
| 84 | Encryption failed | 加密失敗 | 所有需要加密的 API |
錯誤碼分類
成功碼
| 狀態碼 | 說明 |
|---|---|
| 0 | 請求成功，無錯誤 |
會員管理錯誤
| 狀態碼 | 說明 | 可能原因 | 處理建議 |
|---|---|---|---|
| 6 | 用戶名已存在 | 使用已註冊的用戶名創建會員 | 使用其他用戶名 |
| 8 | 會員不存在 | 查詢或操作不存在的會員 | 確認會員ID或用戶名正確，先調用創建會員 API |
| 19 | 帳號無效 | 帳號格式錯誤或狀態異常 | 檢查帳號格式和狀態 |
| 20 | 會員錢包暫時鎖定 | 會員錢包因某些原因被臨時鎖定 | 稍後重試或聯繫技術支援 |
遊戲管理錯誤
| 狀態碼 | 說明 | 可能原因 | 處理建議 |
|---|---|---|---|
| 5 | 遊戲不存在 | 使用無效的遊戲代碼或遊戲已下線 | 確認遊戲代碼正確，檢查遊戲是否支援當前幣別 |
| 82 | siteId 不匹配 | siteId 與玩家不對應 | 聯繫技術支援，提供 logUUID |
查詢投注記錄錯誤
| 狀態碼 | 說明 | 可能原因 | 處理建議 |
|---|---|---|---|
| 14 | 查詢投注記錄不存在 | 查詢不存在的查詢投注記錄或 txTime 不正確 | 確認 betId 和 txTime 參數正確 |
系統級錯誤
| 狀態碼 | 說明 | 可能原因 | 處理建議 |
|---|---|---|---|
| 7 | 系統內部錯誤 | 服務器內部錯誤 | 聯繫技術支援，提供 logUUID |
| 10 | 代理商錯誤 | agentId 或 secret 不正確，或代理商被封鎖 | 檢查認證資訊，聯繫管理員確認狀態 |
| 11 | 參數錯誤 | 請求參數缺失、格式錯誤或不符合要求 | 檢查所有必填參數和格式 |
| 77 | 請求過於頻繁 | 短時間內發送過多請求 | 降低請求頻率，稍後重試 |
| 81 | 分支配置未找到 | 系統配置缺失 | 聯繫技術支援 |
| 83 | 簽章驗證失敗 | 簽章計算錯誤或請求頭不正確 | 檢查簽章生成邏輯和請求頭 |
| 84 | 加密失敗 | 加密密鑰錯誤或加密方法不正確 | 檢查加密配置和實作 |
認證相關錯誤詳解
10 - 代理商錯誤
發生在 /v2/auth API，可能原因：
- agentId 不存在：使用了未註冊的代理商ID
- secret 不正確：secret 參數解密後與 agentId 不匹配
- 代理商被封鎖：代理商帳號被系統管理員停用
處理建議：
- 確認 agentId 和 secret 正確
- 聯繫管理員檢查代理商狀態
- 檢查 x-agentid 請求頭與 body 中的 agentId 是否一致
83 - 簽章驗證失敗
這是最常見的認證錯誤，可能由以下原因引起：
-
簽章字符串組合順序錯誤
- 正確順序應為：agentId + secret + timestamp + nonce + cipherText
- 使用 SHA256（非 HMAC-SHA256）進行雜湊
-
時間戳驗證失敗
- 平台端與服務器時間差異超過允許範圍（通常為 ±1 分鐘）
- 時間戳格式錯誤（應為13位毫秒時間戳）
-
Nonce 驗證失敗
- 使用了重複的 nonce 值（每次請求必須唯一）
-
請求頭缺失或錯誤
- 缺少必需的請求頭：x-agentid, x-timestamp, x-nonce, x-signature
- 請求頭值與實際簽章計算使用的值不一致
處理建議：
- 參考 獲取 Access Token概述 檢查簽章生成邏輯
- 確保服務器時間同步（使用 NTP）
- 每次請求生成新的 nonce
- 確認所有請求頭都正確設置
84 - 加密失敗
加密/解密相關錯誤：
- 加密方法錯誤：必須使用 AES-256-GCM
- 密鑰錯誤：加密密鑰配置不正確
- 數據格式錯誤：加密前的數據格式不正確
處理建議：
- 檢查加密實作是否使用 AES-256-GCM
- 確認加密密鑰正確
- 參考 獲取 Access Token概述 的加密範例
交易狀態碼
平台端 API 收到平台請求後，回傳格式中 status 欄位所代表的交易結果。
| 狀態 | 說明 |
|---|---|
| 0000 | 成功 |
| 9999 | 失敗 |
| 1006 | 無效session |
| 2000 | 找不到交易id |
| 2001 | 交易id已存在 |
| 2002 | 當前餘額不足 |
| 2003 | 不取消，注單狀態: 成立(取消下注專用) |
遊戲類型對應表
| 代碼 | 說明 |
|---|---|
| 1 | 老虎機 |
語系
| 代碼 | 說明 |
|---|---|
| en | 英語（預設語言，若遊戲提供商不支援對應語系則預設語言） |
| zh-Hans | 簡體中文 |
| th | 泰文 |
| my | 緬甸文 |
| id | 印尼文 |
| vi | 越南文 |
| jp | 日文 |
| pt | 葡萄牙文 |
| ko | 韓文 |
| tl | 他加祿語 |
| hi | 印地語 |
| ms | 馬來文 |
| bn | 孟加拉 |
| es | 西班牙 |
幣別
| 代碼 | 說明 |
|---|---|
| AUD | 澳幣 |
| BDT | 孟加拉塔卡 |
| BRL | 巴西黑奧 |
| CAD | 加拿大元 |
| CNY | 人民幣 |
| EGP | 埃及磅 |
| EUR | 歐元 |
| GBP | 英鎊 |
| HKD | 港幣 |
| IDR | 印尼盾(1:1000) |
| IDR1 | 印尼盾(1:1) |
| INR | 印度盧比 |
| JPY | 日圓 |
| KHR | 柬埔寨瑞爾 |
| KRW | 韓圓(1:1) |
| KRW1 | 韓圓(1:1000) |
| LAK | 寮幣(1:1000) |
| LAK1 | 寮幣(1:1) |
| LKR | 斯里蘭卡盧比 |
| MMK | 緬甸元(1:1000) |
| MMK1 | 緬甸元(1:1) |
| MYR | 馬來西亞令吉 |
| MYR1 | 馬來西亞令吉(遊戲內顯示 100:1) |
| NPR | 尼泊爾盧比 |
| PHP | 菲律賓披索 |
| THB | 泰銖 |
| USD | 美元 |
| USDT | 泰達幣 |
| VND | 越南盾(1:1000) |
| VND1 | 越南盾(1:1) |
| ZAR | 南非鍞 |
交易來源代碼
| 代碼 | 說明 |
|---|---|
| 1 | 一般下注 |
| 2 | 任務系統 |
| 3 | 抽紅包 |
| 4 | 系統獎勵 |
| 5 | 開寶箱 |
| 6 | 現金券 |
| 7 | 多重賞 |
| 8 | 卡片 |
| 9 | 平台卡 |