# 异常处理

当您调用PayKKa API时出现错误，可能有如下两种情况，

1. 返回非 `200` HTTP Code


> 这是标准的PayKKa响应，建议您根据对应的`ret_code`，`ret_msg`对请求内容进行检查



```json
{
    "ret_code": "010000",
    "ret_msg": "Invalid request"
}
```

1. 返回 `200` HTTP Code，并且响应体中包含更多业务异常详情


> 下面是以交易为例，该请求成功，但是返回了业务异常，并且业务异常以`error_code`，`error_description`为参数返回;
建议您对业务异常做一定处理以便给客户提供流畅的系统体验
注意: 不同处理API的业务参数并不完全一致



```json
{
    "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 | ❌ |


## 错误枚举(ret_code)

| 枚举 | 含义 |
|  --- | --- |
| 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不能为空 |
| ... | ... |