扣款结果通知

• Endpoint: POST /subscriptionPaymentResultNotifyUrl
• Tags: 收单/订阅计划管理

Description

当订阅计划激活后，PayerMax会按照商户创建订阅计划时指定的扣款周期进行扣款，每一期扣款成功后，都会通知商户扣款结果；当某期扣款失败后，PayerMax会在24小时内重试3次（总共会有4次扣款），并会在最后一次扣款重试后发送扣款结果通知。

Parameters

Field	Type	Required	Description
Content-Type (header)	string	Yes
sign (header)	string	Yes	签名信息请参考技术文档

Request Body

Field	Type	Required	Description
code	string	Yes	返回码。
msg	string	Yes	返回描述。
keyVersion	string	Yes	密钥版本。当前值为：1
appId	string	Yes	商户app id
merchantNo	string	No	商户Id
notifyTime	string	Yes	通知时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
notifyType	string	Yes	通知类型：SUBSCRIPTION_PAYMENT
data	object	Yes
data.subscriptionRequestId	string	Yes	商户创建订阅计划的单号。
data.userId	string	Yes	用户ID。
data.subscriptionPlan	object	Yes	订阅计划
data.subscriptionPlan.subscriptionNo	string	Yes	PMMAX订阅计划号。
data.subscriptionPaymentDetail	object	Yes	扣款详情。
data.subscriptionPaymentDetail.subscriptionIndex	number	Yes	扣款期数。
data.subscriptionPaymentDetail.paymentStatus	string	Yes	本期订单状态。 PENDING：支付中 SUCCESS：支付成功 FAILED：支付失败
data.subscriptionPaymentDetail.periodStartTime	string	Yes	本期开始时间。如：2025-01-13T15:59:59+0000
data.subscriptionPaymentDetail.periodEndTime	string	Yes	本期结束时间，如：2025-02-13T15:59:59+0000。
data.subscriptionPaymentDetail.payAmount	object	Yes	支付金额。
data.subscriptionPaymentDetail.payAmount.amount	number	No	金额。
data.subscriptionPaymentDetail.payAmount.currency	string	No	币种。
data.subscriptionPaymentDetail.paymentMethodType	string	Yes	支付方式。
data.subscriptionPaymentDetail.cardOrg	string	Yes	卡组。
data.subscriptionPaymentDetail.lastPaymentInfo	object	Yes	本期最新一次支付详情。
data.subscriptionPaymentDetail.lastPaymentInfo.lastPaymentStatus	string	Yes	支付结果。 PENDING：支付中 SUCCESS：支付成功 FAILED：支付失败
data.subscriptionPaymentDetail.lastPaymentInfo.payTime	string	Yes	支付时间，如：2025-01-12T15:59:59+0000。
data.subscriptionPaymentDetail.lastPaymentInfo.tradeToken	string	No	支付单号，可用于退款。 注：成功时必有该值。
data.subscriptionPaymentDetail.lastPaymentInfo.errorCode	string	No	扣款失败code。
data.subscriptionPaymentDetail.lastPaymentInfo.errorMsg	string	No	扣款失败msg。
data.subscriptionPaymentDetail.cardInfo	object	No	卡信息
data.subscriptionPaymentDetail.cardInfo.cardOrg	string	No	卡组织，当paymentMethodType为CARD时返回，只有交易成功且用户选择卡组织支付时才返回
data.subscriptionPaymentDetail.cardInfo.country	string	No	发卡国家
data.subscriptionPaymentDetail.cardInfo.cardType	string	No	卡类型，DEBIT、CREDIT等。
data.subscriptionPaymentDetail.cardInfo.totalCardOrg	array[string]	No	卡的所有卡组织，双标卡会返回两个。
data.subscriptionPaymentDetail.cardInfo.type	string	No	卡性质。PAN为真实卡；NETWORK_TOKEN为虚拟卡，如APPLEPAY。
data.subscriptionPaymentDetail.cardInfo.source	string	No	卡信息来源。CARD、APPLEPAY、GOOGLEPAY_PAN、GOOGLEPAY_CRYPTOGRAM、NETWORK_TOKEN
data.subscriptionPaymentDetail.cardInfo.cardBinNo	string	No	卡bin号。
data.subscriptionPaymentDetail.cardInfo.cardNumber	string	No	卡号，掩码返回。
data.subscriptionPaymentDetail.cardInfo.cardHolderName	string	No	持卡人姓名，掩码返回。
data.subscriptionPaymentDetail.cardInfo.cardLast4	string	No	真实卡号后四位。
data.subscriptionPaymentDetail.cardInfo.cardExpirationYear	string	No	卡有效年。
data.subscriptionPaymentDetail.cardInfo.cardExpirationMonth	string	No	卡有效月。

Responses

200

Field	Type	Required	Description
code	string	Yes	仅可响应 ‘SUCCESS’(仅代表成功收到通知,不代表订单状态)
msg	string	Yes	响应 ‘Success’(仅代表成功收到通知,不代表订单状态)