错误码字典

本错误字典是一份简明指南，帮助您快速理解并解决错误。以下是我们错误信息的结构说明，旨在让排查过程尽可能简便：

发生了什么故障： 我们将准确告知您流程或组件中哪个部分出现了问题。

故障原因： 我们将解释错误背后的原因，例如输入了错误数据、触达了系统限制，或遭遇了连接问题。

如何修正： 我们提供清晰的步骤或解决方案，帮助您解决问题并恢复正常运行。
本指南旨在帮助您持续推进工作，不因技术故障而受阻。让我们深入了解，保持系统顺畅运行！

错误格式

错误将以 HTTP 409 状态码返回，响应体如下：

{
  "code":"G001"
  "description":"General error. Please try again."
}

错误目录

类别	错误码	描述
General	`G001`	通用错误，请重试。
General	`G002`	由于添加了无效参数，处理失败。请移除 $parameter$ 后重试。
General	`G003`	所选页面不存在。您请求的页面超出了列表范围，请提供一个在列表大小范围内的 page_number。
General	`G004`	部分参数格式不正确。 $paramenter$ 应为 $type$ 类型，请更正格式后重试。
General	`G005`	您尝试使用的功能对该客户尚未激活，请联系您的客户经理（Key Account Manager）获取更多信息。
General	`G006`	由于超出参数数量限制，查询失败。最大允许数量为 60，而本次请求包含 ' $n$ ' 个。请检查请求后重试。

类别	错误码	描述
Authentication	`AU001`	由于请求中未包含 `user_id`，认证流程失败。请在请求中添加 `user_id` 以完成正确认证。
Authentication	`AU002`	由于请求中未包含 `secret`，认证流程失败。请在请求中添加 `secret` 以完成正确认证。
Authentication	`AU003`	由于请求中发现额外字段 $field$ ，认证流程失败。请移除 $field$ 字段以完成正确认证。
Authentication	`AU004`	由于请求的 JSON 体格式错误，认证流程失败。请验证所发送的 JSON 结构后重试。

类别	错误码	描述
Accounts	`ACC000`	请验证请求后正确重新发送。
Accounts	`ACC001`	账户连接失败。所提供的元数据不符合提供商 $p ro v i d e d i d$ 及操作 $a c t i o n$ 的要求，请验证请求后正确重新发送。
Accounts	`ACC002`	账户连接失败。给定的 $p ro v i d e d i d$ 不正确，请验证请求后正确重新发送。
Accounts	`ACC003`	账户连接失败。所提供的 $a cco u n t_{t} y p e$ 不正确，请确保账户类型有效且存在。
Accounts	`ACC004`	账户连接失败。元数据中缺少 $missing_parameter$ ，请提供有效的 $missing_parameter$ 。
Accounts	`ACC005`	账户连接失败。 $action$ 不正确，请提供有效的 $action$ 。
Accounts	`ACC006`	账户连接失败。所提供的账户号码无效。该账户应符合提供商 $provider_id$ 的格式，即 $#_of_digits$ 位数字。（🚧 建设中）
Accounts	`ACC007`	账户连接失败。所提供的账户号码无效。该账户应符合 $p ro v i d e r_{i} d$ 格式，且至少包含 $#_of_digits$ 位数字。（🚧 建设中）
Accounts	`ACC008`	账户连接失败。提供商 $provider_id$ 不允许使用身份标识类型 $account_holder_id_type$ ，请使用允许的值后重试。（🚧 建设中）
Accounts	`ACC009`	账户连接失败。账户持有人身份标识类型 $account_holder_id_type$ 应包含 $#_of_digits$ 位数字且不含特殊字符。（🚧 建设中）
Accounts	`ACC010`	账户连接失败。别名最多不能超过 256 个字符。（🚧 建设中）
Accounts	`ACC011`	账户创建失败。给定的主账户 $primary_account$ 不存在或无效，请验证账户类型是否有效且存在。
Accounts	`ACC012`	账户创建失败。主账户 $primary_account$ 的地理区域与 Cobre Balance 的地理区域不匹配，请核实后重试。
Accounts	`ACC013`	账户创建失败。给定的主账户 $p r ima r y_{a} cco u n t$ 无效，因为它已是一个子账户，请关联其他账户后重试。

