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 或说明。
联系 UQPAY 前，请准备 HTTP method 和 path、
x-response-id、请求时间及完整错误响应，并移除 API key、access token、PAN 等敏感信息。每条错误的详情只列出额外需要提供的信息。显示全部错误
未找到匹配项。请检查拼写，或减少搜索词后重试。
| HTTP / Type | Code / Message | Endpoint | 推荐处理 |
|---|---|---|---|
| 400 Legacy flat | 403Login expired | 所有公开接口 | 更新认证 重新获取有效凭证，并检查认证 header 后重试。 查看详情出现原因：认证信息缺失、已过期或无法通过校验。 重试：更新凭证或认证 header 后重试。 |
| 400 Legacy flat | 403banking account not found | 所有公开接口 | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 403account not active / not tradable | 所有公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 403api trading not enabled for this account | 所有公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400IP not allowed | 所有公开接口 | 更新认证 重新获取有效凭证，并检查认证 header 后重试。 查看详情出现原因：认证信息缺失、已过期或无法通过校验。 重试：更新凭证或认证 header 后重试。 |
| 400 Legacy flat | 1084invalid x-on-behalf-of account id | 所有公开接口 | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 1084banking account not found | 所有公开接口 | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 1084account not active / not tradable | 所有公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 1084not authorized to act on behalf of the target account | 所有公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 1084Select user failed | 所有公开接口 | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 403Forbidden | 所有公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query balances failed | List AssetsGET /v1/ramp/assetoperationId: list-assets | 检查余额 确认可用余额和币种满足本次操作要求。 查看详情出现原因：当前可用余额、币种或余额账户不满足操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400balance not found | Retrieve AssetGET /v1/ramp/asset/{balance_currency}operationId: retrieve-asset | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query transactions failed | List Asset TransactionsGET /v1/ramp/asset/transactionsoperationId: list-asset-transactions | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
400invalid_request_error | invalid_parameterparameter is invalid | Create TransferPOST /v1/ramp/transferoperationId: create-transferRetrieve Transfer GET /v1/ramp/transfer/{order_id}operationId: retrieve-transfer | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
400transfer_error | create_transfer_failedcreate transfer failed | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
400not_found | not_foundError to Geting Account Product Data | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
400account_error | account_errorAccount not found or deactivated | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
400account_error | account_errorAccount not active | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
400not_found | not_foundError to Geting Balance Data | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 检查余额 确认可用余额和币种满足本次操作要求。 查看详情出现原因：当前可用余额、币种或余额账户不满足操作要求。 重试：修正请求或资源状态后再重试。 |
400transfer_error | insufficient_balanceInsufficient account balance | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 检查余额 确认可用余额和币种满足本次操作要求。 查看详情出现原因：当前可用余额、币种或余额账户不满足操作要求。 重试：修正请求或资源状态后再重试。 |
400api_error | risk_verify_failedRisk verification failed | Create TransferPOST /v1/ramp/transferoperationId: create-transfer | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
400not_found | not_foundError to Geting Transfer Data | Retrieve TransferGET /v1/ramp/transfer/{order_id}operationId: retrieve-transfer | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400invalid request | 适用于 6 个公开接口 | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid amount | 适用于 4 个公开接口 | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400fixed_currency must equal sell_currency or buy_currency | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quote | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400currency not supported | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Quote POST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid quote request (check currencies/amount) | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quote | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400no exchange rate available for this currency pair | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quote | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400account not active | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Quote POST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400exchange not enabled for account | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Quote POST /v1/ramp/conversion/quoteoperationId: create-quote | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400exchange limit not configured for account | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quote | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400amount below minimum | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400amount above maximum | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400amount exceeds daily limit | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400amount exceeds monthly limit | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quoteCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400exchange create failed | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Quote POST /v1/ramp/conversion/quoteoperationId: create-quote | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400insufficient balance | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查余额 确认可用余额和币种满足本次操作要求。 查看详情出现原因：当前可用余额、币种或余额账户不满足操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400quote invalid or mismatched | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400quote already used | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400market price moved beyond tolerance since quote; please re-quote | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query orders failed | List ConversionsGET /v1/ramp/conversionoperationId: list-conversions | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400order not found | Retrieve ConversionGET /v1/ramp/conversion/{order_id}operationId: retrieve-conversion | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query deposits failed | List DepositsGET /v1/ramp/depositoperationId: list-deposits | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400deposit not found | Retrieve DepositGET /v1/ramp/deposit/{order_id}operationId: retrieve-deposit | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400asset and network are required | Deposit Wallet AddressGET /v1/ramp/deposit/addressoperationId: deposit-wallet-address | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400deposit address not found | Deposit Wallet AddressGET /v1/ramp/deposit/addressoperationId: deposit-wallet-address | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query deposit address failed | List Deposit AddressesGET /v1/ramp/deposit/addressesoperationId: list-deposit-addresses | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400address_id or withdraw_address is required | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400destination address not whitelisted | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400withdraw product/fee not configured | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400withdraw limit not configured for account | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400amount too small to cover network fee | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400risk verification rejected | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400destination address risk score too high | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400withdraw channel not configured for this account/asset | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400destination address requires compliance info, please complete it in address book | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400aml screening temporarily unavailable, please retry later | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400withdraw create failed | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400query withdrawals failed | List WithdrawsGET /v1/ramp/withdrawoperationId: list-withdraws | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400withdrawal not found | Retrieve WithdrawGET /v1/ramp/withdraw/{order_id}operationId: retrieve-withdraw | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query assets failed | List Supported Assets and NetworksGET /v1/ramp/config/assetsoperationId: list-supported-assets | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400asset is required | Estimate Network FeeGET /v1/ramp/config/network-feeoperationId: estimate-network-fee | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400network fee unavailable | Estimate Network FeeGET /v1/ramp/config/network-feeoperationId: estimate-network-fee | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400legal_declaration does not match address_type | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-book | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid travel rule meta_data json: invalid character ‘x’ looking for beginning of value | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid wallet_type | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid address_party | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400individual third party requires first_name and last_name | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400corporation third party requires company_name | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid entity_type | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400third party requires country and city | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400hosted wallet requires vasp_id or vasp_name | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-bookSubmit Deposit Sender Travel Rule POST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-senderUpdate Address Book POST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400this address is not allowed | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-book | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid address format for network ETH | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400add address failed | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400address label already exists | Create Address BookPOST /v1/ramp/wallet_addressoperationId: create-address-book | 避免重复提交 先查询原请求或资源状态，不要立即创建重复请求。 查看详情出现原因：相同请求或资源已经存在，或幂等键与原请求不一致。 重试：仅在确认原请求未生效且接口允许时重试。 |
| 400 Legacy flat | 400invalid address_kind | List Address BookGET /v1/ramp/wallet_addressoperationId: list-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400query wallet addresses failed | List Address BookGET /v1/ramp/wallet_addressoperationId: list-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400whitelist address not found | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 核对资源 核对资源 ID，并确认资源属于当前账户且仍然可用。 查看详情出现原因：指定资源不存在、不属于当前账户或当前不可用。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400load address failed | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400check label failed | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400label already used | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400invalid is_whitelist | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400update failed | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400travel rule already set, cannot edit | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400update travel rule failed | Update Address BookPOST /v1/ramp/wallet_address/updateoperationId: update-address-book | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400source_address and network are required | Submit Deposit Sender Travel RulePOST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-sender | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400metadata is required | Submit Deposit Sender Travel RulePOST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-sender | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400submit failed | Submit Deposit Sender Travel RulePOST /v1/ramp/wallet_address/deposit-senderoperationId: create-deposit-sender | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |
| 400 Legacy flat | 400for non-stablecoin swaps, amount must be on the crypto side and a multiple of the OKX contract step | Create QuotePOST /v1/ramp/conversion/quoteoperationId: create-quote | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400crypto service is not active for this account | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversionCreate Withdraw POST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400destination asset is not activated for this account | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400destination asset is inactive for this account | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400another swap for this account is in progress | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400buy/sell supports stablecoins only; use swap for non-stablecoins | Create ConversionPOST /v1/ramp/conversionoperationId: create-conversion | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400no balance account for this asset | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查余额 确认可用余额和币种满足本次操作要求。 查看详情出现原因：当前可用余额、币种或余额账户不满足操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400asset is required for a universal whitelist address | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 修改请求 按 API Reference 检查字段格式、必填项和允许值后修正请求。 查看详情出现原因：请求缺少必填信息，或字段格式、取值不符合接口要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400asset does not match the whitelisted address | Create WithdrawPOST /v1/ramp/withdrawoperationId: create-withdraw | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 400 Legacy flat | 400Invalid idempotency key. | 适用于 7 个公开接口 | 避免重复提交 先查询原请求或资源状态，不要立即创建重复请求。 查看详情出现原因：相同请求或资源已经存在，或幂等键与原请求不一致。 重试：仅在确认原请求未生效且接口允许时重试。 |
| 400 Legacy flat | 400The idempotency key provided failed authentication, please check client id. | 适用于 7 个公开接口 | 避免重复提交 先查询原请求或资源状态，不要立即创建重复请求。 查看详情出现原因：相同请求或资源已经存在，或幂等键与原请求不一致。 重试：仅在确认原请求未生效且接口允许时重试。 |
| 400 Legacy flat | 400Idempotent request endpoint does not match the initial one. | 适用于 7 个公开接口 | 避免重复提交 先查询原请求或资源状态，不要立即创建重复请求。 查看详情出现原因：相同请求或资源已经存在，或幂等键与原请求不一致。 重试：仅在确认原请求未生效且接口允许时重试。 |
| 400 Legacy flat | 1005Idempotency key reused with different request payload | 适用于 7 个公开接口 | 避免重复提交 先查询原请求或资源状态，不要立即创建重复请求。 查看详情出现原因：相同请求或资源已经存在，或幂等键与原请求不一致。 重试：仅在确认原请求未生效且接口允许时重试。 |
| 409 Legacy flat | 409Request is processing, please try again later. | 适用于 7 个公开接口 | 检查请求 根据 message 核对请求参数、资源 ID 和资源当前状态。 查看详情出现原因：请求参数、资源状态或账户配置不满足当前操作要求。 重试：修正请求或资源状态后再重试。 |
| 500 Other envelope | ""An internal error occurred, please try again | 适用于 7 个公开接口 | 稍后重试 保留本次错误信息，稍后使用相同业务参数重试一次。 查看详情出现原因：请求未能完成，且客户端无法仅通过修改参数确定恢复方式。 重试：短暂等待后重试一次；若持续失败，请联系 UQPAY。 何时联系 UQPAY：短暂等待并重试后仍持续返回相同错误。 请额外提供：x-response-id、请求时间、HTTP method 和 path、完整错误响应。 |