交易状态/错误码
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": "TH",
"totalAmount": 300,
"outTradeNo": "TP002024051309261650130939",
"currency": "THB",
"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 | System is busy, please try again later. | 系统错误；请联系PayerMax |
| REQUEST_TIMEOUT | Request timeout or didn't get result, If you have finished to pay, pls wait for the result. | 请求超时；请联系PayerMax | |
| UNEXPECTED_ERROR | No further information for the error, plz try it later. | 未知错误；请联系PayerMax | |
| 基础校验异常 | SIGN_VERIFY_FAILED | The signature verify failed. | 签名错误；请核实签名 |
| MERCHANT_INVALID | The merchant has been offline. | 无效商户 | |
| MERCHANT_APP_INVALID | Signature key is not configured. | 无效商户APP | |
| PARAMS_INVALID | ${field} length must be between ${min} and ${max},but your input value length is ${length}.Make sure all requests length is correct. | 无效参数-入参字段长度不符合要求；请参考官网字段描述 | |
| PARAMS_INVALID | ${field} must be ${type} , but your input is ${valueType}.Make sure all requests type is correct. | 无效参数-入参字段类型不正确；请参考官网字段描述 | |
| PARAMS_INVALID | ${field} is invalid,because ${field} is null. | 无效参数-入参字段不能为空；请参考官网字段描述 | |
| 业务校验异常 | AMOUNT_INVALID | Amount is incorrect. | 无效的金额 |
| COUNTRY_INVALID | No country support, pls re-pay. | 无效的国家；可参考支持的国家和币种 | |
| CURRENCY_INVALID | currency is invalid,because currency is not defined. | 无效的币种；可参考支持的国家和币种 | |
| CONTRACT_INVALID | Merchant has no activated contract, please check the contract status. | 无效合约；请检查合约有效性 | |
| CONTRACT_INVALID | Merchant has not signed the contract in ${value}. | 指定的国家/地区未签约；请检查合约有效性 | |
| CONTRACT_INVALID | Merchant has not signed the ${paymentMethod} payment method. | 指定的支付方式未签约；请检查合约有效性 | |
| CONTRACT_INVALID | Merchant has not signed the ${targetOrg} target origination correspondingly, although you have signed the ${paymentMethod} payment method. | 指定的目标机构未签约；请检查合约有效性 | |
| CONTRACT_INVALID | Merchant has not signed the ${currency} currency correspondingly, although you have signed the ${paymentMethod} payment method. | 指定的支付方式有签约，但所指定的币种未签约；请检查合约有效性 | |
| CONTRACT_INVALID | Merchant has not signed the ${currency} currency correspondingly, although you have signed the ${paymentMethod} payment method and the ${targetOrg} target origination. | 指定的目标机构有签约，但所指定的币种未签约；请检查合约有效性 | |
| PAYMENT_METHOD_NOT_EXIST | The payment method does not exist. | 支付方式不存在；请更换其他支付方式 | |
| PAYMENT_METHOD_SUSPEND | The payment method already suspend, plz try other payment methods. | 支付方式暂不可用；请更换其他支付方式 | |
| AMOUNT_LIMIT_MINIMUM | The order amount is lower than the minimum limit of the payment method. | 最小金额限制 | |
| AMOUNT_LIMIT_MAXIMUM | The order amount exceeds the maximum limit of the payment method. | 最大金额限制 | |
| AMOUNT_LIMIT | The amount doesn't match the payment method requirement. | 金额限制 | |
| ORDER_REPEAT | The order number repeat. | 订单重复 | |
| ONBOARD_ERROR | Please complete the merchant onboarding, then refresh the page. | 商户未报备；请先完成报备 | |
| PAYMENT_PROCESSING | The payment is processing, pls check the result. | 支付处理中；请稍后重试 | |
| PARTICIPANT_INVALID | Invalid participant. | 无效分账参与方 | |
| ORDER_CLOSED | This order has been closed. | 订单关闭 | |
| BALANCE_INSUFFICIENT | Insufficient balance to pay, please confirm payment account available balance. | 余额不足 | |
| OTP_VERIFY_LIMIT | OTP verification exceeds limit. | OTP验证超过限制 | |
| OTP_VERIFY_FAILED | OTP verification failed. | OTP验证失败 | |
| OVER_VERIFY_LIMIT | Exceeded the number of verifications. | 超过验证次数 | |
| BARCODE_REFRESH_LIMIT | Over barcode refresh times. | Barcode刷新限制 | |
| BARCODE_REFRESH_FAILED | Barcode refresh failed. | Barcode刷新失败 | |
| CARD_INVALID | Make sure the card number is correct. | 无效卡号 | |
| CARD_EXPIRE_DATE_INVALID | Invalid card number validity period. | 无效卡号有效期 | |
| CARD_HOLDER_NAME_INVALID | Invalid cardholder name. | 无效持卡人姓名 | |
| CVV_INVALID | Cvv is incorrect, pls check. | 无效CVV | |
| UNSUPPORT_CARD | This card don't support, please change another card. | 卡不支持 | |
| ACCOUNT_INVALID | Your acount is invalid or not active, please confirm and re-enter. | 无效账号 | |
| PHONE_NUM_INVALID | The phone number is invalid, pls check and re-enter. | 无效的电话号码 | |
| UPI_INVALID | UPI is incorrect. | 无效UPI | |
| PIN_VERIFY_LIMIT | Pin verification exceeds limit. | Pin验证超过限制 | |
| PIN_INVALID | Pin is invalid. | Pin无效 | |
| BANKCODE_INVALID | Invalid bank card number. | 无效银行卡号 | |
| ID_NUM_INVALID | Invalid ID number. | 无效的证件号 | |
| EMAIL_INVALID | Your email is invalid, or your account is not active, please confirm and re-enter. | 无效的Email | |
| DOCUMENT_INVALID | Invalid document. | 无效的文档 | |
| TCK_INVALID | TC Kimlik No. is incorrect. | 无效的TC Kimlik No. | |
| DATE_INVALID | The data format is error, please check. | 无效的日期 | |
| PAYEE_NAME_INVALID | Your name is invalid, or does not match, please confirm and re-enter. | 无效的付款人姓名 | |
| REMARK_INVALID | Invalid remark. | 无效的remark | |
| CNIC_INVALID | The CNIC is incorrect, pls confirm and re-enter. | 无效的CNIC | |
| PAYMENT_FAILED | Provider failed to process. | 支付失败 | |
| ACCOUNT_BLOCKED | Payer account/card blocked or frozen. Pls confirm payment account/card status. | 账号被锁定/冻结 | |
| PAYMENT_CANCELED | payment canceled. | 用户在第三方支付取消 | |
| 授权异常 | AUTHENTICATE_FAILED | Your payment was declined due to authentication failure. Please try using a different card or contact your issuer for more detail. | 授权失败 |
| AUTH_EXPIRED | The authorization has expired, pls rebind. | 授权过期 | |
| AUTH_FAILED | Authorization failed. | 授权失败或不存在 | |
| 交易拒绝 | RISK_FAILED | This transaction was automatically blocked due to identified risk. | 该交易因存在确认性风险被拦截 |
| RISK_FAILED | The payment has reached the security limit. Please advise the user to try another payment method or attempt the transaction again later. | 用户支付已达到安全限额/限次，建议用户尝试其他支付方式 | |
| RISK_FAILED | The payment has exhibited suspicious activity. We suggest that the user use a local card or disable their VPN before trying again. | 检测到支付行为异常，建议用户使用本地银行卡或关闭VPN后重试 | |
| RISK_FAILED | The payment was declined due to unusual activity from the user. We recommend changing to a different payment method and attempting the transaction again. | 由于交易风险较高，支付已被拒绝，建议用户更换其他支付方式 | |
| 商户拒绝 | RISK_BLACK_LIST_FAILED | The payment was declined due to high risk with the payment. | 此笔交易命中商户自身侧黑名单，黑名单详情可登录MMC查询 |
| 发卡行拒绝 | ISSUER_PAYMENT_REJECTED | Transaction failed at issuer end due to risk control. Please contact your payment method issuer for more detail. | 交易被发卡行拒绝，详情请用户咨询发卡行确认 |
| 查询 | ORDER_NOT_EXIST | The order does not exist. | 订单不存在 |
| 退款 | REFUND_FAILED | The payment method does not support partial refund. | 退款失败-支付方式不支持部分退款 |
| REFUND_FAILED | The payment method does not support refund. | 退款失败-支付方式不支持退款 | |
| REFUND_FAILED | The refund amount is too small to refund. | 退款失败-退款金额太小 | |
| REFUND_NO_INVALID | RefundNo shouldn't same with TradeNo. | 退款单号无效 | |
| REFUND_INSUFFICIENT_BALANCE | Insufficient Txn currency in the to be Settled Account. | 余额不足无法退款 | |
| ORDER_NOT_EXIST | The orginal order does not exist. | 退款单不存在 |