类别	错误码	描述
Move Money	`MM000`	资金划转请求失败。
Move Money	`MM001`	由于请求中未添加 $parameter$ ，资金划转请求失败。请在请求中添加 $parameter$ 参数以正确发起资金划转操作。
Move Money	`MM002`	资金划转请求失败。给定的 $destination_id$ 无效，请确保 destination_id 有效且存在。
Move Money	`MM005`	资金划转请求失败。输入金额不能为负数或小于零，请输入大于或等于 1 的金额以正确处理资金划转。
Move Money	`MM006`	资金划转请求失败。CLABE 类型的目标对象格式不正确。CLABE 类型的目标对象应包含以下参数：Account_type、account_number、counterparty_fullname、counterparty_id_type、counterparty_id_number。
Move Money	`MM007`	资金划转请求失败。 $TYPE_OF_CP$ 类型的目标对象格式不正确。账户号码应符合 $TYPE_OF_CP$ 格式，即 $#_of_digits$ 位数字。
Move Money	`MM008`	资金划转请求失败。来源参数与目标参数不能相同，请使用不同的来源和目标参数重新发起资金划转请求。
Move Money	`MM009`	资金划转请求失败。所提供的幂等性参数未达到所需长度，请提供长度为 9 个或以上字符的幂等性值。
Move Money	`MM010`	资金划转请求失败。所提供的来源与目标应为有效组合，请添加有效的来源与目标组合。
Move Money	`MM011`	资金划转请求失败。元数据中提供的描述超出了字段大小限制，请输入有效的描述。
Move Money	`MM012`	资金划转请求失败。所提供的 destination_id 无效或不存在，请添加有效的目标地址。
Move Money	`MM013`	资金划转请求失败。元数据中提供的备注超出了字段大小限制，请输入有效的备注。
Move Money	`MM015`	资金划转请求失败。所提供的 URL 无效，请确保链接以 "https://" 或 "http://" 开头。
Move Money	`MM016`	资金划转请求失败。一个或多个 R2P 方式不正确或缺失，请确保 R2P 方式有效后重试。
Move Money	`MM017`	资金划转请求失败。所提供的 expiration_date 无效，请确保 expiration_date 格式正确（YYYY-MM-DDTHH:MM），设置为未来日期，且距请求时间不超过 90 天。
Move Money	`MM018`	资金划转请求失败。所提供的 fx_quote 已过期。
Move Money	`MM019`	资金划转请求失败。所提供的 pse_bank_code 无效，请确保 pse_bank_code 有效且存在。
Move Money	`MM020`	资金划转请求失败。创建 r2p_link 时出现问题，请重试。
Move Money	`MM021`	资金划转请求失败。给定的 $source_id$ 无效，请确保 source_id 有效且存在。
Move Money	`MM022`	资金划转请求失败。 $account_id $ 无权向 $counterparty_id$ 发起扣款，请确保注册已完成后重试。
Move Money	`MM023`	资金划转请求失败。所提供的 $category$ 无效，请输入有效的类别后重试。
Move Money	`MM024`	资金划转请求失败。 $secondary_counterparty$ 无效，请提供有效的 secondary_counterparty 后重试。
Move Money	`MM025`	资金划转请求失败。
Move Money	`MM026`	资金划转请求失败。 $description_to_payer/payee$ 超过 256 个字符，请调整字段长度后重试。
Move Money	`MM027`	资金划转请求失败。金额超过该支付通道的最大允许限额，请提供有效金额后重试。
Move Money	`MM028`	资金划转请求失败。所提供的 $token$ 无效，请输入有效的 token 后重试。

