异常码
大约 2 分钟
说明
下列为网关/业务接口返回的业务异常码（示例字段名可能为 code、bizCode、errorCode 等，以具体接口响应为准）。对接时请根据码值做分支处理；
9999 表示业务成功，其余非成功码需按场景重试或纠正请求。
与 HTTP 状态码的关系
业务异常码通常出现在响应体 JSON 中；HTTP 层仍可能为 200。请以响应体内的异常码为准。
异常码一览
通用
| 异常码 | 英文说明 | 中文说明 | 处理建议 |
|---|---|---|---|
| 0000 | unknown exception | 未知异常 | 记录请求与响应全文后重试；若持续出现请联系技术支持 |
| 9999 | SUCCESS | 成功 | 按成功流程处理后续业务 |
基础数据 / 业务校验（0001–0010）
| 异常码 | 英文说明 | 中文说明 | 处理建议 |
|---|---|---|---|
| 0001 | Parameter exception! | 参数异常 | 对照接口文档检查必填项、类型、长度与格式 |
| 0002 | signature verification failed! | 签名校验失败 | 检查私钥、待签名字符串拼接规则、是否误含 sign 字段；参考 签名规则 |
| 0003 | mch no channel available! | 商户无可用渠道 | 可自行检查订单金额是否合规并联系运营/后台确认是否开启渠道 |
| 0004 | request duplicate! | 重复请求 | 使用幂等键或商户订单号去重；避免短时间重复提交 |
| 0005 | order abnormality! | 订单异常 | 查询订单详情与状态，勿盲目重试支付 |
| 0006 | the order does not exist! | 订单不存在 | 核对订单号是否正确、是否跨环境（沙箱/生产） |
| 0007 | Order payment method has been selected! | 订单支付方式已选定 | 不可再次换通道或重复选择；按当前方式继续或关闭订单后重新下单 |
| 0008 | Order status abnormal! | 订单状态异常 | 先查单确认状态；仅在允许的状态下发起当前操作 |
| 0009 | There is no payment method available for the order! | 订单无可用支付方式 | 检查商户/订单是否支持该支付方式与地区配置 |
| 0010 | the bank does not exist! | 银行不存在 | 核对银行编码或银行列表是否与文档一致 |
其他与风控（1000–1003）
| 异常码 | 英文说明 | 中文说明 | 处理建议 |
|---|---|---|---|
| 1000 | other exception! | 其他异常 | 记录上下文后重试或联系技术支持 |
| 1001 | ip whitelist exception! | IP 白名单异常 | 将出口 IP 加入商户后台白名单或联系配置 |
| 1002 | Insufficient balance! | 余额不足 | 充值或降低单笔金额后再试 |
| 1003 | amount exception | 金额异常 | 检查金额单位、最小/最大限额、小数位与币种规则 |
响应示例（仅供参考）
{
"code": "0002",
"message": "signature verification failed!",
"data": null
}
实际字段名以各接口文档为准。