PayerMax交易状态/错误码
1. 交易状态
当Payermax受理您的下单请求后，通过查询API或通知均可感知到付款状态。您可以通过获取交易状态，从而制定业务流程。状态如下：
| 状态 | 描述 | 备注 |
| SUCCESS | 交易成功 | 用户支付成功 |
| PENDING | 交易处理中 | 等待用户完成支付 |
| FAILED | 交易失败 | 支付失败 |
| CLOSED | 交易关单 | 用户在有效期内未完成支付 |
当订单未成功时，Payermax会提供错误码，以便您分析失败原因。
2. 错误码
Payermax对外API提供了稳定的服务，若出现异常则会在http接口响应的body中告知您错误信息，例如：
json
{
"msg": "The amount doesn't match the payment method requirement.",
"code": "AMOUNT_LIMIT"
}同样，在异步的回调中，也会响应失败信息，例如：
json
{
"msg": "Payment was not completed on time.",
"code": "PAYMENT_FAILED",
"data": {
"reference": "JOLLY",
"country": "RU",
"totalAmount": 300,
"outTradeNo": "TP002024051309261650130939",
"currency": "RUB",
"tradeToken": "T2024051309124735760727",
"paymentDetails": [],
"status": "CLOSED"
},
"keyVersion": "1",
"appId": "5a48dcf440074021b87d4ef901bf9629",
"merchantNo": "SP18440851",
"notifyTime": "2024-05-13T10:28:03.606Z",
"notifyType": "PAYMENT"
}若正常受理，返回code是“APPLY_SUCCESS”。
2.1 错误码列表
| 结果码 | 结果描述 | 备注 |
| SYSTEM_ERROR | 系统错误 | |
| SIGN_VERIFY_FAILED | 签名错误 | |
| REQUEST_TIMEOUT | 请求超时 | |
| PAYMENT_REJECTED | 请求拒绝 | |
| AUTHENTICATE_FAILED | 授权失败 | |
| ISSUER_PAYMENT_REJECTED | 请求被第三方拒绝 | |
| PARAMS_INVALID | 无效参数 | |
| MERCHANT_INVALID | 无效商户 | |
| MERCHANT_APP_INVALID | 无效商户APP | |
| CONTRACT_INVALID | 无效合约 | |
| ORDER_NOT_EXIST | 订单不存在 | |
| ORDER_CLOSED | 订单关闭 | |
| ORDER_REPEAT | 订单重复 | |
| PAYMENT_METHOD_NOT_EXIST | 支付方式不存在 | |
| PAYMENT_METHOD_SUSPEND | 支付方式暂不可用 | |
| ONBOARD_ERROR | 商户未报备 | |
| UNEXPECTED_ERROR | 未知错误 | |
| BALANCE_INSUFFICIENT | 余额不足 | |
| COUNTRY_INVALID | 无效的国家 | |
| CURRENCY_INVALID | 无效的币种 | |
| AMOUNT_LIMIT | 金额限制 | |
| AMOUNT_LIMIT_MINIMUM | 最小金额限制 | |
| AMOUNT_LIMIT_MAXIMUM | 最大金额限制 | |
| AMOUNT_INVALID | 无效的金额 | |
| OTP_VERIFY_LIMIT | OTP验证超过限制 | |
| OTP_VERIFY_FAILED | OTP验证失败 | |
| OVER_VERIFY_LIMIT | 超过验证次数 | |
| AUTH_FAILED | 授权失败或不存在 | |
| AUTH_EXPIRED | 授权过期 | |
| BARCODE_REFRESH_LIMIT | Barcode刷新限制 | |
| BARCODE_REFRESH_FAILED | Barcode刷新失败 | |
| CARD_INVALID | 无效卡号 | |
| CARD_EXPIRE_DATE_INVALID | 无效卡号有效期 | |
| CARD_HOLDER_NAME_INVALID | 无效持卡人姓名 | |
| CVV_INVALID | 无效CVV | |
| UNSUPPORT_CARD | 卡不支持 | |
| ACCOUNT_INVALID | 无效账号 | |
| PHONE_NUM_INVALID | 无效的电话号码 | |
| UPI_INVALID | 无效UPI | |
| PIN_VERIFY_LIMIT | Pin验证超过限制 | |
| PIN_INVALID | Pin无效 | |
| BANKCODE_INVALID | 无效银行卡号 | |
| ID_NUM_INVALID | 无效的证件号 | |
| EMAIL_INVALID | 无效的Email | |
| DOCUMENT_INVALID | 无效的文档 | |
| TCK_INVALID | 无效的TC Kimlik No. | |
| DATE_INVALID | 无效的日期 | |
| PAYEE_NAME_INVALID | 无效的付款人姓名 | |
| REMARK_INVALID | 无效的remark | |
| CNIC_INVALID | 无效的Cnic | |
| PAYMENT_PROCESSING | 支付处理中 | |
| PAYMENT_FAILED | 支付失败 | |
| REFUND_FAILED | 退款失败 | |
| REFUND_NO_INVALID | 退款单号无效 | |
| REFUND_INSUFFICIENT_BALANCE | 余额不足无法退款 | |
| ACCOUNT_BLOCKED | 账号被锁定/冻结 | |
| PARTICIPANT_INVALID | 无效分账参与方 | |
| DECLINED_BY_MERCHANT_BLACKLIST | 商户黑名单拦截 | |
| PAYMENT_CANCELED | 用户在第三方支付取消 |