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

# 错误码

> 查找 Account Center API 返回的错误，并根据 endpoint 和推荐处理完成排查。

当 Account Center API 返回错误时，先搜索响应中的 `type`、`code` 或 `message`，再按实际调用的 endpoint 缩小结果。表格会直接给出最优先的推荐处理；只有需要更多背景时才展开详情。

## 如何使用本页

**1. 保存错误信息**

保存调用接口、HTTP status、完整响应体和请求时间。日志或支持请求中不要包含 API key、access token、PAN 或其他敏感卡片数据。

**2. 搜索错误响应**

在“搜索响应”输入框中粘贴完整 `type`、`code` 或 `message`。如果结果不唯一，再在“筛选 endpoint”中输入 operation 名称、operationId、HTTP method 或 path。

**3. 执行推荐处理**

核对 Endpoint 列，然后执行“推荐处理”中的首要动作。需要更多背景时，展开“查看详情”。

## 错误响应格式

本产品的错误响应不一定包含 `type`；请组合 HTTP status、`code`、`message` 和 endpoint 定位。 同一个 `code` 可能对应多个 message 或触发条件；查表时不要只依赖单一字段。

## 错误码总表

表中的 `type`、`code` 和 `message` 保留 API 返回的原文。Endpoint 同时提供 operation 名称、operationId、HTTP method 和 path。对于动态 message，表中展示可确认的稳定 pattern 或说明。

> [!NOTE]
>
> 联系 UQPAY 前，请准备 HTTP method 和 path、`x-response-id`、请求时间及完整错误响应，并移除 API key、access token、PAN 等敏感信息。每条错误的详情只列出额外需要提供的信息。

搜索响应
筛选 endpoint

显示全部错误清除未找到匹配项。请检查拼写，或减少搜索词后重试。

