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

# 一般 API 錯誤代碼

這些錯誤代碼在我們的 API 中是一致的。

| 錯誤                             | 代碼        | 錯誤訊息                                  |
| ------------------------------ | --------- | ------------------------------------- |
| INVALID\_ACCOUNT               | AUTH-0001 | 您的帳戶沒有登入此入口所需的正確權限。請申請企業帳戶。           |
| INVALID\_CREDENTIALS           | AUTH-0002 | 驗證詳細資訊不正確。                            |
| PHONE\_NUMBER\_NOT\_FOUND      | AUTH-0003 | 找不到提供的電話號碼，或該電話號碼尚未驗證。請選擇其他方法或聯絡客服支援。 |
| INVALID\_PHONE\_NUMBER         | AUTH-0004 | 無效的電話號碼。                              |
| INVALID\_2FA\_TOKEN            | AUTH-0005 | 存取被拒或已過期。                             |
| INCORRECT\_AUTH\_CODE          | AUTH-0006 | 提供的驗證碼不正確，請檢查後重新輸入收到的代碼並再試一次。         |
| UNABLE\_TO\_SEND\_AUTH\_CODE   | AUTH-0007 | 抱歉，我們無法傳送驗證碼，請再試一次或聯絡客服支援。            |
| INVALID\_USER\_ACCESS          | AUTH-0008 | 無效的使用者存取。                             |
| INVALID\_PASSWORD              | AUTH-0009 | 提供的密碼無效。                              |
| NO\_PIN\_EXISTS                | AUTH-0010 | 此使用者尚未設定通行碼，請改為建立一個。                  |
| PIN\_ALREADY\_SET              | AUTH-0011 | 此使用者已設定通行碼，請改為重設。                     |
| INVALID\_PIN\_CODE             | AUTH-0012 | 提供的通行碼與我們的記錄不符，請再試一次或重設您的通行碼。         |
| SOCIAL\_UNABLE\_TO\_LOGIN      | AUTH-0013 | 無法使用您的社群帳戶登入。請確認您的憑證後再試一次，或聯絡客服支援。    |
| UNABLE\_TO\_CREATE\_PIN        | AUTH-0014 | 無法建立新的通行碼，請再試一次或聯絡客服支援。               |
| UNABLE\_TO\_CHECK\_PIN         | AUTH-0015 | 無法檢查通行碼，請再試一次或聯絡客服支援。                 |
| UNABLE\_TO\_UPDATE\_PIN        | AUTH-0016 | 無法更新通行碼，請再試一次或聯絡客服支援。                 |
| UNABLE\_TO\_RESET\_PIN         | AUTH-0017 | 無法重設通行碼，請再試一次或聯絡客服支援。                 |
| TRADITIONAL\_UNABLE\_TO\_LOGIN | AUTH-0018 | 無法使用您的帳戶登入。請確認您的憑證後再試一次，或聯絡客服支援。      |
| INVALID\_JWT                   | AUTH-0019 | 無效的 JWT 權杖！                           |
| UNABLE\_TO\_RESEND\_2FA        | AUTH-0020 | 無法重新傳送 2FA！                           |
| UNSUPPORTED\_PHONE\_NUMBER     | AUTH-0021 | 提供的號碼不是有效的行動電話號碼！如需更多資訊，請聯絡支援。        |
| REGISTRATION\_NOT\_ALLOWED     | AUTH-0022 | 不允許註冊，請聯絡客服支援！                        |
| UNABLE\_TO\_CHANGE\_PASSWORD   | AUTH-0023 | 無法變更密碼。請再試一次或聯絡客服支援。                  |
| UNVERIFIED\_PHONE\_NUMBER      | AUTH-0024 | 您的電話號碼需要驗證。請聯絡支援。                     |
| UNSUCCESSFUL\_REGISTRATION     | AUTH-0025 | 請再試一次或聯絡支援。                           |
| REGISTRATION\_PHONE\_TAKEN     | AUTH-0026 | 您選擇的電話號碼已被使用。                         |
| REGISTRATION\_EMAIL\_TAKEN     | AUTH-0027 | 您選擇的電子郵件地址已被使用。                       |
| UNABLE\_TO\_RESET\_PASSWORD    | AUTH-0028 | 無法重設密碼。                               |
| SECURITY\_CODE\_EXPIRED        | AUTH-0029 | 您的 6 位數安全代碼已過期。請重新傳送新代碼。              |
| APPLICATION\_INACTIVE          | AUTH-0030 | 您的應用程式未啟用。                            |
| INVALID\_SCOPE                 | AUTH-0031 | 需要先由使用者授與所要求的範圍。                      |

## 地址錯誤

地址欄位會在多個流程中進行驗證。限制會依情境而異（例如，虛擬卡與銀行帳戶的地址僅限美國，而企業法定地址則可能為國際地址）。如需格式規則與示例，請參閱[地址格式需求](/concepts/address-formatting-requirements)。

| 錯誤                          | 代碼      | 適用範圍        | 錯誤訊息                                          |
| --------------------------- | ------- | ----------- | --------------------------------------------- |
| INVALID\_BILLING\_ADDRESS   | VC-0025 | 發行虛擬卡（帳單地址） | 無法驗證帳單地址。必須是可投遞的美國地址（不可為郵政信箱），且城市、州別與郵遞區號需相符。 |
| InvalidBusinessLegalAddress | BS-0002 | 企業註冊（KYB）   | 企業法定地址不正確。                                    |
| InvalidOwnerInformation     | BS-0003 | 企業註冊（KYB）   | 一個或多個負責人詳細資料不正確（包含負責人的美國地址）。                  |

<Note>
  **遺漏或格式錯誤的地址欄位**

  在地址物件中遺漏必要欄位或包含無效值，會以一般參數錯誤回傳——在虛擬卡呼叫上為 `ARG-0001`，在企業註冊上為 `AR-0001` / `AR-0002`——而不是上述其中一個地址代碼。
</Note>

## 後續步驟

<CardGroup cols={2}>
  <Card title="錯誤參考" icon="triangle-alert" href="/api-reference/errors">
    錯誤封包結構、網域前綴，以及如何使用請求 ID 進行疑難排解。
  </Card>

  <Card title="地址格式" icon="map-pin" href="/concepts/address-formatting-requirements">
    用於避免上述地址錯誤的格式規則與示例。
  </Card>
</CardGroup>

**想了解更多嗎？** 歡迎聯絡我們：[partnerships@fluz.app](mailto:partnerships@fluz.app)。與我們的專家聯繫以取得更多資訊或申請示範。