Skip to content

授权结果通知

  • Endpoint: POST /authResultNotifyUrl
  • Tags: 收单/Auth-Capture

Description

支付完成后,PayerMax 会把相关支付结果通过数据流的形式发送给商户,商户需要接收处理,并按文档规范返回应答。 提示:该地址无需商户主动请求,以下request.body为payermax对订单状态的回调内容,商户收到回调后需要响应

Parameters

FieldTypeRequiredDescription
Content-Type (header)stringYes
sign (header)stringYes签名信息请参考技术文档

Request Body

FieldTypeRequiredDescriptionEnum
codestringYes返回码,交易成功时,code:APPLY_SUCCESS 且status:SUCCESS; 交易失败,code会返回交易失败错误码 且status为FAILED或CLOSED。
msgstringYes返回描述,交易成功时,msg:Success. 且status:SUCCESS; 交易失败,msg会返回交易失败错误msg 且status为FAILED或CLOSED。
keyVersionstringYes密钥版本。当前值为:1
appIdstringYes商户app id
merchantNostringNo商户Id
notifyTimestringYes通知时间,符合rfc3339规范,格式:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyTypestringYes通知类型 PAYMENT
dataobjectYes
data.outTradeNostringYes商户订单号
data.tradeTokenstringYesPayerMax交易流水号
data.totalAmountnumberYes商户传入的订单金额,金额的单位为元
data.currencystringYes标价币种
data.countrystringNo用户支付的国家代码,大写字母
data.statusstringYes交易状态:SUCCESS-支付成功,FAILED -支付失败,CLOSED-关单SUCCESS, FAILED, CLOSED
data.captureModestringYes请款模式:MANUAL
data.authorizationTypestringYes授权类型:FINAL_AUTH
data.completeTimestringYes完成时间,utc+0时区
data.paymentDetailsarray[object]No支付信息
data.paymentDetails[].paymentMethodTypestringYes支付方式类型,用户支付选择的支付方式,只有交易成功才会返回用户支付所选择的支付方式
data.paymentDetails[].targetOrgstringNo目标机构,用户支付选择的目标机构,只有交易成功才会返回用户支付所选择的目标机构;支付方式为CARD的时候详见卡信息
data.paymentDetails[].cardInfoobjectNo卡信息
data.paymentDetails[].cardInfo.cardOrgstringNo卡组织,当paymentMethod为CARD时返回,只有交易成功且用户选择卡组织支付时才返回
data.paymentDetails[].cardInfo.cardIdentifierNostringNo卡号,当paymentMethod为CARD时掩码返回
data.paymentDetails[].cardInfo.cardIdentifierNamestringNo卡姓名,当paymentMethod为CARD时掩码返回
data.paymentDetails[].cardInfo.countrystringNo发卡国家
data.paymentDetails[].cardInfo.paymentTokenIDstringNo绑卡支付场景下,用于支付的授权ID,默认有效期为卡有效期,可通过【removePaymentToken】接口置为无效。
data.paymentDetails[].cardInfo.threeDSResultobjectNo3ds结果
data.paymentDetails[].cardInfo.threeDSResult.threeDSVersionstringNo3ds版本 1.0.2, 2.1.0, 2.2.0
data.paymentDetails[].cardInfo.threeDSResult.enrolledstringNoStatus of Authentication eligibility. Y - Yes, Bank is participating in 3-D Secure protocol and will return the ACSUrl N - No, Bank is not participating in 3-D Secure protocol U - Unavailable, The DS or ACS is not available for authentication at the time of the request B - Bypass, Merchant authentication rule is triggered to bypass authentication in this use case. (3DS Flex premium only)Y, U, B
data.paymentDetails[].cardInfo.threeDSResult.authenticationStatusstringNoTransactions status result identifier. Y - Successful Authentication N - Failed Authentication U - Unable to Complete Authentication A - Successful Attempts Transaction R - Authentication Rejected (Merchant must not submit for authorisation)Y, N , U , A , R
data.paymentDetails[].cardInfo.threeDSResult.ecistringYesElectronic Commerce Indicator (ECI). Possible Values: 02 or 05 - Fully Authenticated Transaction 01 or 06 - Attempted Authentication Transaction 00 or 07 - Non 3-D Secure Transaction Mastercard - 02, 01, 00 Visa - 05, 06, 07
data.paymentDetails[].cardInfo.threeDSResult.dsTransactionIdstringNothe Directory Server (DS)分配的唯一标识
data.paymentDetails[].cardInfo.threeDSResult.cavvstringNoCardholder Authentication Verification Value (CAVV) Authentication Verification Value (AVV) Universal Cardholder Authentication Field (UCAF)
data.paymentDetails[].cardInfo.threeDSResult.xidstringNo身份验证结果标识
data.paymentDetails[].paymentTokenIDstringNo绑卡支付场景下,用于支付的授权ID,默认有效期为卡有效期,可通过【removePaymentToken】接口置为无效。
data.feesobjectNo费用信息,支付成功且存在费用时才返回
data.fees.merFeeobjectNo商户费用
data.fees.merFee.urlstringYes发票地址,打开地址可预览发票
data.fees.merFee.amountstringYes费用金额
data.fees.merFee.currencystringYes费用币种
data.referencestringNo商户自定义附加数据,回调中原样返回
data.channelNostringNo渠道订单号
data.thirdChannelNostringNo三方单号
data.paymentCodestringNoVA单号
data.issuerResponseMsgstringNo发卡行标准错误描述
data.issuerResponseCodestringNo发卡行标准错误码

