返回码

以下为本公共版文档涉及的常见业务错误码，实际返回以服务端为准。

普通业务错误返回 JSON：code、message、data、requestId。无效 Key、签名、时间戳、nonce 或安全准入拒绝可能返回 HTTP 401 / 403 和空正文，不保证有业务错误码。所有语言先检查 HTTP 状态及正文是否为空，再解析 JSON；message 可能随语言变化，不作为判断条件。

下表中的鉴权错误码用于排查含义，不表示对外安全拒绝一定返回这些字段。HTTP 429 按限流处理；HTTP 5xx 或网络超时先查询订单状态，避免重复付款。

返回码说明
10001请求参数不合法。
20005API Key 无效。
20011请求签名无效。
20012签名时间戳超出允许窗口。
20016nonce 已被使用，请勿重放请求。
20020请求过于频繁。
31001链不支持。
31002代币不支持。
31003链和代币不匹配。
40002独享钱包绑定不存在。
40105共享收款金额已被占用。
40108收款订单不存在。
51002当前商户状态或运行策略禁止该操作。
51004费用余额不足。
51008当前套餐不支持该功能。
53001付款来源地址不存在。
53002付款来源地址不可用。
53003币种可用余额不足。
54001代付订单不存在。
54003代付目标不能是商户自己的钱包地址。
54004商户订单号与已有代付订单冲突。