当您调用PayKKa API时出现错误,可能有如下两种情况,
- 返回非
200HTTP Code
这是标准的PayKKa响应,建议您根据对应的
ret_code,ret_msg对请求内容进行检查
{
"ret_code": "010000",
"ret_msg": "Invalid request"
}- 返回
200HTTP Code,并且响应体中包含更多业务异常详情
下面是以交易为例,该请求成功,但是返回了业务异常,并且业务异常以
error_code,error_description为参数返回; 建议您对业务异常做一定处理以便给客户提供流畅的系统体验注意: 不同处理API的业务参数并不完全一致
{
"ret_code": "000000",
"ret_msg": "Success",
"data": {
"error_code": "2099",
"error_description": "Invalid Card",
"merchant_id": "18356675194960",
"trans_id": "T4329476032",
"order_id": "GW206194332333335",
"status": "FAILURE",
"amount": 322,
"currency": "HKD"
}
}| 参数名 | 含义描述 | 类型 | 必填 |
|---|---|---|---|
ret_code | 响应错误码 | String | ✅ |
ret_msg | 响应错误消息 | String | ✅ |
data | 响应业务数据,业务失败可能为空 | Object | ❌ |
| 枚举 | 含义 |
|---|---|
| 000000 | 请求成功 |
| 999999 | 系统异常 |
| 010000 | 无效的请求,参数错误 |
| 206001 | 无效的API版本 |
| 206002 | 签名不存在 |
| 206003 | 签名错误 |
| 206004 | 签名已过期 |
| 206005 | 商户不存在 |
| 206006 | 未配置商户公钥 |
| 206007 | 商户状态已禁用 |
| 206008 | 会员状态已禁用 |
| 206011 | 收银台不存在 |
| 206017 | PCI合规性不足 |
| 206020 | 卡信息解密失败 |
| 206021 | 卡加密信息已过期,请重试支付 |
| 206022 | 不支持此卡,请换卡支付 |
| 206024 | 订单不存在 |
| 210054 | 支付订单处理中,请勿重复支付 |
| 210001 | 支付方式不支持 |
| 210002 | shopperReference不能为空 |
| 210003 | shipping不能为空 |
| 210004 | MIT不能为空 |
| 210005 | MIT必须为true |
| 210006 | MIT必须为false |
| 210009 | 循环支付协议不存在 |
| 210010 | 循环支付协议未激活 |
| 210011 | returnUrl不能为空 |
| 210012 | browser不能为空 |
| 210013 | IP地址不能为空 |
| 210014 | token或卡信息不能为空 |
| 210015 | 电话或邮箱不能为空 |
| 210016 | tokenUsage不能为空 |
| 210017 | 卡信息不能为空 |
| 210018 | 卡有效期年份不能为空 |
| 210019 | 卡有效期月份不能为空 |
| 210020 | CVV不能为空 |
| 210021 | 支付信息错误 |
| 210022 | 卡Token未识别 |
| 210023 | 卡Token未激活 |
| 210024 | 卡Token不支持 |
| 210025 | 不支持此卡,请换卡支付 |
| 210026 | 银行卡非法 |
| 210027 | 商户不存在 |
| 210028 | 商户已禁用 |
| 210029 | 商户不允许交易 |
| 210030 | 商户不允许退款 |
| 210031 | 商户币种不支持 |
| 210032 | 商户支付类型不支持 |
| 210033 | 商户支付方式不支持 |
| 210037 | 退款币种与原交易币种不一致 |
| 210038 | 该交易订单不允许退款 |
| 210039 | 交易已完成,不允许重复提交 |
| 210040 | 退款已完成,不允许重复提交 |
| 210042 | 渠道错误 |
| 210043 | 订单号和交易ID不可同时为空 |
| 210044 | 订单不存在 |
| 210045 | 过期时间非法 |
| 210047 | 退款金额不能大于可退款金额 |
| 210048 | 多次提交数据不一致 |
| 210049 | 收银台已完成,不允许重复提交 |
| 210050 | 该订单当前状态不允许修改 |
| 210051 | 订单参数非法 |
| 210052 | 收银台不存在 |
| 210054 | 支付订单处理中,请勿重复支付 |
| 210055 | 无可用路由 |
| 210056 | 电话不为空时区号不能为空 |
| 210057 | 账单国家不能为空 |
| 210058 | 交易订单不允许关闭 |
| 210059 | 名字和姓氏不能为空 |
| 210060 | 地址不能为空 |
| 210061 | 城市不能为空 |
| 210062 | 该交易订单不允许请款 |
| 210063 | 该交易订单不允许撤销 |
| 210064 | 请款失败 |
| 210065 | 撤销失败 |
| 210066 | 请款金额不能超过可请款金额 |
| 210067 | 请款币种与原交易币种不一致 |
| 210068 | tokenAuthentication不能为空 |
| ... | ... |