异常处理

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

返回非 200 HTTP Code

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

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

返回 200 HTTP 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	❌

错误枚举(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不能为空
...	...