退款通知
当退款成功后,聚合支付后台会根据 申请退款 的notify_url地址,以事件通知的方式异步将退款变更结果回调给业务方。
业务方需自行实现接受逻辑处理回调信息。
业务方在接受到回调请求后,需在 5秒 内返回。如果 5秒 内收不到响应会断掉连接,并重新发起请求。平台会在12小时内,通过一定的策略(通知频率为 0s/15s/15s/30s/3m/10m/20m/30m/30/30m/1h/3h/3h/3h )间接性重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。
::: tip 注意
聚合平台兼容多渠道支付方式,不是所有支付渠道都支持回调,因此也不百分百保证每笔退款的所有状态更新都有回调
如遇遗漏情况,可通过 查询退款 主动查询并刷新状态
:::
回调公共参数
详见 公共参数->响应公共参数
事件回调参数
| 名称 | 类型 | 说明 |
|---|---|---|
| refund_no | String | 聚合平台退款订单号 |
| out_refund_no | String | 业务系统退款订单号 |
| third_refund_id | String | 渠道退款流水号 |
| pay_no | String | 聚合平台支付单号 |
| refund_fee | int | 申请退款金额,单位:分 |
| refund_actual_fee | int | 实退金额,单位:分。当支付订单使用优惠,退款时会退回等比例的优惠金额。 实退金额=申请退款金额-退还优惠金额 |
| refund_service_fee | int | 退回手续费,单位:分 |
| refund_discount_fee | int | 退回优惠金额,单位:分 |
| fee | int | 支付订单金额,单位:分 |
| refund_time | String | 退款时间 |
| refund_succ_time | String | 退款成功时间 |
| refund_desc | String | 退款描述 |
| payment | String | 支付方式 |
| status | String | 退款状态 |
回复参数
业务方接收到请求后,根据自身系统处理结果,返回平台纯字符串结果值,无需签名。
返回值如非"SUCCESS",平台将继续按策略重试发送通知。
| 返回结果 | 说明 |
|---|---|
| SUCCESS | 处理成功,平台收到此结果后不再进行后续通知 |
| FAIL或其他字符 | 处理不成功,平台将重试发送通知 |