回调通知概述

平台在订单、团组、会员、评价等业务发生约定变更时，会向友商在开放平台订阅的回调地址发起 HTTP POST，将最新业务数据推送到合作伙伴系统。接收成功请返回 HTTP 200。

配置路径：后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅。各事件字段与示例见本分类下对应文档。

回调地址须使用 HTTPS

回调载荷中常包含订单号、会员手机号、营员证件信息等业务数据。合作伙伴用于接收推送的 URL 须为 https:// 地址，即在公网侧启用 TLS（俗称 SSL）加密传输。

要求	说明
协议	使用 https://，勿使用明文 http://
证书	由受信任 CA 签发的有效证书；生产环境避免自签名证书
协议版本	建议 TLS 1.2 及以上
可达性	URL 须公网可访问，且证书域名与回调主机名一致

明文 HTTP 下，推送内容可被中间环节窃听或篡改。回调接收地址必须使用 HTTPS，与开放平台主动接口的安全基线一致。

接收侧基本约定

• 以服务端对服务端方式接收；请保证服务稳定、可重试。
• 同一业务可能因多次变更被推送多次，请按订单号、会员 ID、事件类型等做幂等处理。
• 部分事件以表单字段 request_data（JSON 字符串）传递正文，部分为裸 JSON，以各事件文档为准。
• 处理失败时平台可能重试；成功务必返回 HTTP 200。

事件一览

文档	说明
团组变更通知	分团、分组等团组相关变更
订单变更通知	支付、退款、换营、营员变更等
拼团结束变更通知	拼团成功或失败
退款发起回调通知	退款单发起时推送
营员评价通知	营员评价相关推送
会员变更通知	会员创建与资料变更