> ## 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 | 无法重新发送两步验证！                          |
| 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 | 请求的 scope 必须先由用户授权。                  |

## 地址错误

在多个流程中会对地址字段进行校验。约束因上下文而异（例如，虚拟卡和银行账户的地址仅限美国，而企业法定地址可能为国际地址）。有关格式规则和示例，请参见 [地址格式要求](/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) 联系我们。与我们的专家交流以获取更多信息或申请演示。