类别	错误码	描述
Subscriptions	`SUB000`	处理订阅时发生错误，请重试。
Subscriptions	`SUB001`	处理订阅时发生错误。所提供的一个或多个事件无效，请提供有效的事件列表并重试。
Subscriptions	`SUB002`	处理订阅时发生错误。所提供的描述超过了 256 个字符的最大长度，请提供有效的描述并重试。
Subscriptions	`SUB003`	处理订阅时发生错误。所提供的请求对象缺少 $parameter$ 字段，请提供所有必填参数以正确创建订阅。
Subscriptions	`SUB004`	订阅创建失败。所提供的 URL 格式不正确，请检查所提供的 URL 并重试。
Subscriptions	`SUB005`	订阅创建失败。event_signature_key 的长度超过了

类别	错误码	描述
Reports	`REP000`	报告处理失败，请重试。
Reports	`REP001`	处理报告的请求失败。请在请求体中添加 $parameter$ 参数。
Reports	`REP002`	生成下载链接的请求失败。请求体中存在无效的报告 ID，请修正报告数组并重试。
Reports	`REP003`	生成报告的请求失败。所请求的资源与类型组合无效，请检查请求并重试。
Reports	`REP004`	生成报告的请求失败。未找到账户 $parameter$ ，请检查请求并重试。
Reports	`REP005`	生成报告的请求失败。提供方 ID $parameter$ 与账户类型 $parameter$ 的组合不受支持，请检查请求并重试。
Reports	`REP006`	生成报告的请求失败。账户 ID $parameter$ 的 $parameter$ 字段缺失或无效，而该字段为时区计算所必需，请检查账户信息并重试。

类别	错误码	描述
Counterparties	`CP000`	无法创建交易对手方，请重试。
Counterparties	`CP001`	交易对手方创建失败。所提供的交易对手方类型无效，请检查交易对手方类型并重试。
Counterparties	`CP002`	交易对手方创建失败。为类型 $type$ 所提供的一个或多个字段无效或缺失，请确保所有必填字段均已填写且有效。
Counterparties	`CP003`	交易对手方创建失败。所提供的账户号码无效。账户号码应符合 $TYPE_OF_CP$ 格式，长度为 $#_of_digits$ 位。
Counterparties	`CP004`	交易对手方创建失败。所提供的卡号无效。卡号应符合 $TYPE_OF_CP$ 格式，长度为 $#_of_digits$ 位。
Counterparties	`CP005`	交易对手方创建失败。 $TYPE_OF_CP$ 交易对手方类型不支持身份标识 $CP_ID_TYPE$ ，请使用允许的值并重试。
Counterparties	`CP006`	交易对手方创建失败。counterparty_fullname 字段不允许包含特殊字符，请确保 `counterparty_fullname` 仅包含有效字符并重试。
Counterparties	`CP007`	交易对手方创建失败。所提供的 $CP_BENEFICIARY_INSTITUTION$ 无效，请确保收款机构在允许范围内并重试。
Counterparties	`CP008`	交易对手方创建失败。counterparty_id_number 字段不允许包含特殊字符，请提供有效的 counterparty_id_number 并重试。
Counterparties	`CP009`	交易对手方创建失败。 $CP_ID_TYPE$ 的 counterparty_id_number 应为 9 或 10 位数字，请核实后重试。
Counterparties	`CP010`	交易对手方创建失败。所提供的电子邮件格式不被允许，请提供有效的电子邮件地址并重试。
Counterparties	`CP011`	交易对手方创建失败。phone_number 格式不正确，请确保 phone_number 以 '+' 开头，后跟国家代码和数字，然后重试。
Counterparties	`CP012`	交易对手方创建失败。counterparty_id_number 必须为纯数字，请确保 counterparty_id_number 仅包含数字并重试。
Counterparties	`CP013`	交易对手方创建失败。counterparty_date_of_birth 应采用 YYYYMMDD 格式，请确保 counterparty_date_of_birth 格式正确并重试。
Counterparties	`CP014`	交易对手方创建失败。key_value 不符合任何密钥类型的特征，请输入有效的密钥并重试。
Counterparties	`CP015`	交易对手方创建失败。 $field$ 字段必须为字符串类型，请确保所有必填字段均已填写且有效。

