跳到主要内容
版本:v2.0

会员变更通知

会员信息发生创建、认证、资料修改、合并等变化时,平台会向友商配置的回调地址 POST 推送会员最新数据。

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

配置方式

  1. 登录信多帮管理后台
  2. 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
  3. 选择「会员变更」事件,填写友商回调 URL
  4. 保存后,会员发生变更时将自动推送
说明
  • 回调为服务端对服务端请求,请确保 URL 公网可访问
  • 收到回调后请返回 HTTP 200
  • 请求以 表单 方式提交,其中 request_data 是一段 JSON 字符串,解析后才能读到会员内容

请求格式

字段说明
type固定值 user_info
exchange_type变更类型,见下表
request_dataJSON 字符串,解析后为下表 request_data 对象

变更场景

exchange_type 表示本次推送对应的变更类型:

场景
1创建会员(小程序进入或后台导入)
2小程序认证
3小程序修改会员信息
4小程序授权头像/昵称
5后台修改会员信息
6合并会员

请求体结构

request_data 字段

字段类型说明
uidNumber会员 ID
unionidString微信开放平台 unionid(未绑定时为空)
usernameString微信昵称
phoneString手机号
headimgurlString头像 URL

请求示例

解析 request_data 后的 JSON 示例:

{
"type": "user_info",
"exchange_type": 2,
"request_data": {
"uid": 10086,
"unionid": "oXXXX",
"username": "张三",
"phone": "13800138000",
"headimgurl": "https://example.com/avatar.jpg"
}
}
信息

上方示例为方便阅读,将解析后的完整结构展示在一起。实际 HTTP 请求中,typeexchange_typerequest_data 三个字段以表单方式提交,request_data 的值是 JSON 字符串。

接收方要求

项目要求
响应状态码返回 HTTP 200 表示接收成功
幂等同一会员可能多次变更推送,建议按 uid + exchange_type 去重
完整资料推送为精简字段;需更多会员属性时可调用 获取会员列表 主动查询

相关接口