Responses

200 — ## 错误码

分类结果码结果描述
REQUEST_TIMEOUTRequest timeout or didn't get result, If you have finished to pay, pls wait for the result.请求超时;请联系PayerMax
UNEXPECTED_ERRORNo further information for the error, plz try it later.未知错误;请联系PayerMax
AMOUNT_LIMIT_MINIMUMThe order amount is lower than the minimum limit of the payment method.最小金额限制
AMOUNT_LIMIT_MAXIMUMThe order amount exceeds the maximum limit of the payment method.最大金额限制
AMOUNT_LIMITThe amount doesn't match the payment method requirement.金额限制
PAYMENT_PROCESSINGThe payment is processing, pls check the result.支付处理中;请稍后重试
ORDER_CLOSEDThis order has been closed.订单关闭
BALANCE_INSUFFICIENTInsufficient balance to pay, please confirm payment account available balance.余额不足
OTP_VERIFY_LIMITOTP verification exceeds limit.OTP验证超过限制
OTP_VERIFY_FAILEDOTP verification failed.OTP验证失败
OVER_VERIFY_LIMITExceeded the number of verifications.超过验证次数
BARCODE_REFRESH_LIMITOver barcode refresh times.Barcode刷新限制
BARCODE_REFRESH_FAILEDBarcode refresh failed.Barcode刷新失败
CARD_INVALIDMake sure the card number is correct.无效卡号
CARD_EXPIRE_DATE_INVALIDInvalid card number validity period无效卡号有效期
CARD_HOLDER_NAME_INVALIDInvalid cardholder name无效持卡人姓名
CVV_INVALIDCvv is incorrect, pls check.无效CVV
UNSUPPORT_CARDThis card don't support, please change another card.卡不支持
ACCOUNT_INVALIDYour account is invalid or not active, please confirm and re-enter.无效账号
PHONE_NUM_INVALIDThe phone number is invalid, pls check and re-enter.无效的电话号码
UPI_INVALIDUPI is incorrect.无效UPI
PIN_VERIFY_LIMITPin verification exceeds limitPin验证超过限制
PIN_INVALIDPin is invalidPin无效
BANKCODE_INVALIDInvalid bank card number.无效银行卡号
ID_NUM_INVALIDInvalid ID number无效的证件号
EMAIL_INVALIDYour email is invalid, or your account is not active, please confirm and re-enter.无效的Email
DOCUMENT_INVALIDInvalid document.无效的文档
TCK_INVALIDTC Kimlik No. is incorrect.无效的TC Kimlik No.
DATE_INVALIDThe data format is error, please check.无效的日期
PAYEE_NAME_INVALIDYour name is invalid, or does not match, please confirm and re-enter.无效的付款人姓名
REMARK_INVALIDInvalid remark无效的remark
CNIC_INVALIDThe CNIC is incorrect, pls confirm and re-enter.无效的CNIC
ACCOUNT_BLOCKEDPayer account/card blocked or frozen. Pls confirm payment account/card status.账号被锁定/冻结
PAYMENT_CANCELEDpayment canceled.用户在第三方支付取消
PAYMENT_TOKEN_ID_INVALIDPaymentTokenID is invalid. Please confirm if it has been authorized and boundpaymentTokenId不合法,请检查输入是否正确,或已经解绑
ACCOUNT_VALIDATION_INVALIDPlease complete the account verification firstly.账户未完成验证,请先完成账户验证
PAYMENT_PROCESSING_BANKTRANSFERThe previous payment is still processing, please make sure that you have made the bank transfer. Otherwise, please wait for 10 minutes to initiate a new request.上一笔支付处理中,请确认已完成银行转账,否则请等待10分钟后重试
REQUEST_PARAM_INVALID[amount.value] must be greater than zero请求参数无效,金额必须大于零
INSUF_BAL_FALLBACKYour account balance is insufficient to cover the amount. Please check your account balance.账户余额不足,请检查账户余额
ONLY_ONE_AUTH_CHANNEL_ALLOWEDonly one authorization channel is allowed仅允许一个授权渠道
ISSUER_PAYMENT_REJECTEDTransaction failed at issuer end due to risk control. Please try using a different card or contact your issuer for more detail.交易被发卡行风控拒绝,请更换银行卡或联系发卡行
AMOUNT_LIMITThe amount exceeds user amount limit.用户金额限制
AMOUNT_LIMITThe amount exceeds the limit for per transaction limit.单笔交易金额限制
AMOUNT_LIMITThe amount exceeds the limit for the day.日交易金额限制
CARD_INVALIDExpired card.卡已过期
CARD_INVALIDCard scheme is not supported.卡组织不支持
CARD_INVALIDOnly support the card which issue by local bank, pls change local card.仅支持本地银行卡
OTP_VERIFY_FAILEDOTP verify failed.OTP验证失败
PAYMENT_FAILEDTransaction declined.交易被拒绝
PAYMENT_FAILEDThere is no channel to support the payment.无可用支付渠道
PAYMENT_FAILEDPayment was not completed on time.支付超时未完成
PAYMENT_FAILEDProvider failed to process.支付失败
AUTHENTICATE_FAILEDYour payment was declined due to authentication failure. Please try using a different card or contact your issuer for more detail.授权失败
AUTH_EXPIREDThe authorization has expired, pls rebind.授权过期
AUTH_FAILEDAuthorization failed.授权失败或不存在
RISK_FAILEDThis transaction was automatically blocked due to identified risk.该交易因存在确认性风险被拦截
RISK_FAILEDThe payment has reached the security limit. Please advise the user to try another payment method or attempt the transaction again later.用户支付已达到安全限额/限次,建议用户尝试其他支付方式
RISK_FAILEDThe payment has exhibited suspicious activity. We suggest that the user use a local card or disable their VPN before trying again.检测到支付行为异常,建议用户使用本地银行卡或关闭VPN后重试
RISK_FAILEDThe payment was declined due to unusual activity from the user. We recommend changing to a different payment method and attempting the transaction again.由于交易风险较高,支付已被拒绝,建议用户更换其他支付方式
ISSUER_PAYMENT_REJECTEDDevice IP restriction,please make sure your VPN is turned off when making the payment for security reason.设备IP受限,请关闭VPN后重试
PAYMENT_REJECTEDTransaction failed at processor end due to risk control.Please try using a different payment method/card.nan
RISK_BLACK_LIST_FAILEDThe payment was declined due to high risk with the payment.此笔交易命中商户自身侧黑名单,黑名单详情可登录MMC查询
ISSUER_PAYMENT_REJECTEDTransaction failed at issuer end due to risk control. Please contact your payment method issuer for more detail.交易被发卡行拒绝,详情请用户咨询发卡行确认
FieldTypeRequiredDescription
codestringYes仅可响应 ‘SUCCESS’(仅代表成功收到通知,不代表订单状态)
msgstringYes响应 ‘Success’(仅代表成功收到通知,不代表订单状态)

Enum Reference

data.status

  • SUCCESS
  • FAILED
  • CLOSED

data.paymentDetails[].cardInfo.threeDSResult.enrolled

  • Y
  • U
  • B

data.paymentDetails[].cardInfo.threeDSResult.authenticationStatus

  • Y
  • N
  • U
  • A
  • R

此页面的内容有帮助吗?

感谢您帮助改进 PayerMax 产品文档!

Last updated:

Released under the MIT License.