类别	错误码	描述
MM Approval	`MMA000`	资金流动审批决策失败，请重试。
MM Approval	`MMA001`	无法创建资金流动审批决策。一个或多个字段缺失，请确保所有必填字段均已填写且有效。
MM Approval	`MMA002`	无法创建资金流动审批决策。所提供的决策不被允许，请提供有效的决策并重试。
MM Approval	`MMA003`	无法创建资金流动审批决策。所提供的描述超过了 256 个字符的最大长度，请提供有效的描述并重试。
MM Approval	`MMA004`	无法创建资金流动审批决策。该资金流动已存在一条决策记录。

类别	错误码	描述
Bulk MM	`BMM000`	无法创建批量资金流动流程，请重试。

类别	错误码	描述
FX quotes	`QU000`	无法创建所请求的报价，请重试。
FX quotes	`QU001`	无法创建报价。所请求的货币对无效，请确保货币对有效且存在。
FX quotes	`QU002`	报价创建失败。请求体中缺少 $missing_parameter$ 字段，请提供有效的 $missing_parameter$ 。
FX quotes	`QU003`	无法创建报价。市场当前已休市，请在正常交易时段内重试。
FX quotes	`QU004`	无法创建报价。所请求的货币对尚未配置，请联系您的客户经理申请开通该货币对。
FX quotes	`QU005`	已达到当日限额。请以不超过限额的金额重新发起询价。
FX quotes	`QU006`	无法创建报价。所请求的货币对未配置非交易时段操作权限，请联系您的客户经理申请开通。

类别	错误码	描述
Cross Border MM	`CBMM000`	无法创建跨境资金流动，请重试。
Cross Border MM	`CBMM001`	无法创建跨境资金流动。 $quote_id$ 不存在或已过期，请确保报价 ID 有效并重试。
Cross Border MM	`CBMM002`	跨境资金流动请求失败，因为请求中未包含 $parameter$ 字段。请添加 $parameter$ 参数以正确发起资金流动操作。
Cross Border MM	`CBMM003`	跨境资金流动请求失败。所提供的幂等性参数长度不符合要求，请提供长度不少于 9 个字符的幂等性值。
Cross Border MM	`CBMM004`	跨境资金流动请求失败。元数据中所提供的描述超过了字段的最大长度，请填写有效的描述。
Cross Border MM	`CBMM005`	跨境资金流动请求失败。所提供的 $destination_id$ 无效或不存在，请填写有效的目标地址。
Cross Border MM	`CBMM007`	已达到当日限额。请以不超过限额的金额重新发起资金流动。

类别	错误码	描述
Money Movement Scheduler	`MMS000`	处理资金流动调度器时发生错误，请重试。
Money Movement Scheduler	`MMS001`	无法创建资金流动调度器。请求体中缺少 $missing_parameter$ 参数，请提供有效的 $missing_parameter$ 。
Money Movement Scheduler	`MMS002`	无法创建资金流动调度器。调度模式 $schedule_pattern$ 不正确，请确保 cron 表达式定义正确。
Money Movement Scheduler	`MMS003`	无法创建资金流动调度器。一个或多个账户信息有误，请确保所提供的账户有效且存在。
Money Movement Scheduler	`MMS004`	无法创建资金流动调度器。一个或多个声明的账户不是 Saldo Cobre 账户，请确保所有提供的账户均为 Saldo Cobre 账户。
Money Movement Scheduler	`MMS005`	无法创建资金流动调度器。交易对手方 ID $counterparty_id$ 无效，请确保所声明的交易对手方有效且存在。
Money Movement Scheduler	`MMS006`	无法创建资金流动调度器。所提供的描述超过最大长度 50 个字符，请提供有效的描述后重试。
Money Movement Scheduler	`MMS007`	无法创建资金流动调度器。输入的金额不能为负数，请输入大于或等于 0 的金额以正确处理资金流动调度器。
Money Movement Scheduler	`MMS008`	无法创建资金流动调度器。所提供的别名超过最大长度 256 个字符，请提供有效的别名后重试。
Money Movement Scheduler	`MMS009`	无法创建资金流动调度器。输入的金额不能为 0 或负数，请输入大于 0 的金额以正确处理资金流动调度器。

