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

拼团结束变更通知

拼团活动结束后，平台会向友商配置的回调地址 POST 推送本次拼团的最终结果（成团了，还是没成团）。

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

配置方式​

  1. 登录信多帮管理后台
  2. 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
  3. 选择「拼团结束」事件，填写友商回调 URL
  4. 保存后，拼团活动结束时会自动推送
其他说明
  • 回调为服务端对服务端请求，请确保 URL 公网可访问
  • 收到回调后请返回 HTTP 200
  • 请求以 表单 方式提交，其中 request_data 是一段 JSON 字符串，需要先解析再使用

请求格式​

字段说明
type固定值 team_end
exchange_type1 拼团成功；2 拼团失败（到期未成团）
request_dataJSON 字符串，解析后见下表

request_data 字段说明​

字段类型说明
team_idString拼团活动 ID，同一活动多次推送时用这个去重
addtimeString拼团创建时间，如 2025-09-17 10:34:17
overtimeString本次推送时间
team_numberString实际参团人数
team_max_numberString成团人数要求
team_order_listArray参与本次拼团的订单列表

team_order_list[] — 拼团内的订单​

字段类型说明
order_idString订单 ID
numberNumber该订单购买数量
ordernumString订单号

请求示例​

拼团成功​

{
  "type": "team_end",
  "exchange_type": 1,
  "request_data": {
    "team_id": "623",
    "addtime": "2025-09-17 10:34:17",
    "overtime": "2025-09-28 10:34:18",
    "team_number": "2",
    "team_max_number": "2",
    "team_order_list": [
      {
        "order_id": "37796",
        "number": 1,
        "ordernum": "NO20250513155332908614"
      },
      {
        "order_id": "37797",
        "number": 1,
        "ordernum": "NO20250513164801305841"
      }
    ]
  }
}

拼团失败​

{
  "type": "team_end",
  "exchange_type": 2,
  "request_data": {
    "team_id": "624",
    "addtime": "2025-09-17 10:34:17",
    "overtime": "2025-09-28 10:34:18",
    "team_number": "1",
    "team_max_number": "2",
    "team_order_list": [
      {
        "order_id": "37796",
        "number": 1,
        "ordernum": "NO20250513155332908614"
      }
    ]
  }
}

接收方要求​

项目要求
响应状态码返回 HTTP 200 表示接收成功
去重同一 team_id 只会结束推送一次，建议按 team_id 做幂等
后续处理成功时可按订单列表同步状态；失败时可能伴随退款，也可关注 订单变更通知

相关接口​