> ## 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. # 错误码 > 查找 Card Issuance API 返回的错误，并根据 endpoint 和推荐处理完成排查。 当 Card Issuance 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` 的错误响应和不包含 `type` 的兼容格式。 同一个 `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 | 推荐处理 | | - | - | - | - | | **400** `""` | `""` `Bad Request` | 适用于 35 个公开接口 | **修改请求** 按 API Reference 检查请求体格式、字段类型和必填字段。
查看详情**出现原因：**请求体无法按接口定义解析或校验。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Account does not exist.` | 适用于 13 个公开接口 | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** Legacy flat | `400` `Account status error` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `An active or in-progress elevate request already exists for this card` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 不要重复创建或提交；先查询并使用现有资源或当前状态。
查看详情**出现原因：**相同资源、信息或操作已经存在或已经完成。 **重试：**仅在确认原操作未生效且状态允许时重试。
| | **400** Legacy flat | `400` `An internal error occurred, please try again` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **联系 UQPAY** 不要高频重试；记录响应信息后联系 UQPAY 排查。
查看详情**出现原因：**UQPAY 在处理请求时发生服务端错误。 **重试：**仅在业务允许时按指数退避进行有限重试。 **何时联系 UQPAY：**收到此错误，或有限重试后仍未恢复。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **400** Legacy flat | `400` `Card authorize transaction is error` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Card currency is not supported for elevate limit` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** Legacy flat | `400` `Card does not exists` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** Legacy flat | `400` `Card product is error` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Card reversal transaction is error` | [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Card status is invalid` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Card status must be ACTIVE to elevate the per-transaction limit` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Elevate limit amount exceeds the per-currency cap` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Elevate per-transaction limit is not supported for this card` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** Legacy flat | `400` `Invalid activation code.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Invalid channel code` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Invalid no pin payment amount precision.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Invalid type for field …` | [Card Recharge](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/card-recharge.md) `POST /v1/issuing/cards/{id}/recharge` operationId: `card-recharge` [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Invalid type for request field, please see document` | 适用于 8 个公开接口 | **修改请求** 按 API Reference 检查请求体格式、字段类型和必填字段。
查看详情**出现原因：**请求体无法按接口定义解析或校验。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Login expired` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **重新认证** 获取新的 access token 后重试。
查看详情**出现原因：**当前 access token 已过期。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `MCC is error` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Negative no pin payment amount.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 将 no\_pin\_payment\_amount 改为非负整数后重试。
查看详情**出现原因：**no\_pin\_payment\_amount 是负数。 **重试：**修正字段值后重试。
| | **400** Legacy flat | `400` `Remote service error` | 适用于 10 个公开接口 | **联系 UQPAY** 不要高频重试；记录响应信息后联系 UQPAY 排查。
查看详情**出现原因：**UQPAY 在处理请求时发生服务端错误。 **重试：**仅在业务允许时按指数退避进行有限重试。 **何时联系 UQPAY：**收到此错误，或有限重试后仍未恢复。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **400** Legacy flat | `400` `Request parameters invalid` | 适用于 9 个公开接口 | **修改请求** 按 API Reference 检查请求体格式、字段类型和必填字段。
查看详情**出现原因：**请求体无法按接口定义解析或校验。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Restrict config error` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 调整模拟交易或 spending\_controls，使请求符合卡片控制规则。
查看详情**出现原因：**模拟交易违反了卡片的 spending control，例如 MCC、币种、国家/地区或消费限额。 **重试：**请求符合卡片控制规则后重试。 **何时联系 UQPAY：**请求看起来已经符合规则。 **请额外提供：**card ID、非敏感请求字段。
| | **400** Legacy flat | `400` `The card activation is processing.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **等待后重试** 等待当前处理完成或状态更新后再重试。
查看详情**出现原因：**相关请求或资源仍在处理中。 **重试：**等待状态变化后重试；不要高频轮询。
| | **400** Legacy flat | `400` `The card has been activated.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 不要重复创建或提交；先查询并使用现有资源或当前状态。
查看详情**出现原因：**相同资源、信息或操作已经存在或已经完成。 **重试：**仅在确认原操作未生效且状态允许时重试。
| | **400** Legacy flat | `400` `The card has expired` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 改用未过期的资源或重新创建所需资源。
查看详情**出现原因：**请求引用的 token、卡片、报告或其他资源已经过期。 **重试：**替换过期资源后重试。
| | **400** Legacy flat | `400` `The no_pin_payment_amount restrict configuration cannot be found` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `TransactionId ` | [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `TransactionId cannot be empty` | [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `Unexpected error` | [Simulate Reversal](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-reversal.md) `POST /v1/simulation/issuing/reversal` operationId: `simulate-reversal` | **联系 UQPAY** 不要高频重试；记录响应信息后联系 UQPAY 排查。
查看详情**出现原因：**UQPAY 在处理请求时发生服务端错误。 **重试：**仅在业务允许时按指数退避进行有限重试。 **何时联系 UQPAY：**收到此错误，或有限重试后仍未恢复。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **400** Legacy flat | `400` `Update card error` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `['page_number is invalid']` | [List Cards](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards.md) `GET /v1/issuing/cards` operationId: `list-cards` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `card id is invalid` | [Card Recharge](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/card-recharge.md) `POST /v1/issuing/cards/{id}/recharge` operationId: `card-recharge` [Card Withdraw](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/card-withdraw.md) `POST /v1/issuing/cards/{id}/withdraw` operationId: `card-withdraw` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `card limit is illegal` | [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `card_number value is illegal` | [List Cards](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards.md) `GET /v1/issuing/cards` operationId: `list-cards` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `card_status value is illegal` | [List Cards](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards.md) `GET /v1/issuing/cards` operationId: `list-cards` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `field [name_on_card] exceeds the maximum length of 26` | [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `id is invalid` | 适用于 7 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `invalid no pin payment amount for the current currency.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `invalid no pin payment amount precision` | [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `limit_amount must be greater than 0` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `limit_amount precision invalid` | [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` **Message pattern** `missing field: [{field}]` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `negative no pin payment amount` | [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `no pin payment amount failed.` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `recharge amount is invalid` | [Card Recharge](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/card-recharge.md) `POST /v1/issuing/cards/{id}/recharge` operationId: `card-recharge` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `transaction amount is invalid` | [Simulate Authorization](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/simulate-authorization.md) `POST /v1/simulation/issuing/authorization` operationId: `simulate-authorization` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `update reason too long` | [Update Card Status](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card-status.md) `POST /v1/issuing/cards/{id}/status` operationId: `update-card-status` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Legacy flat | `400` `withdraw amount is invalid` | [Card Withdraw](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/card-withdraw.md) `POST /v1/issuing/cards/{id}/withdraw` operationId: `card-withdraw` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** Other envelope | `cardholder_incomplete_fields` `cardholder_required_fields is incomplete for one-time card issuance` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `account_error` | `account_balance_error` `insufficient balance or currency balance unavailable` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` [Retrieve Issuing Balance](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-issuing-balance.md) `POST /v1/issuing/balances` operationId: `retrieve-issuing-balance` | **修改请求** 确保对应币种余额充足且可用后重试。
查看详情**出现原因：**对应币种余额不足或当前不可用。 **重试：**补充或选择可用余额后重试。
| | **400** `account_error` | `account_not_found` `account not found or deactivated` | 适用于 30 个公开接口 | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `account_error` | `product_not_found` `product not found or inactive` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` [List Card Arts](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-card-arts.md) `GET /v1/issuing/cards/arts` operationId: `list-card-arts` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `account_error` | `sub_account_not_found` `sub-account associated with the on-behalf-of not found or deactivated` | 适用于 22 个公开接口 | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `card_error` | `card_art_not_available` `card_art_id is not available for this account` | [Set Default Card Art](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/set-default-card-art.md) `POST /v1/issuing/cards/arts/default` operationId: `set-default-card-art` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `card_error` | `card_art_not_supported` `card_art_id is not supported for this product` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `card_error` | `card_expired_error` `card has expired` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 改用未过期的资源或重新创建所需资源。
查看详情**出现原因：**请求引用的 token、卡片、报告或其他资源已经过期。 **重试：**替换过期资源后重试。
| | **400** `card_error` | `card_not_found` `card not found or deactivated` | 使用 card ID 查询或操作卡片的接口 | **修改请求** 核对 card ID，确认卡片属于当前账户且仍然有效。
查看详情**出现原因：**Card ID 不属于当前账户、记录不存在，或者卡片已经停用。 **重试：**修正 card ID 或选择有效卡片后重试。 **何时联系 UQPAY：**同一账户返回的有效卡片仍无法查询。 **请额外提供：**card ID。 **相关接口：**[List Cards](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards.md) · [Retrieve Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-card.md)
| | **400** `card_error` | `currency_not_allowed` `card currency is not allowed` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `card_error` | `enable_3ds_not_allowed` `merchant not allowed to set enable_3ds` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 移除 enable\_3ds，或联系 UQPAY 确认当前产品是否允许配置 3DS。
查看详情**出现原因：**当前账户或产品未允许设置 enable\_3ds。 **重试：**移除 enable\_3ds，或联系 UQPAY 确认当前产品是否允许配置 3DS。
| | **400** `card_error` | `insufficient_sub_bin` `insufficient available cards for sub-bin` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **联系 UQPAY** 不要反复重试；等待 UQPAY 确认可用卡号库存已补充。
查看详情**出现原因：**当前账户下所选卡产品对应的 sub-BIN 池没有可用卡号。 **重试：**等待 UQPAY 确认可用卡号库存已经补充后再重试。 **何时联系 UQPAY：**收到此错误后。 **请额外提供：**account ID、card product ID 或 BIN。
| | **400** `card_error` | `limit_out_of_range` `card limit is either less than minimum card limit or greater than maximum card limit` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `card_error` | `operation_not_authorized` `requested card operation type is not authorized` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `card_error` | `risk_control_not_allowed` `risk control setting is not allowed` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `card_error` | `status_not_supported` `card status or activation status not supported by request` | 适用于 4 个公开接口 | **等待后重试** 先让卡片进入该操作支持的状态，再重试请求。
查看详情**出现原因：**当前卡片状态或激活状态不支持所请求的操作。 **重试：**卡片进入受支持状态后再重试。 **注意：**如果卡片已经注销或过期，不要重试；需要时请补发新卡。 **相关接口：**[Retrieve Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-card.md)
| | **400** `card_error` | `virtual_card_pin_error` `virtual cards do not allow pin settings` | [Activate Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/activate-card.md) `POST /v1/issuing/cards/activate` operationId: `activate-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `cardholder_cannot_update_during_review` `cannot update KYC fields while review is pending` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `cardholder_kyc_failed` `cardholder KYC has been rejected` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `cardholder_kyc_pending` `cardholder KYC is under review, cannot proceed` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **等待后重试** 等待 KYC 离开 pending 状态后，再次创建卡片。
查看详情**出现原因：**发卡时，持卡人的 KYC 仍处于审核中。 **重试：**KYC 离开 pending 状态后再重试。 **何时联系 UQPAY：**状态长时间没有变化。 **请额外提供：**cardholder ID、最新 KYC 状态。 **相关接口：**[Retrieve Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-cardholder.md)
| | **400** `cardholder_error` | `cardholder_missing_info` `either cardholder_id or complete cardholder_required_fields must be provided` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `cardholder_not_found` `cardholder not found or deactivated` | 适用于 4 个公开接口 | **修改请求** 核对 cardholder ID，确认持卡人属于当前账户且仍然有效。
查看详情**出现原因：**Cardholder ID 不属于当前调用账户、记录不存在，或者持卡人已经停用。 **重试：**修正 cardholder ID 或选择有效持卡人后重试。 **何时联系 UQPAY：**同一账户返回的有效持卡人仍无法查询。 **请额外提供：**cardholder ID。 **相关接口：**[List Cardholders](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cardholders.md)
| | **400** `cardholder_error` | `document_duplicated` `document already successfully reviewed` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 不要重复创建或提交；先查询并使用现有资源或当前状态。
查看详情**出现原因：**相同资源、信息或操作已经存在或已经完成。 **重试：**仅在确认原操作未生效且状态允许时重试。
| | **400** `cardholder_error` | `document_size_exceeded` `document size exceeds 2MB limit` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `email_duplicated` `email already used by another cardholder under account` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 不要重复创建或提交；先查询并使用现有资源或当前状态。
查看详情**出现原因：**相同资源、信息或操作已经存在或已经完成。 **重试：**仅在确认原操作未生效且状态允许时重试。
| | **400** `cardholder_error` | `file_type_not_supported` `unsupported document file type` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_date_of_birth` `cardholder under 18 or invalid date of birth format` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_delivery_address` `invalid delivery address` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_file_content` `invalid base64 encoded document content` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 将原始文件字节重新编码为标准 Base64 后提交。
查看详情**出现原因：**身份文件内容不是有效的标准 Base64。 **重试：**重新编码文件后重试。 **注意：**联系支持时不要发送身份文件本身。 **请额外提供：**文件类型、文件大小（不要发送身份文件本身）。
| | **400** `cardholder_error` | `invalid_first_name` `invalid first name, only letters and spaces allowed, no leading or trailing spaces` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_identity_type` `invalid identity type, must be ID_CARD or PASSPORT` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_last_name` `invalid last name, only letters and spaces allowed, no leading or trailing spaces` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_phone_number` `invalid phone number or country code` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `invalid_residential_address` `invalid residential_address, only letters, numbers, spaces and common punctuation (, . ' / # ( ) - &) allowed` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `kyc_insufficient` **动态 message** Message 会说明持卡人信息不满足产品要求，并返回 missing\_fields。 | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 missing\_fields 补齐持卡人信息后，再次创建卡片。
查看详情**出现原因：**所选 card product 要求的一个或多个持卡人字段尚未提供。 **重试：**持卡人记录包含所有必需字段后重试。 **何时联系 UQPAY：**某个字段无法通过 Update Cardholder 提交。 **请额外提供：**card product ID、missing\_fields。 **相关接口：**[Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md)
| | **400** `cardholder_error` | `kyc_insufficient` `cardholder information does not meet this product's requirements` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `missing_date_of_birth` `missing legal date of birth for document upload` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 先提供合法的 date\_of\_birth，再上传身份文件。
查看详情**出现原因：**上传身份文件时缺少合法出生日期。 **重试：**先提供合法的 date\_of\_birth，再上传身份文件。
| | **400** `cardholder_error` | `phone_number_duplicated` `phone number used by another cardholder under account` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `cardholder_error` | `reference_id_duplicated` `reference_id already used by another cardholder` | [Create Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-cardholder.md) `POST /v1/issuing/cardholders` operationId: `create-cardholder` [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 为当前持卡人使用未被占用的 reference\_id。
查看详情**出现原因：**Reference ID 已被其他持卡人使用。 **重试：**为当前持卡人使用未被占用的 reference\_id。
| | **400** `idempotency_error` | `invalid_key_format` `invalid idempotency key format` | 适用于 18 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `idempotency_error` | `key_mismatch_account` `key does not belong to account` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 为当前 connected account 使用新的 Idempotency-Key。
查看详情**出现原因：**该 Idempotency-Key 属于其他账户。 **重试：**为当前 connected account 使用新的 Idempotency-Key。
| | **400** `idempotency_error` | `key_mismatch_api` `api associated with key is not the original` | 所有使用 x-idempotency-key 的公开接口 | **修改请求** 不同操作使用新的 Idempotency-Key；重试原操作时继续使用原 key。
查看详情**出现原因：**这个 Idempotency-Key 之前已用于其他 endpoint 或 HTTP method。 **重试：**替换 key 后重试；如果是重试原始请求，则继续使用原 key。 **注意：**只有在原 endpoint、method 和请求体均不变时才能复用原 key。
| | **400** `idempotency_error` | `request_being_processed` `request is being processed` | 所有使用 x-idempotency-key 的公开接口 | **等待后重试** 等待片刻，使用相同 Idempotency-Key 和完全相同的请求体重试。
查看详情**出现原因：**相同 Idempotency-Key 对应的原始请求仍在处理中。 **重试：**等待后，使用相同 key 和完全相同的请求体重试。 **注意：**不要生成新 key，也不要修改 payload。 **何时联系 UQPAY：**请求持续处于处理中。 **请额外提供：**Idempotency-Key、原始请求时间、重试时间。
| | **400** `invalid_request_error` | `invalid_request_error` `Account card quota exceeded.` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **联系 UQPAY** 停止重复提交，并联系 UQPAY 核对额度或资源配额。
查看详情**出现原因：**当前账户、持卡人或卡号资源已达到可用配额。 **重试：**修正请求后再重试。 **何时联系 UQPAY：**收到此错误后。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **400** `invalid_request_error` | `invalid_request_error` `COUNTRY_PRODUCT_MISMATCH` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 确保卡片国家或地区与 card product 一致。
查看详情**出现原因：**卡片国家或地区与产品不匹配。 **重试：**确保卡片国家或地区与 card product 一致。
| | **400** `invalid_request_error` | `invalid_request_error` `Cardholder card quota exceeded.` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **联系 UQPAY** 停止重复提交，并联系 UQPAY 核对额度或资源配额。
查看详情**出现原因：**当前账户、持卡人或卡号资源已达到可用配额。 **重试：**修正请求后再重试。 **何时联系 UQPAY：**收到此错误后。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **400** `invalid_request_error` | `invalid_request_error` `HA_TO_SA feature unavailable` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **动态 message** Message 会指出 page\_number 或 page\_size 的校验问题。 | [List Merchant Brands](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-merchant-brands.md) `GET /v1/issuing/merchant_brands` operationId: `list-merchant-brands` | **修改请求** 按 message 修正分页参数后重试。
查看详情**出现原因：**查询参数未通过校验。 **重试：**按 message 修正分页参数后重试。
| | **400** `invalid_request_error` | `invalid_request_error` **动态 message** Message 会指出不合法的字段或校验规则。 | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 按照 message 指出的字段和校验规则修正请求。
查看详情**出现原因：**请求缺少字段、字段类型错误，或者字段值未通过校验。 **重试：**修正请求后再重试。 **何时联系 UQPAY：**Message 没有提供可操作的字段或规则。
| | **400** `invalid_request_error` | `invalid_request_error` **动态 message** Message 会说明 token 无法解析。 | 所有公开接口 | **修改认证信息** 重新获取 token，并按文档要求传递完整的 Bearer token。
查看详情**出现原因：**Token 格式不正确或无法解析。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `PIN cannot be part of the cardholder phone number.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 使用不包含在持卡人电话号码中的 PIN。
查看详情**出现原因：**PIN 是持卡人电话号码的一部分。 **重试：**使用不包含在持卡人电话号码中的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `PIN cannot contain the same digit repeated.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 使用不由同一数字重复组成的 PIN。
查看详情**出现原因：**PIN 由同一数字重复组成。 **重试：**使用不由同一数字重复组成的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `PIN cannot match the last four digits of the card.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 使用与卡号末四位不同的 PIN。
查看详情**出现原因：**PIN 与卡号末四位相同。 **重试：**使用与卡号末四位不同的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `PIN length is invalid.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 提交 4 位 PIN。
查看详情**出现原因：**PIN 长度不正确。 **重试：**提交 4 位 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `PIN must contain digits only.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** PIN 仅使用数字。
查看详情**出现原因：**PIN 包含非数字字符。 **重试：**PIN 仅使用数字。
| | **400** `invalid_request_error` | `invalid_request_error` `SA_TO_HA feature unavailable` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `The current card requires an Card SKU number.` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 为当前卡片提供所需的 Card SKU number。
查看详情**出现原因：**当前卡片要求 Card SKU number。 **重试：**为当前卡片提供所需的 Card SKU number。
| | **400** `invalid_request_error` | `invalid_request_error` `This card does not support PIN management.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `This operation cannot be performed on One-Time Card.` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `a release request for this original transaction is already in progress` | [Claim Unsolicited Refund](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/claim-unsolicited-refund.md) `POST /v1/issuing/transactions/unsolicited_refund/release` operationId: `claim-unsolicited-refund` | **等待后重试** 等待当前处理完成或状态更新后再重试。
查看详情**出现原因：**相关请求或资源仍在处理中。 **重试：**等待状态变化后重试；不要高频轮询。
| | **400** `invalid_request_error` | `invalid_request_error` `account balance is less than total amount` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 确保对应币种余额充足且可用后重试。
查看详情**出现原因：**对应币种余额不足或当前不可用。 **重试：**补充或选择可用余额后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `account balance is not active` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `account balance status is not available` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `assign country unsupported for card product` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 选择该 card product 支持的发卡国家或地区。
查看详情**出现原因：**当前 card product 不支持指定国家或地区。 **重试：**选择该 card product 支持的发卡国家或地区。
| | **400** `invalid_request_error` | `invalid_request_error` `card currency is not supported` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card form err` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card has already been reserved` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 不要重复创建或提交；先查询并使用现有资源或当前状态。
查看详情**出现原因：**相同资源、信息或操作已经存在或已经完成。 **重试：**仅在确认原操作未生效且状态允许时重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card not available for this account` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card number expired` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 改用未过期的资源或重新创建所需资源。
查看详情**出现原因：**请求引用的 token、卡片、报告或其他资源已经过期。 **重试：**替换过期资源后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card number not exist` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `card_art_id cannot be empty` | [Set Default Card Art](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/set-default-card-art.md) `POST /v1/issuing/cards/arts/default` operationId: `set-default-card-art` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `destination account[{destination_account_id}] not found` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `display_name or merchant_code cannot be empty` | [List Merchant Brands](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-merchant-brands.md) `GET /v1/issuing/merchant_brands` operationId: `list-merchant-brands` | **修改请求** 至少提供 display\_name 或 merchant\_code 后重试。
查看详情**出现原因：**两个查询条件都为空。 **重试：**至少提供 display\_name 或 merchant\_code 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `field [page_size] exceeds the maximum length of 100` | [List Issuing Balances](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-issuing-balances.md) `GET /v1/issuing/balances` operationId: `list-issuing-balances` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `field [page_size] is shorter than the minimum length of 10` | [List Issuing Balances](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-issuing-balances.md) `GET /v1/issuing/balances` operationId: `list-issuing-balances` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `inconsistent formats between start time and end time` | [Create Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-report.md) `POST /v1/issuing/reports` operationId: `create-report` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `insufficient account balance` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid JSON request body` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 提交合法 JSON，并按 API Reference 检查字段类型。
查看详情**出现原因：**请求体不是合法 JSON。 **重试：**提交合法 JSON，并按 API Reference 检查字段类型。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid card metadata` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid card number` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid card number format` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid card number format` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 按接口要求提供合法的 card\_number。
查看详情**出现原因：**Card number 格式不正确。 **重试：**按接口要求提供合法的 card\_number。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid card_id format` | [Create PAN Token](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-pan-token.md) `POST /v1/issuing/cards/{id}/token` operationId: `create-pan-token` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid cardholder id` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid character …` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid end time:…` | [Create Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-report.md) `POST /v1/issuing/reports` operationId: `create-report` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `invalid merchant_code: {merchant_code}` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 使用 List Merchant Brands 返回的有效 merchant\_code。
查看详情**出现原因：**指定 merchant\_code 不存在。 **重试：**使用 List Merchant Brands 返回的有效 merchant\_code。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid spending control amount due to negative amount or invalid logical relationships` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid start time:…` | [Create Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-report.md) `POST /v1/issuing/reports` operationId: `create-report` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid time format` | [List Cards Transactions](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards-transactions.md) `GET /v1/issuing/transactions` operationId: `list-cards-transactions` [List Issuing Balances Transactions](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-issuing-balances-transactions.md) `GET /v1/issuing/balances/transactions` operationId: `list-issuing-balances-transactions` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid token format` | 所有公开接口 | **修改认证信息** 重新获取 token，并按文档要求传递完整的 Bearer token。
查看详情**出现原因：**Token 格式不正确或无法解析。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid transfer between two sub accounts` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `invalid usage type` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `merchant rule is incomplete: {merchant_code}` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **联系 UQPAY** 停止重试并联系 UQPAY 核对 merchant rule 配置。
查看详情**出现原因：**指定 merchant\_code 的规则配置不完整。 **重试：**停止重试并联系 UQPAY 核对 merchant rule 配置。 **何时联系 UQPAY：**收到此错误后。 **请额外提供：**x-response-id、请求时间、merchant\_code。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `merchant_code cannot be empty at index {index}` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** 移除空值或提供有效 merchant\_code。
查看详情**出现原因：**Merchant code 列表包含空值。 **重试：**移除空值或提供有效 merchant\_code。
| | **400** `invalid_request_error` | `invalid_request_error` `missing authentication token` | 所有公开接口 | **修改认证信息** 在请求中提供有效的 access token。
查看详情**出现原因：**请求未提供可用的认证 token。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `missing card_product_id` | [List Card Arts](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-card-arts.md) `GET /v1/issuing/cards/arts` operationId: `list-card-arts` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `missing field: [{field}]` | 适用于 11 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `negative amount after fee deduction` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `no unsolicited refund intercept transaction found to claim` | [Claim Unsolicited Refund](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/claim-unsolicited-refund.md) `POST /v1/issuing/transactions/unsolicited_refund/release` operationId: `claim-unsolicited-refund` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `old_pin is only allowed for UPDATE` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 仅在 UPDATE 操作中传递 old\_pin。
查看详情**出现原因：**非 UPDATE 操作提供了 old\_pin。 **重试：**仅在 UPDATE 操作中传递 old\_pin。
| | **400** `invalid_request_error` | `invalid_request_error` `old_pin is required` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `old_pin is required for UPDATE` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 执行 UPDATE 时提供 old\_pin。
查看详情**出现原因：**UPDATE 操作缺少 old\_pin。 **重试：**执行 UPDATE 时提供 old\_pin。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `old_pin must contain exactly {expected_length} digits` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 根据卡片渠道提交 4 位或 6 位数字 old\_pin。
查看详情**出现原因：**Old PIN 位数或字符格式不符合要求。 **重试：**根据卡片渠道提交 4 位或 6 位数字 old\_pin。
| | **400** `invalid_request_error` | `invalid_request_error` `one-time card limit must be greater than 0` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `only one of allowed_merchants or blocked_merchants can be set` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` [Update Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-card.md) `POST /v1/issuing/cards/{id}` operationId: `update-card` | **修改请求** allowed\_merchants 和 blocked\_merchants 只能设置其中一个。
查看详情**出现原因：**两个 merchant control 同时被设置。 **重试：**allowed\_merchants 和 blocked\_merchants 只能设置其中一个。
| | **400** `invalid_request_error` | `invalid_request_error` `original transaction is not a valid authorization source transaction` | [Claim Unsolicited Refund](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/claim-unsolicited-refund.md) `POST /v1/issuing/transactions/unsolicited_refund/release` operationId: `claim-unsolicited-refund` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `original transaction not found or not owned by current account` | [Claim Unsolicited Refund](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/claim-unsolicited-refund.md) `POST /v1/issuing/transactions/unsolicited_refund/release` operationId: `claim-unsolicited-refund` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `permission denied on the connected account` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `physical card creation not allowed` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `pin cannot be part of the cardholder phone number` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 使用不包含在持卡人电话号码中的 PIN。
查看详情**出现原因：**PIN 是持卡人电话号码的一部分。 **重试：**使用不包含在持卡人电话号码中的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `pin cannot contain the same digit repeated` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 使用不由同一数字重复组成的 PIN。
查看详情**出现原因：**PIN 由同一数字重复组成。 **重试：**使用不由同一数字重复组成的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `pin cannot match the last four digits of the card` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 使用与卡号末四位不同的 PIN。
查看详情**出现原因：**PIN 与卡号末四位相同。 **重试：**使用与卡号末四位不同的 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `pin must contain exactly {expected_length} digits` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 根据卡片渠道提交 4 位或 6 位数字 PIN。
查看详情**出现原因：**PIN 位数或字符格式不符合要求。 **重试：**根据卡片渠道提交 4 位或 6 位数字 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `pin must differ from old_pin` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 使用与 old\_pin 不同的新 PIN。
查看详情**出现原因：**新 PIN 与 old\_pin 相同。 **重试：**使用与 old\_pin 不同的新 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `pin must differ from old_pin.` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 使用与 old\_pin 不同的新 PIN。
查看详情**出现原因：**新 PIN 与 old\_pin 相同。 **重试：**使用与 old\_pin 不同的新 PIN。
| | **400** `invalid_request_error` | `invalid_request_error` `product not found` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `products not found` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `report has expired` | [Download Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/download-report-file.md) `GET /v1/issuing/reports/{id}` operationId: `download-report-file` | **修改请求** 改用未过期的资源或重新创建所需资源。
查看详情**出现原因：**请求引用的 token、卡片、报告或其他资源已经过期。 **重试：**替换过期资源后重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `report[{report_id}] not found` | [Download Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/download-report-file.md) `GET /v1/issuing/reports/{id}` operationId: `download-report-file` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `required valid email address` | [Update Cardholder](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/update-cardholder.md) `POST /v1/issuing/cardholders/{id}` operationId: `update-cardholder` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `risk control setting is not allowed` | [Create Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-card.md) `POST /v1/issuing/cards` operationId: `create-card` | **修改请求** 调整请求，使操作、产品、币种或资源状态符合接口支持范围。
查看详情**出现原因：**当前操作、产品、币种、账户权限或资源状态不受支持。 **重试：**确认条件满足后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `source account[{source_account_id}] not found` | [Create Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-issuing-transfer.md) `POST /v1/issuing/transfers` operationId: `create-issuing-transfer` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `start time is later than end time` | [Create Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-report.md) `POST /v1/issuing/reports` operationId: `create-report` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `the card does not exist or has already been assigned` | [Assign Card](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/assign-card.md) `POST /v1/issuing/cards/assign` operationId: `assign-card` | **修改请求** 核对 card number，并确认该卡尚未分配。
查看详情**出现原因：**卡片不存在或已经被分配。 **重试：**核对 card number，并确认该卡尚未分配。
| | **400** `invalid_request_error` | `invalid_request_error` `the provided transfer id does not belong to the connected account` | [Retrieve Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-issuing-transfer.md) `GET /v1/issuing/transfers/{id}` operationId: `retrieve-issuing-transfer` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `transaction[{transaction_id}] not found under the connected account` | [Retrieve Cards Transaction](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-cards-transaction.md) `GET /v1/issuing/transactions/{id}` operationId: `retrieve-cards-transaction` | **修改请求** 使用同一 connected account 下存在的 transaction ID。
查看详情**出现原因：**Transaction ID 不属于当前 connected account，或者记录不存在。 **重试：**修正 transaction ID 后重试。 **何时联系 UQPAY：**同一账户返回的 transaction ID 仍无法查询。 **请额外提供：**transaction ID。 **相关接口：**[List Cards Transactions](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/list-cards-transactions.md)
| | **400** `invalid_request_error` | `invalid_request_error` **Message pattern** `transfer[{transfer_id}] not found` | [Retrieve Issuing Transfer](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-issuing-transfer.md) `GET /v1/issuing/transfers/{id}` operationId: `retrieve-issuing-transfer` | **修改请求** 核对资源 ID，并确认资源属于当前 connected account。
查看详情**出现原因：**指定资源不存在、不属于当前账户或已不可用。 **重试：**使用有效且属于当前账户的资源 ID 后重试。
| | **400** `invalid_request_error` | `invalid_request_error` `type must be 0, 1 or 2` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 将 type 设置为 0、1 或 2。
查看详情**出现原因：**PIN 操作类型不受支持。 **重试：**将 type 设置为 0、1 或 2。
| | **400** `invalid_request_error` | `invalid_request_error` `type must be SET or RESET` | [Set or Reset Virtual Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/manage-card-pin.md) `POST /v1/issuing/cards/manage/pin` operationId: `manage-card-pin` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `unknown report type: UNKNOWN` | [Create Report](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-report.md) `POST /v1/issuing/reports` operationId: `create-report` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **400** `invalid_request_error` | `invalid_request_error` `unsolicited refund claim only supported on VISA` | [Claim Unsolicited Refund](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/claim-unsolicited-refund.md) `POST /v1/issuing/transactions/unsolicited_refund/release` operationId: `claim-unsolicited-refund` | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `auth url not config` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `create request failed` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `internal configconfig error` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `ip not allowed` | 适用于 35 个公开接口 | **联系 UQPAY** 确认请求出口 IP，并联系 UQPAY 核对 allowlist。
查看详情**出现原因：**请求来源 IP 未被当前 API key 允许。 **重试：**修正请求后再重试。 **何时联系 UQPAY：**确认出口 IP 后。 **请额外提供：**x-response-id、请求时间、完整错误响应、请求出口 IP。
| | **401** `unauthorized_error` | `unauthorized_error` `marshal request failed` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `request failed` | 适用于 35 个公开接口 | **修改请求** 根据 message 检查并修正请求参数后重试。
查看详情**出现原因：**请求参数、资源状态或账户配置不满足当前操作要求。 **重试：**修正请求后再重试。
| | **401** `unauthorized_error` | `unauthorized_error` `token has expired` | 所有公开接口 | **重新认证** 获取新的 access token 后重试。
查看详情**出现原因：**当前 access token 已过期。 **重试：**修正请求后再重试。
| | **403** `unauthorized_error` | `forbidden` `forbidden` | [Retrieve Sensitive Card Details](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/retrieve-card-secure.md) `GET /v1/issuing/cards/{id}/secure` operationId: `retrieve-card-secure` | **联系 UQPAY** 联系 UQPAY 确认当前账户是否已开通该接口。
查看详情**出现原因：**当前账户没有访问该接口的权限。 **重试：**修正请求后再重试。 **何时联系 UQPAY：**收到此错误后。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **404** `card_error` | `card_not_found` `card not found or deactivated` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 核对 card ID，并确认卡片属于当前 connected account。
查看详情**出现原因：**指定卡片不存在或不属于当前账户。 **重试：**核对 card ID，并确认卡片属于当前 connected account。
| | **409** `card_error` | `card_expired_error` `card has expired` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 不要继续对该卡执行 PIN 操作；改用未过期的卡片。
查看详情**出现原因：**当前卡片已经过期。 **重试：**不要继续对该卡执行 PIN 操作；改用未过期的卡片。
| | **409** `card_error` | `status_not_supported` `card status or activation status not supported by request` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **等待后重试** 让卡片进入 ACTIVE 状态后再重试。
查看详情**出现原因：**当前卡片状态或处理状态不是 ACTIVE。 **重试：**让卡片进入 ACTIVE 状态后再重试。
| | **409** `idempotency_error` | `idempotency_key_mismatch` `idempotency key was already used with a different request` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 原请求重试时保持 payload 不变；不同请求使用新的 Idempotency-Key。
查看详情**出现原因：**同一 Idempotency-Key 已用于不同请求体。 **重试：**原请求重试时保持 payload 不变；不同请求使用新的 Idempotency-Key。
| | **409** `idempotency_error` | `request_being_processed` `request is being processed` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **等待后重试** 等待后使用相同 Idempotency-Key 和完全相同的请求体重试。
查看详情**出现原因：**相同幂等请求仍在处理中。 **重试：**等待后使用相同 Idempotency-Key 和完全相同的请求体重试。
| | **409** `invalid_request_error` | `pin_operation_processing` `A PIN operation for this card is already processing.` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **等待后重试** 等待当前 PIN 操作完成后再重试。
查看详情**出现原因：**同一张卡已有 PIN 操作正在处理中。 **重试：**等待当前 PIN 操作完成后再重试。
| | **422** `invalid_request_error` | `pin_operation_not_supported` `This card does not support the requested PIN operation.` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **修改请求** 改用支持该 PIN 操作的卡片或操作类型。
查看详情**出现原因：**当前卡片渠道或形态不支持所请求的 PIN 操作。 **重试：**改用支持该 PIN 操作的卡片或操作类型。
| | **429** Legacy flat | `429` `Request is too frequent` | [Create PAN Token](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/create-pan-token.md) `POST /v1/issuing/cards/{id}/token` operationId: `create-pan-token` [Elevate Per-Transaction Limit](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/elevate-card-limit.md) `POST /v1/issuing/cards/{id}/elevate_limit` operationId: `elevate-card-limit` | **等待后重试** 停止高频请求，等待数秒后按指数退避重试。
查看详情**出现原因：**针对同一张卡片的敏感操作请求过于频繁。 **重试：**等待数秒后重试，并在连续失败时逐步增加等待时间。 **何时联系 UQPAY：**在较低请求频率下仍持续报错。 **请额外提供：**card ID、实际请求频率。
| | **500** `api_error` | `api_error` `api service error` | 适用于 31 个公开接口 | **联系 UQPAY** 不要高频重试；记录响应信息后联系 UQPAY 排查。
查看详情**出现原因：**UQPAY 在处理请求时发生服务端错误。 **重试：**仅在业务允许时按指数退避进行有限重试。 **何时联系 UQPAY：**收到此错误，或有限重试后仍未恢复。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| | **503** `idempotency_error` | `idempotency_unavailable` `Idempotency protection is temporarily unavailable` | [Reset Card PIN](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/api-reference/reset-pin.md) `POST /v1/issuing/cards/pin` operationId: `reset-pin` | **等待后重试** 不要绕过幂等保护；等待服务恢复后使用相同请求重试。
查看详情**出现原因：**PIN 幂等保护暂时不可用。 **重试：**不要绕过幂等保护；等待服务恢复后使用相同请求重试。 **何时联系 UQPAY：**等待并有限重试后仍未恢复。 **请额外提供：**x-response-id、请求时间、完整错误响应。
| ## 相关文档 * [卡片生命周期](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/guide/card-lifecycle.md) * [创建和管理持卡人](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/guide/create-and-manage-cardholders.md) * [消费限额](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/guide/spending-controls.md) * [在 Sandbox 中测试](https://developers-sandbox.uqpaytech.com/docs/zh/card-issuance/v1.6/guide/testing-in-sandbox.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.