统一平台和客户端的通讯用状态码来表示含义,并附带着状态短语说明,状态码是一个4位数整数,与HTTP状态码有类似之处,但请注意这并非HTTP状态码:
1开始的状态码系统暂时保留使用
2开始的状态码表示业务正常
3开始的状态码系统暂时保留使用
4开始的状态码表示业务出现问题
5开始的状态码表示网络或系统故障
详细状态码及其含义如下:
状态码(code值) | 消息(msg值) | 说明 |
---|---|---|
2000 | ok | 操作成功,不一定指业务成功 |
4000 | 未知业务错误 | 客户端酌情处理 |
4001 | 参数错误 | 检查参数再试 |
4002 | 签名验证错误 | 检查密码和签名算法 |
4003 | 订单已付款,请勿重复提交 | |
4004 | 订单已退款或处于退款中,再次付款须另外下单 | |
4005 | 订单不存在 | 检查参数是否传递错误 |
4006 | 申请退款的订单尚未付款 | |
4007 | 申请退款的订单不允许退款 | 可能的原因是已提现或余额不足 |
4008 | 订单退款申请已超时 | 退款申请时,已经超过了最大允许退款的时间 |
4009 | refund_number:退款单号缺失 | 忽略退款单号时,退款金额必须为订单金额 |
4010 | 单笔订单退款申请次数超限 | 尽量不要分多次退款,单笔订单最大退款次数见api说明 |
4011 | 订单退款金额超过付款金额 | |
5000 | 不固定(泛指所有网络或服务器错误,详细错误以值表示) | 检查网络是否连通,或系统是否异常 |