退款结果回调通知

退款有结果后，支付系统会把退款结果通知给商户系统。

通知规则

支付系统采用POST请求方式发送JSON格式的退款结果通知到商户预先配置的回调地址。商户系统收到通知后需要返回大写字符串"SUCCESS"表示接收成功，否则支付系统会进行重试通知。

重试策略为3次，每次重试间隔5分钟。如果3次重试后仍未收到正确响应，则停止通知。

重要提醒：同一笔退款订单可能收到多次回调通知，商户系统应做好幂等性处理，避免重复处理。

请求参数

请求方式：POST
请求格式：application/json
字符编码：UTF-8

Body参数

参数名称	类型	必填	说明
uniqueRefundNo	string	是	支付系统退款订单号，支付系统生成的唯一退款标识
refundNo	string	是	商户系统退款订单号，商户系统内唯一退款标识
orderNo	string	是	商户系统支付订单号，对应的原支付订单号
uniqueOrderNo	string	是	支付系统支付订单号，对应的原支付系统订单号
refundAmt	number	是	退款金额，单位为分
returnFee	number	否	退款归还手续费，退款时归还给商户的手续费，单位为分
status	string	是	退款状态 • PROCESSING：退款处理中 • SUCCESS：退款成功 • FAILED：退款失败
failureReason	string	否	失败原因，当退款状态为FAILED时提供具体失败原因
description	string	是	退款原因，发起退款时填写的原因说明
memo	string	否	商户自定义参数，透传字段
refundRequestDate	string	是	退款请求时间，格式：yyyy-MM-dd HH:mm:ss
refundSuccessDate	string	否	退款成功时间，退款状态为SUCCESS时提供，格式：yyyy-MM-dd HH:mm:ss

请求示例

退款成功示例

{
   "uniqueRefundNo": "REF20250724000001",
   "refundNo": "REFUND202507240001",
   "orderNo": "ORD202507240001",
   "uniqueOrderNo": "PAY20250724000001",
   "refundAmt": 5000,
   "returnFee": 15,
   "status": "SUCCESS",
   "description": "用户申请退款",
   "memo": "退款备注信息",
   "refundRequestDate": "2025-07-24 15:30:25",
   "refundSuccessDate": "2025-07-24 15:35:10"
}

退款结果通知

退款结果回调通知#

通知规则#

请求参数#

Body参数#