Appearance
错误码表
响应体格式:{ "code": <int>, "msg": "<string>", "data": {...}, "sign": "<可选>" }。code = 0 表示成功。
出处:jeepay-core/com/jeequan/jeepay/core/constants/ApiCodeEnum.java。
| code | 常量 | 含义 |
|---|---|---|
| 0 | SUCCESS | 请求成功 |
| 9999 | CUSTOM_FAIL | 自定义业务异常(如"商户或商户应用不存在"、"验签失败"等,msg 描述具体原因) |
| 10 | SYSTEM_ERROR | 系统异常 |
| 11 | PARAMS_ERROR | 参数有误 |
| 12 | DB_ERROR | 数据库服务异常 |
| 5000 | SYS_OPERATION_FAIL_CREATE | 新增失败 |
| 5001 | SYS_OPERATION_FAIL_DELETE | 删除失败 |
| 5002 | SYS_OPERATION_FAIL_UPDATE | 修改失败 |
| 5003 | SYS_OPERATION_FAIL_SELETE | 记录不存在 |
| 5004 | SYS_OPERATION_FAIL_SELETE(权限) | 权限错误,当前用户不支持此操作(SYS_PERMISSION_ERROR) |
常见业务错误对照
| msg | 原因与处理 |
|---|---|
| 验签失败 | sign 计算错误:检查密钥、剔除 sign 字段、过滤空值、key 升序排序是否与文档一致 |
| 商户或商户应用不存在 | mchNo / appId 有误,或商户/应用状态已停用 |
| 参数 appId 与商户号不匹配 | appId 不属于该 mchNo |
| 商户信息不存在或商户状态不可用 | 商户被停用,联系平台 |
| 签名类型不能为空 | 缺少 signType 字段,固定传 MD5 |
| 版本号不能为空 / 时间戳不能为空 | 缺少 version / reqTime 公共字段 |
| HTTP 401(运营/商户平台 API) | 缺少或过期的 iToken 登录凭证 |
状态码速查
| 业务 | 字段 | 取值 |
|---|---|---|
| 支付订单 | state | 0-订单生成,1-支付中,2-支付成功,3-支付失败,4-已撤销,5-已退款,6-订单关闭 |
| 退款订单 | state | 0-订单生成,1-退款中,2-退款成功,3-退款失败,4-退款任务关闭 |
| 转账订单 | state | 0-订单生成,1-转账中,2-转账成功,3-转账失败,4-订单关闭 |
| 分账记录 | state | 0-待分账,1-分账成功,2-分账失败 |
| 分账模式 | divisionMode | 0-不允许分账,1-自动分账,2-手动分账 |