错误码

以下为商户 OpenAPI 的错误码及说明。message 可因商户语言或具体原因不同而变化；程序按错误码判断。

错误码	说明
100403	无权限；建单 IP 不在所配置白名单内可触发。不是“未开启代付”的专用码。
100404	未找到请求的资源。
100409	请求冲突；同商户订单号已有结束订单，或金额／收款方等关键参数不同。
100422	请求参数校验失败；核对必填项、类型及格式，也可能命中收款方限制。
100429	超过请求额度；HTTP 429，按 Retry-After 等待。
100500	未预期的系统异常；保留 request_id，请求结果不能仅凭此码确定。
100503	操作失败；提交 UTR 验证失败时可能返回。
201005	商户账户不存在。
202000	开放接口系统错误。
202001	缺少 sign。
202002	缺少 app_key。
202003	app_key 无效，或与 tenant_id 不属于同一商户。
202004	签名不正确。
202005	缺少 timestamp。
202006	timestamp 已过期。
202007	应用已停用。
203001	没有可用的代收方式。
203002	没有匹配的收款账户。
203003	代收金额调整配置异常。
203004	金额不满足调整配置的最小金额。
203005	订单创建失败；代付可用余额加信用额度不足以覆盖本金及手续费时，也使用此码。如结果不明，先核对原订单。
203006	在当前商户及查询条件下未找到可返回的订单；不是付款状态。
203007	订单当前状态不支持该操作。
203008	付款验证失败。
203011	商户未开启代收。
203012	商户未开启代付。
203013	没有可用的 Deeplink 代收方式。
203014	代收金额超出商户单笔范围。
203015	代付金额超出商户单笔范围。
203016	没有可用的代付方式。
204001	支付参考记录不存在。

常见错误说明

• 202003：应用标识无效或商户不匹配，不是限速。
• 203005：订单创建失败；也用于代付余额及信用额度不足以覆盖本金和手续费，不能仅按码定位唯一原因。
• 100429：限速，HTTP 429，与参数错误 100422 区分。

失败原因在哪里？

建单失败时查看顶层 code 和 message。当前 query_order 与普通结果回调没有统一的详细失败原因字段，不要依赖未返回的 error_message。需要具体原因时，提供商户订单号、平台订单号或 request_id 核对。