状态码
请求成功或交易成功
| 返回码 | 说明 | 描述 |
|---|---|---|
| 000000 | 交易成功 | Transaction succeeded |
| 001000 | 请求成功 | Successful request |
| 002000 | 交易进行中 | Transaction processing |
配置校验异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 101000 | 商户已经被禁用 | Merchant is disabled |
| 101001 | 商户配置有误 | Error on merchant config |
| 101002 | 3DS 配置有误 | Error on 3DS config |
基础校验异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 102000 | 请求参数不合法 | Invalid or missing parameter |
| 102001 | 交易已取消 | transaction is cancelled |
| 102100 | 请求参数错误 | Request param error |
| 102101 | 请求参数错误 | Request param error |
| 102102 | 卡号格式不正确 | CardNumber invalid format |
| 102103 | 手机号格式不正确 | MobilePhone invalid format |
| 102104 | 支付令牌密文格式无效 | TokenCryptogram invalid format |
| 102105 | 持卡人姓名格式不正确 | CardInfo.holderName invalid format |
| 102106 | 卡号有效期格式不正确 | ExpiryDate invalid format |
| 102107 | CVC格式不正确 | CVC invalid format |
| 102108 | 手机号不正确，请输入正确的手机号并重试 | Invalid phone number, please input correct phone number and try again.. |
| 102109 | 手机号必传，请输入手机号 | Phone number is required, please input phone number |
| 102110 | 持卡人姓名错误，请输入卡上显示的姓名（通常仅限字母） | Wrong cardholder name，please enter the name as shown on your card, typically letters only. |
| 103000 | 无效授权参数 | Invalid authentication |
| 104000 | 签名不匹配 | Invalid signature |
| 105000 | 无效交易或交易已过期 | Invalid or expired transaction |
| 105001 | 重复交易 | Duplicate transaction |
| 105002 | 暂时无法通过，请稍后再试 | Cannot approve at this time, please try again later |
业务校验异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 106000 | 无效交易币种 | Invalid transaction currency |
| 106001 | 无效卡品牌 | Invalid card scheme |
| 106002 | 无效国家 | Invalid country |
| 106003 | 无效语种 | Invalid language |
| 107000 | 交易失败(重复交易) | Transaction failed (duplicated Transaction) |
| 107001 | 交易失败(交易不存在) | Transaction failed (transaction does not exist) |
| 107002 | 退款、预授权请款、预授权撤销失败(原交易不存在) | Transaction failed (original transaction does not exist) |
| 107003 | 退款、预授权请款、预授权撤销失败(原交易类型不符) | Transaction failed (original transaction transactionType not match) |
| 107004 | 退款、预授权请款、预授权撤销失败(原交易状态不符) | Transaction failed (original transaction transaction status not match) |
| 107005 | 退款、预授权请款、预授权撤销失败(原交易币种不符) | Transaction failed (original transaction transaction currency not match) |
| 107100 | 交易失败(用户取消) | Transaction failed (User Cancel) |
| 107101 | 交易失败(交易关单) | The transaction is closed before completing it |
| 108000 | 退款失败(可退款金额不足) | Refund failed (refund amount exceeded original transaction) |
| 108001 | 退款失败(超过退款时限) | Refund failed (out of the range) |
| 108002 | 退款失败(争议交易不可退款) | Refund failed (already chargeBacked) |
| 108003 | 退款失败(退款余额不足) | Refund failed (refund amount exceeded refund balance) |
| 109010 | 预授权请款失败(订单正在风控审核中) | Capture failed since order is under risk reviewing. |
| 109000 | 预授权请款失败(原交易已取消) | Capture failed(original transaction was reverse) |
| 109001 | 预授权请款失败(当前请款金额超过原交易金额) | Capture failed (capture amount exceeded original transaction) |
| 109002 | 预授权撤销失败(原交易已完成预授权) | Reverse failed (original transaction was captured) |
| 109003 | 预授权撤销失败(与原交易金额不一致) | Reverse failed (inconsistent with the original transaction amount) |
⻛控异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 200000 | 高⻛险拦截 | Transaction reject(high risk) |
| 201000 | 有欺诈嫌疑 | Transaction reject(suspected fraud) |
| 202000 | 过期卡 | Transaction reject(expired card) |
| 202001 | 挂失卡 | Transaction reject(stolen or lost card) |
| 203000 | ⻛控系统异常 | Error on the risk system |
银行返回异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 300000 | 交易被拒绝(无效卡) | Transaction declined (invalid card) |
| 300001 | 交易被拒绝(无效校验码) | Transaction declined (invalid CVV) |
| 300002 | 交易被拒绝(有效期错误) | Transaction declined (wrong expiry date) |
| 300003 | 交易被拒绝(持卡人错误) | Transaction declined (account holder not valid) |
| 300004 | 持卡人无权进行此交易 | Transaction not permitted to cardholder |
| 300005 | 受限制或无效的卡 | Restricked or invalid card |
| 300006 | 被阻止或首次使用 | Blocked or first used |
| 300007 | 无效卡源 | Invalid issuer |
| 300008 | 无效的PIN | Invalid PIN |
| 300009 | 不正确的PIN | Incorrect PIN |
| 300010 | 无效的安全码 | Invalid security code |
| 301001 | 交易被拒绝(参数格式错误) | Transaction declined (format error) |
| 301002 | 交易失败，请联系发卡行 | Transaction failed, please contact issuer |
| 301003 | 交易被拒绝(超出限额) | Transaction declined (limit exceeded) |
| 301004 | 交易被拒绝(尝试次数过多) | Transaction declined (too many invalid tries) |
| 301005 | 交易被拒绝(超出限制次数) | Transaction declined (maximum transaction frequency exceeded) |
| 301006 | 交易被拒绝(超出商家限额) | Transaction declined (merchants limit exceeded) |
| 301007 | 交易被拒绝(限制卡) | Transaction declined (restricted card) |
| 301008 | 交易被拒绝(过期卡) | Transaction declined (expired card) |
| 301009 | 交易被拒绝(当前卡被锁定或已被挂失) | Transaction declined (card lost) |
| 301101 | 发卡行拒绝，请联系发卡行 | Card Issuer reject，please contact card issuer |
| 301010 | 交易被拒绝(个人识别号码不正确) | Transaction declined (Incorrect personal identification number) |
| 301011 | 交易被拒绝(持卡人 3DS 校验失败) | Transaction declined (cardholder authentication verification failure) |
| 301012 | 交易被拒绝(无效金额) | Transaction declined (invalid amount) |
| 301013 | 交易被拒绝(重复交易) | Transaction declined (duplicate transaction) |
| 301015 | 交易被拒绝(请重新尝试授权) | Transaction declined (Retry using authentication,such as EMV 3DS) |
| 301021 | 交易被拒绝(个人姓名不正确) | Transaction declined (Incorrect personal name, please correct it and retry) |
| 301022 | 交易被拒绝(个人信息不匹配) | Transaction declined (personal information not match, please correct it and retry) |
| 301023 | 用户 KYC 未通过 | User kyc not qualified |
| 301099 | 交易被拒绝(其他原因) | Transaction declined (other reason) |
| 301100 | 卡bin不支持 | Unsupported card BIN |
| 301101 | 发卡行拒绝，请联系发卡行 | Card Issuer reject，please contact card issuer. |
| 301103 | 违反相关法律 | Violation of law |
| 301104 | 无效交易 | Invalid Transaction |
| 301105 | 交易关闭失败 | Transaction closure failed |
| 302000 | 交易被拒绝 (高⻛险交易) | Transaction declined (High risk transaction) |
| 302001 | 交易被拒绝（由于风险政策）。请尝试其他支付方式或联系商户支持 | Acquirer transaction Refuse(due to risk policy).Try another payment method or contact merchant support |
| 303000 | 退款失败 (可退款金额不足、原交易已取消或正在退款中) | Refund failed(refund volume exceeded or tx reversed or invalid workflow) |
| 304000 | Recurring交易失败(原交易不存在) | Recurring failed (original transaction does not exist) |
| 305001 | ISP认证信息不存在 | ISP authentication information does not exist |
| 305002 | ISP认证失败 | ISP authentication failed |
3DS 验证异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 400000 | 3DS 认证失败 | Transaction failed (3DS validation failed) |
| 400001 | 持卡人未开通 3DS 交易 | Transaction failed(customer not participating in 3DSecure program) |
| 400002 | 3DS认证失败（消费者身份验证失败） | Transaction failed (3DS_CONSUMER_AUTHENTICATION_FAILED) |
| 400003 | 3DS认证失败（无法对付款人进行身份验证) | Transaction failed (3DS_AUTHENTICATION_FAILED) |
| 400004 | 3DS认证失败（无法对付款人进行身份验证) | Transaction failed (3DS_MISSING_FIELD) |
| 400005 | 3DS认证失败（无法对付款人进行身份验证) | Transaction failed (3DS_INVALID_DATA） |
营销系统异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 131000 | 营销预算已达上限 | Marketing budget has reached its limit. |
| 132000 | 营销笔数已达上限 | The number of marketing transactions has reached its limit. |
| 133000 | 营销规则错误 | Marketing rule error. |
系统异常
| 返回码 | 说明 | 描述 |
|---|---|---|
| 500000 | 内部网关异常 | Error on the internal gateway |
| 500001 | 内部网关异常(内部服务调用异常) | Error on the internal gateway(invoke internal service error) |
| 500002 | 内部网关异常(状态机异常) | Error on the internal gateway(state machine error) |
| 500003 | 内部网关异常(流程数据不存在) | Error on the internal gateway(invalid workflow |
| 500004 | 内部网关异常(流程已经终止) | Error on the internal gateway(workflow was terminated) |
| 500005 | 内部网关异常(3DS 交易异常) | Error on the internal gateway(threeDSecure transaction error) |
| 500006 | 内部网关异常(处理响应异常) | Error on the internal gateway(analysis response error) |
| 500008 | 内部网关异常(通道路由错误，没有可用的支付通道) | Error on the internal gateway (Channel Route Error - there is no available subChannel) |
| 500009 | 通道路由错误，没有可用的merchantId | Channel Route Error - there is no available merchantId |
| 500010 | 发卡方系统或支付网络暂时无响应 | Issuer unavailable or switch inoperative |
| 600000 | 外部系统异常，请稍后重试 | Error on the external system - Please try again later |
| 600001 | 外部系统请求失败 | Request the external gateway error |
| 600002 | 交易已过期请重试 | Transaction expired, please try again |
| 600003 | 发卡机构系统异常 | System malfunction（Card Issuer） |
支付响应码修改对照表
| 返回码 | 修改前描述 | 修改后描述 |
|---|---|---|
| 102105 | HolderName invalid format 持卡人姓名格式不正确 | CardInfo.holderName invalid format 持卡人姓名格式不正确 |
| 301002 | Transaction declined (Do not honor,Please contact the issuing bank to confirm the bank card payment limit) 交易被拒绝（不予承兑，请联系发卡行确认银行卡支付限额） | Transaction failed, please contact issuer 交易失败，请联系发卡行 |
| 301105 | Transaction cancellation failed 交易取消失败 | Transaction closure failed 交易关闭失败 |
| 302001 | Transaction reject(PP risk control) 交易被拒绝 (PP风控拒绝) | Acquirer transaction Refuse(due to risk policy).Try another payment method or contact merchant support 交易被拒绝（由于风险政策）。请尝试其他支付方式或联系商户支持 |