退款通知
Subscription 场景补充
当退款来自 Subscription 的计划变更或立即取消时,退款通知仍使用 notifyType=REFUND。商户应按退款维度做幂等处理,优先使用 merchantRefundId / refundId 关联退款单;同时可结合 查询订阅支付记录 确认退款金额、币种和最终状态。
退款通知只表示资金层面的退款结果,不表示订阅状态已经变化。订阅是否继续生效、是否已经取消,应以 订阅通知 或 查询订阅详情 为准。
退款异步通知
application/json异步通知公共参数
bizContent
amountString(14)必填退款金额refundTimeString(32)必填退款发起时间,时间戳refundEndingTimeString(32)必填退款到达终态时间,时间戳merchantTransactionIdString(64)必填商户网站的原交易流水号transactionIdString(64)必填PingPong原交易流水号merchantRefundIdString(64)必填商户网站的退款交易流水号refundIdString(64)必填PingPong退款交易流水号currencyString(3)必填详见交易币种notifyTypeString(32)必填- REFUND-退款
statusString(32)必填退款状态:状态幂等- SUCCESS-成功
- FAILED-失败
remarkString可选商户扩展字段
异步通知报文示例
{
"clientId": "2023042011040310224",
"code": "000000",
"bizContent": {
"amount": "100.000000",
"transactionId": "2024050750046460",
"notifyType": "REFUND",
"merchantTransactionId": "PMT-2S7RR3K4LQ1715047351210",
"currency": "USD",
"merchantRefundId": "PMT-4DNTI3AWXR1715049316146",
"refundEndingTime": "1715049319211",
"refundId": "2024050750046461",
"status": "SUCCESS"
},
"sign": "B655B6553B7189016F01088606352798ABBF867797259D7E5068E762739D991D",
"accId": "2023042011040310224447",
"description": "Transaction succeeded",
"signType": "SHA256"
}