类别	错误码	描述
Cross Border MM	`CBMM000`	无法创建跨境资金转移，请重试。
Cross Border MM	`CBMM001`	无法创建跨境资金转移。 $quote_id$ 不存在或已过期，请确保报价 ID 有效后重试。
Cross Border MM	`CBMM002`	跨境资金转移请求失败，请求中未添加 $parameter$ 参数。请在请求中添加 $parameter$ 参数以正确发起资金转移操作。
Cross Border MM	`CBMM003`	跨境资金转移请求失败。所提供的幂等性参数长度不符合要求，请提供长度不少于 9 个字符的幂等性值。
Cross Border MM	`CBMM004`	跨境资金转移请求失败。元数据中提供的描述超过字段最大长度，请提供有效的描述。
Cross Border MM	`CBMM005`	跨境资金转移请求失败。所提供的 $destination_id$ 无效或不存在，请添加有效的目标信息。
Cross Border MM	`CBMM006`	跨境资金转移请求失败。所提供的 $source_id$ 无效或不存在，请添加有效的目标信息。
Cross Border MM	`CBMM007`	已达到每日限额，请以不超过限额的金额重试资金转移。

类别	错误码	描述
BMM Decision	`BMMD000`	无法创建批量审批决策，请重试。
BMM Decision	`BMMD001`	批量资金转移审批决策失败。请求中缺少 $parameter$ 参数，请添加 $parameter$ 以正确发起批量资金转移审批决策。
BMM Decision	`BMMD002`	批量资金转移审批决策失败。所提供的决策不被允许，请提供有效的决策后重试。
BMM Decision	`BMMD003`	无法创建批量资金转移审批决策。所提供的描述超过最大长度 256 个字符，请提供有效的描述后重试。
BMM Decision	`BMMD004`	无法创建批量资金转移审批决策。该批量资金转移已存在审批决策。
BMM Decision	`BMMD005`	无法创建批量资金转移审批决策。资金转移仍在处理中，请等待所有资金转移创建完成后重试。
BMM Decision	`BMMD006`	无法创建批量资金转移审批决策。`bulk_money_movement_id` 未提交审批，不符合批量审批条件。请确保所提供的批量资金转移允许进行批量审批。

类别	错误码	描述
Direct Debit Registration	`DDR000`	无法创建账户注册，请稍后重试。
Direct Debit Registration	`DDR001`	账户注册请求失败。目标账户 $account_id$ 无效，请验证所注册的目标账户是否适用于该地区并确认其存在。
Direct Debit Registration	`DDR002`	账户注册请求失败。交易对手方 $counterparty$ 不被允许进行账户注册，请验证该交易对手方的所在地区及类型是否符合账户注册的必要条件。
Direct Debit Registration	`DDR003`	账户注册请求失败。所提供的描述超过最大长度，请提供有效的描述后重试。

