跳到主要内容

退款通知

当退款成功后,聚合支付后台会根据 申请退款 的notify_url地址,以事件通知的方式异步将退款变更结果回调给业务方。

业务方需自行实现接受逻辑处理回调信息。

业务方在接受到回调请求后,需在 5秒 内返回。如果 5秒 内收不到响应会断掉连接,并重新发起请求。平台会在12小时内,通过一定的策略(通知频率为 0s/15s/15s/30s/3m/10m/20m/30m/30/30m/1h/3h/3h/3h )间接性重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。

::: tip 注意 聚合平台兼容多渠道支付方式,不是所有支付渠道都支持回调,因此也不百分百保证每笔退款的所有状态更新都有回调
如遇遗漏情况,可通过 查询退款 主动查询并刷新状态
:::

回调公共参数

详见 公共参数->响应公共参数

事件回调参数

名称类型说明
refund_noString聚合平台退款订单号
out_refund_noString业务系统退款订单号
third_refund_idString渠道退款流水号
pay_noString聚合平台支付单号
refund_feeint申请退款金额,单位:分
refund_actual_feeint实退金额,单位:分。当支付订单使用优惠,退款时会退回等比例的优惠金额。
实退金额=申请退款金额-退还优惠金额
refund_service_feeint退回手续费,单位:分
refund_discount_feeint退回优惠金额,单位:分
feeint支付订单金额,单位:分
refund_timeString退款时间
refund_succ_timeString退款成功时间
refund_descString退款描述
paymentString支付方式
statusString退款状态

回复参数

业务方接收到请求后,根据自身系统处理结果,返回平台纯字符串结果值,无需签名。

返回值如非"SUCCESS",平台将继续按策略重试发送通知。

返回结果说明
SUCCESS处理成功,平台收到此结果后不再进行后续通知
FAIL或其他字符处理不成功,平台将重试发送通知