代付通用规则
本地付款
代付通用规则
本页汇总 PayCools 本地付款（代付）的通用规则。目前包含交易失败的错误码与接口的 API 响应码；后续更多通用的逻辑、参数与定义等规则也会持续沉淀在本页。
1
错误码
交易失败时，接口返回与异步通知中会通过 failedCode 与 failedMessage 给出失败原因：
| failedCode | message | 介绍 |
|---|---|---|
| -10000 | Transaction Service Error | 交易服务异常 |
| -10001 | Transaction Exceed Limit | 交易金额超出限额 |
| -10002 | Transaction Params Error | 交易参数错误 |
| -10003 | Transaction Insufficient Balance | 商户余额不足 |
| -10004 | Transaction Channel Rejected | 渠道拒绝（渠道侧未受理） |
| -10005 | Transaction Destination Account Error | 收款账户信息有误 |
| -10006 | Transaction Network Reject | 网络异常 |
| -10007 | Transaction Channel Temporarily Close | 渠道临时关闭 |
| -10008 | Merchant Unavailable Error | 商户不可用 |
| -10009 | Recipient Account Blocked | 收款账户被冻结或受限 |
| -10010 | Channel Refund Failed | 渠道退款失败 |
验卡接口返回的失败码：
| failedCode | message | 介绍 |
|---|---|---|
| -20001 | Invalid parameters | 参数无效 |
| -20002 | Account abnormal | 账户异常 |
| -20003 | Balance Insufficient | 余额不足 |
| -20004 | Channel error | 渠道异常 |
| -20005 | System error | 系统异常 |
| -20006 | Unknown error | 未知错误 |
备注
错误码只描述失败原因；对应的排查方向与处理建议，请参考业务介绍 · 风控与失败处理。
2
API 响应码
接口实时返回的 code 与 message，用于标识本次请求的处理结果。以下为通用接口响应码，代付接口同样适用：
| code | message | 介绍 |
|---|---|---|
| 10000 | Success | 请求成功 |
| 21000 | Server error, Please try again later. | 服务异常，请稍后重试 |
| 21001 | Request sign error | 请求验签失败 |
| 21002 | Request param error | 请求参数错误 |
| 21003 | Request appId error | appId 错误 |
| 21004 | Merchant is unavailable | 商户不可用 |
| 21005 | Merchant channel is unavailable | 商户渠道不可用 |
| 21006 | Merchant transaction not found | 商户交易不存在 |
| 21007 | Duplicate merchant order id | 商户订单号重复 |
| 21008 | Request timestamp error | 请求时间戳错误 |
| 21009 | Request timestamp error | 请求时间戳错误 |
| 21010 | The amount exceeds the limit | 金额超出限额 |
| 21011 | Network error | 网络异常 |
| 21012 | Request bank code error | 银行编码错误 |
| 21013 | Request wallet code error | 钱包编码错误 |
| 21014 | Merchant balance insufficient | 商户余额不足 |
| 21015 | Duplicate idempotencyId | 幂等号重复 |
| 21016 | Merchant ip forbidden | 商户 IP 不在白名单内 |
| 21017 | Merchant has not opened this national service | 商户未开通该国家/地区服务 |
| 21018 | Request transfer code error | transferCode 错误 |
| 21019 | Request pay method code error | payMethodCode 错误 |
| 21020 | Too many requests, please retry later. | 请求过于频繁，请稍后重试 |
| 21021 | Transaction Amount Invalid | 交易金额无效 |
| 21022 | Transaction Volume Limit | 交易笔数超限 |
| 21023 | Transaction create failed | 交易创建失败 |
| 21024 | Invalid access token | 访问令牌无效 |
| 21025 | Not allowed to cancel | 不允许取消 |
| 21026 | Customer Balance not enough | 用户余额不足 |
| 21027 | Transaction creation exceeds limit | 交易创建超出限制 |
| 21028 | Transaction already paid or closed | 交易已支付或已关闭 |
| 21050 | Business unit not found | 业务单元不存在 |
| 21051 | Business unit does not belong to this merchant | 业务单元不属于该商户 |
| 21056 | Cross region business is not allowed for this merchant | 该商户不允许跨区域业务 |
备注
完整提示码与说明请参考 API通用提示码。