错误码
快速查询常见错误码及含义
在调用 Checus 支付服务过程中，如请求失败系统将返回以下错误码。请根据错误码和描述定位问题，并及时修正。 | 类型 | 错误码 | 描述 | 说明 |
|---|---|---|---|
| 请求受理 | APPLY_SUCCESS | 申请成功 | 仅代表请求受理成功，请以 status 字段为准判断交易状态 |
| 系统异常 | SYSTEM_ERROR | 系统错误 | Checus 系统内部异常 |
| UNEXPECTED_ERROR | 未知错误 | 异常状态，请联系技术支持 | |
| 签名/权限 | SIGN_VERIFY_FAILED | 签名验证失败 | 签名错误，需检查签名逻辑和密钥配置 |
| AUTHENTICATE_FAILED | 授权失败 | 授权流程未通过 | |
| AUTH_FAILED | 授权无效或失败 | 无法完成用户授权 | |
| AUTH_EXPIRED | 授权已过期 | 授权码超时或失效 | |
| 请求超时/拒绝 | REQUEST_TIMEOUT | 请求超时 | 请求未在规定时间内响应 |
| PAYMENT_REJECTED | 请求被拒绝 | 通常因风控或参数不合规被系统拦截 | |
| ISSUER_PAYMENT_REJECTED | 第三方拒绝付款 | 通常由发卡行/支付渠道拒绝 | |
| 商户/合约 | MERCHANT_INVALID | 商户无效 | 商户信息未注册或状态异常 |
| MERCHANT_APP_INVALID | 商户APP无效 | app_id 不存在或未授权 | |
| CONTRACT_INVALID | 合约无效 | 商户与支付方式间无有效合约 | |
| ONBOARD_ERROR | 商户未完成报备 | 商户尚未完成报备流程 | |
| DECLINED_BY_MERCHANT_BLACKLIST | 商户黑名单拦截 | 被风控策略拦截 | |
| 订单 | ORDER_NOT_EXIST | 订单不存在 | 查询或操作的订单无效 |
| ORDER_CLOSED | 订单已关闭 | 订单已被取消或超时自动关单 | |
| ORDER_REPEAT | 重复订单 | 请确认是否重复提交相同订单号 | |
| 支付方式/账户 | PAYMENT_METHOD_NOT_EXIST | 支付方式不存在 | 请求中指定的支付方式无效 |
| PAYMENT_METHOD_SUSPEND | 支付方式不可用 | 该方式临时关闭或被禁用 | |
| ACCOUNT_INVALID | 账号无效 | 用户银行账号异常 | |
| BALANCE_INSUFFICIENT | 余额不足 | 商户或用户账户余额不足 | |
| ACCOUNT_BLOCKED | 账户被锁定 | 用户或商户账户异常 | |
| 支付方式/账户 | PARTICIPANT_INVALID | 分账参与方无效 | 子账户信息错误 |
| 金额/币种 | COUNTRY_INVALID | 国家信息无效 | 国家代码填写错误或未开通 |
| CURRENCY_INVALID | 币种无效 | 不支持的币种 | |
| AMOUNT_LIMIT | 金额超限 | 超出支持的金额区间 | |
| AMOUNT_LIMIT_MINIMUM | 金额低于最小限制 | 低于支持的最小金额 | |
| AMOUNT_LIMIT_MAXIMUM | 金额高于最大限制 | 超出支持的最大金额 | |
| 金额/币种 | AMOUNT_INVALID | 金额格式错误 | 非法金额格式 |
| 验证/验证码 | OTP_VERIFY_LIMIT | OTP验证次数超限 | 超出OTP验证次数限制 |
| OTP_VERIFY_FAILED | OTP验证失败 | 输入的验证码错误 | |
| OVER_VERIFY_LIMIT | 验证次数过多 | 风控触发 | |
| PIN_VERIFY_LIMIT | PIN验证次数超限 | 多次错误触发限制 | |
| PIN_INVALID | PIN码无效 | 用户输入错误 | |
| 条码/二维码 | BARCODE_REFRESH_LIMIT | 条码刷新频繁 | 请求刷新过于频繁 |
| BARCODE_REFRESH_FAILED | 条码刷新失败 | 渠道或系统异常 | |
| 银行卡信息 | CARD_INVALID | 卡号无效 | 卡号格式或内容非法 |
| CARD_EXPIRE_DATE_INVALID | 卡有效期无效 | 卡片过期或格式错误 | |
| CARD_HOLDER_NAME_INVALID | 持卡人姓名无效 | 与卡信息不符 | |
| CVV_INVALID | CVV码错误 | 安全码无效 | |
| UNSUPPORT_CARD | 不支持的卡种 | 当前渠道不支持该卡 | |
| 联系方式/身份 | PHONE_NUM_INVALID | 电话号码无效 | 手机号格式不正确 |
| ID_NUM_INVALID | 证件号无效 | 证件格式或内容错误 | |
| EMAIL_INVALID | 邮箱地址错误 | 邮箱格式不合规 | |
| DOCUMENT_INVALID | 文件无效 | 上传的文件不符合规范 | |
| DATE_INVALID | 日期格式错误 | 日期字段填写非法 | |
| PAYEE_NAME_INVALID | 收款人姓名无效 | 与开户信息不符 | |
| REMARK_INVALID | 备注无效 | 不支持的备注内容 | |
| 支付状态 | PAYMENT_PROCESSING | 支付处理中 | 正在处理，请等待最终结果 |
| PAYMENT_FAILED | 支付失败 | 渠道或用户侧失败 | |
| PAYMENT_CANCELED | 用户取消支付 | 用户在第三方页面主动取消 | |
| 退款 | REFUND_FAILED | 退款失败 | 退款操作未成功 |
| REFUND_NO_INVALID | 退款单号无效 | 查询的退款记录不存在 | |
| REFUND_INSUFFICIENT_BALANCE | 余额不足无法退款 | 商户账户无足够余额 |