> ## Documentation Index
> Fetch the complete documentation index at: https://doc.va777.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 回應訊息碼

> status.code 的所有可能值、代表意義與處理建議。

HTTP 狀態碼固定為 `200`，請以回應中的 `status.code` 判斷結果。需要聯絡我方時，請一併提供回應中的 `status.traceCode`，方便追查。

## 共通訊息碼

所有 API 都可能回傳以下代碼：

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `0` | 成功 | — |
| `101` | 請求設定錯誤，例如網址路徑不存在、HTTP 方法錯誤、`Content-Type` 不是 `multipart/form-data`，或 `Authorization` 無效 | 確認請求網址、方法與 Header，請參考[請求與回應格式](https://doc.va777.net/zh-Hant/v1/guides/request-format.md)。 |
| `102` | 簽章錯誤 | 依[簽章規則](https://doc.va777.net/zh-Hant/v1/guides/signature.md)的「簽章錯誤排查」逐項檢查。 |
| `104` | 系統維護中 | 維護結束後再重新呼叫。 |
| `105` | 來源 IP 不在白名單內 | 將呼叫 API 的伺服器 IP 提供給我方加入白名單。 |
| `201` | 參數錯誤，例如缺少必填參數或格式不符 | 依 `status.message` 的說明修正參數。 |
| `999` | 系統異常 | 請提供 `status.traceCode` 聯絡我方。 |

## API 專屬訊息碼

以下代碼只有部分 API 會回傳，各 API 頁面的「回應訊息碼」會列出該 API 可能回傳的代碼。

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `103` | 我方處理失敗 | 稍後重試；持續發生時，請提供 `status.traceCode` 聯絡我方。 |
| `106` | 處理逾時 | 請提供 `status.traceCode` 聯絡我方確認處理結果。 |
| `202` | 帳號已存在（同一渠道下已有相同帳號） | 改用其他帳號，或直接使用既有帳號。 |
| `203` | 交易代碼重複 | 每筆交易請使用唯一的 `transactionId`。 |
| `204` | 餘額不足 | 確認會員錢包餘額後再操作。 |
| `205` | 帳號不存在 | 先[創建會員](https://doc.va777.net/zh-Hant/v1/api-reference/member/create.md)，並確認 `channelId`、`account` 是否正確（帳號區分大小寫）。 |
| `206` | 遊戲不存在 | 以[取得遊戲列表](https://doc.va777.net/zh-Hant/v1/api-reference/info/game-list.md)確認遊戲編號。 |
| `207` | 錢包處理異常 | 依 `status.message` 確認原因；持續發生時，請提供 `status.traceCode` 聯絡我方。 |
| `429` | 呼叫過於頻繁（僅有呼叫次數限制的 API 會回傳） | 降低呼叫頻率後重試，限制請見各 API 說明。 |
| `800` | 風控異常，會員帳號可能已被鎖定 | 請提供 `status.traceCode` 聯絡我方客服。 |

## 單錢包訊息碼

採用[單錢包](https://doc.va777.net/zh-Hant/v1/guides/seamless-wallet.md)時，貴司 API 可回傳以下代碼：

| 代碼 | 說明 | 處理建議 |
| - | - | - |
| `601` | 注單已存在 | — |
| `602` | 查無注單 | 確認注單編號與查詢條件。 |
| `603` | 注單已結算 | — |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.