类别	错误码	描述
Checkout	`CHK001`	无法创建 Checkout。所提供的 `external_id` 超过 256 个字符，请提供有效的 `external_id` 后重试。
Checkout	`CHK002`	无法创建 Checkout。所提供的交易对手方 $source_id$ 无效，请关联类型为 r2p 的 `source_id` 后重试。
Checkout	`CHK003`	无法创建 Checkout。所提供的 `alias` 超过 256 个字符，请提供有效的 `alias` 后重试。
Checkout	`CHK004`	`checkout_item` 字段包含特殊字符，请移除该字段中的特殊字符后重试。
Checkout	`CHK005`	无法创建 Checkout。所提供的 $destination_id$ 不存在，请关联有效的 `destination_id` 后重试。
Checkout	`CHK006`	无法创建 Checkout。所提供的 $checkout_rails$ 无效或不存在，请关联有效的 `checkout_rails` 后重试。
Checkout	`CHK007`	无法创建 Checkout。请求体中缺少 $missing_parameter$ 参数，请提供有效的 $missing_parameter$ 后重试。
Checkout	`CHK008`	无法创建 Checkout。所提供的 `checkout_header` 超过 30 个字符，请提供有效的 `checkout_header` 后重试。
Checkout	`CHK009`	无法创建 Checkout。所提供的 `checkout_item` 超过 256 个字符，请提供有效的 `checkout_item` 后重试。
Checkout	`CHK010`	无法创建 Checkout。所提供的 $amount$ 无效，请提供有效的 $amount$ 后重试。
Checkout	`CHK011`	无法创建 Checkout。所提供的 $valid_until$ 无效，请确保 `valid_until` 格式正确（YYYY-MM-DDTHH:MM:SSZ），且设置为请求时间之后的未来日期。
Checkout	`CHK012`	无法创建 Checkout。所提供的 $money_movement_intent_limit$ 无效，请提供有效的 $money_movement_intent_limit$ 后重试。
Checkout	`CHK013`	无法创建 Checkout。所提供的 `description_to_payee` 超过 40 个字符，请提供有效的 `description_to_payee` 后重试。
类别	错误码	描述
-----------	------	-------------
Evidence Request	`EVR001`	evidence_request 失败。所请求的链接数量超出允许上限，请减少链接数量后重试。
Evidence Request	`EVR002`	evidence_request 失败。所提交的文件类型值未在本次 event_request 中被请求，请提供有效的文件类型值。
Evidence Request	`EVR003`	evidence_request 因请求无效而失败，请核验相关参数后重试。
Evidence Request	`EVR004`	evidence_request 失败。当前已有另一个针对相同 reference_id 的 evidence_request 正在处理中，请等待当前请求完成后再重试。
Evidence Request	`EVR005`	evidence_request 失败。所提供的过期值无效，请确保其为正整数且表示未来的时间段。
Evidence Request	`EVR006`	evidence_request 失败。请求中未识别到字段 evidence_document，请添加有效的 evidence_document 参数以成功创建请求。
Evidence Request	`EVR007`	evidence_request 失败。请求中未识别到字段 evidence_information，请添加有效的 evidence_information 参数以成功创建请求。
Evidence Request	`EVR008`	evidence_request 失败。所提供的数据点响应格式无效，不符合文档中定义的 schema，请修正响应内容后重试。
Evidence Request	`EVR009`	evidence_request 失败。请求中未指定任何信息，请在 evidence_information 或 evidence_document 中添加有效参数。
Evidence Request	`EVR010`	evidence_request 失败。未指定 reference_id，请添加有效的 reference_id 以创建请求。
Evidence Request	`EVR011`	evidence_request 失败。未针对指定的 evidence_document 上传任何文件，请上传有效文件。
Evidence Request	`EVR012`	evidence_request 失败。未找到附加上下文字段，请提供有效的上下文字段或将其留空。
Evidence Request	`EVR013`	evidence_request 失败。所提供的 evidence_id 与指定的 evidence_request_id 无关联，请提供与所提交的 evidence_request_id 关联的有效 evidence_id。
Evidence Request	`EVR014`	evidence_request 失败。该 evidence_request ID 已处于已完成状态。
Evidence Request	`EVR015`	evidence_request 失败。提交内容中存在重复的 evidence_id。
Evidence Request	`EVR016`	evidence_request 失败。证据提交内容中缺少 evi_id。
Evidence Request	`EVR017`	evidence_request 失败。context 字段至少需包含一条记录。

错误码字典

错误格式#

错误目录#

错误格式

错误目录