| HTTP / Type | Code / Message | Endpoint | 推荐处理 |
| - | - | - | - |
| **403** Legacy flat | `403` `Authorization error` | 适用于 10 个公开接口 | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **401** Other envelope | `""` `Invalid authorization header` | 适用于 10 个公开接口 | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **400** Legacy flat | `400` `IP not allowed` | 适用于 10 个公开接口 | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **403** Legacy flat | `403` `x-client-id or email cannot be empty` | 适用于 10 个公开接口 | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **403** Legacy flat | `1022` `account not found` | 适用于 10 个公开接口 | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **403** Legacy flat | `1022` **Message pattern** `account is not active (account_status={status})` | 适用于 10 个公开接口 | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **403** Legacy flat | `1022` **Message pattern** `API access is not active (api_status={status})` | 适用于 10 个公开接口 | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1036` `Idempotency key error` | 适用于 4 个公开接口 | **避免重复提交** 先查询原请求或资源状态，不要立即创建重复请求。 <details><summary>查看详情</summary>**出现原因：**相同请求或资源已经存在，或幂等键与原请求不一致。 **重试：**仅在确认原请求未生效且接口允许时重试。</details> |
| **400** Legacy flat | `1038` `Idempotency endpoint error` | 适用于 4 个公开接口 | **避免重复提交** 先查询原请求或资源状态，不要立即创建重复请求。 <details><summary>查看详情</summary>**出现原因：**相同请求或资源已经存在，或幂等键与原请求不一致。 **重试：**仅在确认原请求未生效且接口允许时重试。</details> |
| **400** Legacy flat | `200` `Request is processing, please try again later.` | 适用于 4 个公开接口 | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1018` `An internal error occurred, please try again later` | 适用于 4 个公开接口 | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **404** Legacy flat | `1007` `sub-account associated with the on-behalf-of not found or deactivated` | 适用于 5 个公开接口 | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **401** Legacy flat | `1027` `Invalid client id` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **401** Legacy flat | `1028` `Invalid api key` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **401** Legacy flat | `1029` `Api key expired` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **401** Legacy flat | `1031` `IP not allowed` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **500** Legacy flat | `1046` `Entity status not active` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **400** Legacy flat | `1045` `Api trading status error` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **更新认证** 重新获取有效凭证，并检查认证 header 后重试。 <details><summary>查看详情</summary>**出现原因：**认证信息缺失、已过期或无法通过校验。 **重试：**更新凭证或认证 header 后重试。</details> |
| **500** Legacy flat | `1030` `Create access token error` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1018` `An internal error occurred, please try again later` | [Access Token](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/access-token.md) `POST /v1/connect/token` operationId: `access-token` | **稍后重试** 保留完整错误响应和 x-response-id，稍后按重试建议再次调用。 <details><summary>查看详情</summary>**出现原因：**UQPAY 在处理请求时遇到内部依赖或数据访问错误。 **重试：**使用退避策略重试；持续失败时停止重试并联系 UQPAY。 **何时联系 UQPAY：**退避重试后仍持续返回相同错误。</details> |
| **400** Legacy flat | `1006` **动态 message** Request body parsing or validation error returned by the request binder. | [Create Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-account.md) `POST /v1/accounts` operationId: `create-account` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **动态 message** Request body parsing or validation error returned by the request binder. | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `nickname is required` | [Create Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-account.md) `POST /v1/accounts` operationId: `create-account` [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **403** Legacy flat | `1022` `Sub-account creation is temporarily closed. Please wait for our notification.` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `inherit must be 1 or -1 for COMPANY sub-account` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `inherit must be 0 or omitted for INDIVIDUAL sub-account` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **404** Legacy flat | `1032` `Entity not exist` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `sub-accounts cannot create further sub-accounts` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `same-entity sub-account requires a company master` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `cross-entity sub-accounts are not enabled` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `individual sub-accounts are not enabled` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `master account is not approved` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `master account is not active` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `on-behalf operations are not enabled for this master account` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `same-entity sub-accounts are not enabled` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `business sub-accounts are not enabled` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `same-entity sub-account limit reached` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} is required` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} must be one of {allowed_values}` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} {character_requirement}` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} must be E.164 format` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} must be a valid email` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} must be YYYY-MM-DD` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `{section}.{field} must be ISO 3166-1 alpha-2` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` `ownership_details is required` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` `ownership_details.representatives is required` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **400** Legacy flat | `1006` **Message pattern** `ownership_details.representatives[{index}] must be an object` | [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Create Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-account.md) `POST /v1/accounts` operationId: `create-account` [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1034` `Create data error` | [Create Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-account.md) `POST /v1/accounts` operationId: `create-account` [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1003` `This company registration number is already registered. Please check the number, or contact support if you believe this is a mistake.` | [Create Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-account.md) `POST /v1/accounts` operationId: `create-account` [Create SubAccount](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/create-sub-account.md) `POST /v1/accounts/create_accounts` operationId: `create-sub-account` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [List Connected Accounts](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/list-connected-accounts.md) `GET /v1/accounts` operationId: `list-connected-accounts` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **404** Legacy flat | `1032` `Entity not exist` | [Retrieve Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/retrieve-account.md) `GET /v1/accounts/{id}` operationId: `retrieve-account` | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Retrieve Account](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/retrieve-account.md) `GET /v1/accounts/{id}` operationId: `retrieve-account` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1006` `invalid status` | [List RFIs](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/list-rfis.md) `GET /v1/rfis` operationId: `list-rfis` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [List RFIs](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/list-rfis.md) `GET /v1/rfis` operationId: `list-rfis` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **404** Legacy flat | `1007` `rfi not found` | [Retrieve RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/retrieve-rfi.md) `GET /v1/rfis/{id}` operationId: `retrieve-rfi` | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Retrieve RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/retrieve-rfi.md) `GET /v1/rfis/{id}` operationId: `retrieve-rfi` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1006` **动态 message** Request body parsing or validation error returned by the request binder. | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **404** Legacy flat | `1007` `rfi not found` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1006` `rfi is not awaiting response` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `this rfi has no outstanding questions` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `must answer all questions: missing {field_key}` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `answer type mismatch for {field_key}: want {expected_type}, got {received_type}` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `attachments required for {field_key}` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `file not found or not owned: {file_id}` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **核对资源** 核对资源 ID，并确认资源属于当前账户且仍然可用。 <details><summary>查看详情</summary>**出现原因：**指定资源不存在、不属于当前账户或当前不可用。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` **Message pattern** `text required for {field_key}` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **修改请求** 按 API Reference 检查字段格式、必填项和允许值后修正请求。 <details><summary>查看详情</summary>**出现原因：**请求缺少必填信息，或字段格式、取值不符合接口要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `rfi is no longer awaiting response` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1035` `update date error` | [Answer RFI](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/answer-rfi.md) `POST /v1/rfis/answer` operationId: `answer-rfi` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1006` `notes max length 50` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `missing file form field: {binder_error}` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1041` `s3 client not initialized` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1040` `File size error` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1039` **Message pattern** `file type .{extension} not allowed` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **500** Legacy flat | `1041` `open uploaded file: {storage_error}` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1041` `s3 upload: {storage_error}` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1034` `Create data error` | [Upload A File](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/upload-file.md) `POST /v1/files/upload` operationId: `upload-file` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **400** Legacy flat | `1006` **动态 message** Request body parsing or validation error returned by the request binder. | [Get File Download Links](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/download-links.md) `POST /v1/files/download_links` operationId: `download-links` | **检查请求** 根据 message 核对请求参数、资源 ID 和资源当前状态。 <details><summary>查看详情</summary>**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求或资源状态后再重试。</details> |
| **400** Legacy flat | `1006` `file_ids is required` | [Get File Download Links](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/download-links.md) `POST /v1/files/download_links` operationId: `download-links` | **修正请求** 根据 message 指出的字段或条件修正请求后重试。 <details><summary>查看详情</summary>**出现原因：**请求内容未满足该 endpoint 的参数或业务校验。 **重试：**修正请求后重试；不要原样重复提交。</details> |
| **500** Legacy flat | `1043` `s3 client not initialized` | [Get File Download Links](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/download-links.md) `POST /v1/files/download_links` operationId: `download-links` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1043` `Query date error` | [Get File Download Links](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/download-links.md) `POST /v1/files/download_links` operationId: `download-links` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |
| **500** Legacy flat | `1043` `presign: {storage_error}` | [Get File Download Links](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/api-reference/download-links.md) `POST /v1/files/download_links` operationId: `download-links` | **稍后重试** 保留本次错误信息，稍后使用相同业务参数重试一次。 <details><summary>查看详情</summary>**出现原因：**请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 **重试：**短暂等待后重试一次；若持续失败，请联系 UQPAY。 **何时联系 UQPAY：**短暂等待并重试后仍持续返回相同错误。 **请额外提供：**x-response-id、请求时间、HTTP method 和 path、完整错误响应。</details> |

## 相关文档

* [快速开始](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/quickstart.md)
* [创建 API 密钥](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/create-api-keys.md)
* [关联账户](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/connected-accounts.md)
* [幂等请求](https://developers-sandbox.uqpaytech.com/docs/zh/account-center/v1.6/guide/idempotent-requests.md)


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