版本：v2.0

退款发起回调通知

员工或会员在信多帮发起退款申请时，平台会向友商配置的回调地址 POST 推送退款单信息。

与订单变更的区别

本通知在退款单创建/发起时推送，表示「有人发起了退款申请」。

退款完成后的订单快照变更，请参见 订单变更通知（exchange_type 为 2/3/4 等）。

POST友商回调地址（配置路径：后台-设置-开放平台-订阅事件-添加订阅）

配置方式

登录信多帮管理后台
进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
选择「发起退款」事件，填写友商回调 URL
保存后，退款单发起时将自动推送

说明

回调为服务端对服务端请求，请确保 URL 公网可访问
收到回调后请返回 HTTP 200
请求以表单方式提交，其中 request_data 是一段 JSON 字符串，解析后才能读到退款单内容

请求格式

与 订单变更通知 相同：

字段	说明
type	固定值 `refund_start`
exchange_type	发起方类型，见下表
request_data	JSON 字符串，解析后为下表 `request_data` 对象

发起方类型

exchange_type 表示退款单由谁发起：

值	场景
1	员工发起
2	会员发起
3	系统自动生成（如拼团失败自动退款）

请求体结构

顶层字段

字段	类型	说明
type	String	固定值 `refund_start`
exchange_type	Number	发起方类型，见上表
request_data	Object	退款单信息

request_data 字段

字段	类型	说明
refund_id	Number	退款单 ID
refund_types	String	退款类型：`仅退款` / `全部退营` / `部分退营`
money	Number	现金退款金额
moneycard	Number	储值卡退款金额
desc	String	退款原因
order_id	String	订单 ID
ordernum	String	订单号
addtime	String	退款单创建时间，如 `2025-09-30 14:54:09`

请求示例

{
  "type": "refund_start",
  "exchange_type": 2,
  "request_data": {
    "refund_id": 111,
    "refund_types": "仅退款",
    "money": 0.00,
    "moneycard": 1.98,
    "desc": "十天无理由退款",
    "order_id": "38495",
    "ordernum": "NO20250929161905256483",
    "addtime": "2025-09-30 14:54:09"
  }
}

接收方要求

项目	要求
响应状态码	返回 HTTP 200 表示接收成功
幂等	建议按 `refund_id` 去重
后续同步	退款审核/完成后，可通过 `订单变更通知` 或 `查询订单` 获取最新订单状态

配置方式​

请求格式​

发起方类型​

请求体结构​

顶层字段​

request_data 字段​

请求示例​

接收方要求​

相关接口​