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

订单变更通知

当订单发生支付、退款、换营、营员变更、更换会员、合并/拆分等变化时，平台会向友商配置的回调地址 POST 推送订单最新数据。

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

配置方式​

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

请求格式​

字段说明
type固定值 order_info，表示「订单变更」
exchange_type变更类型，见下表
request_dataJSON 字符串；内容与 获取订单 返回的单条订单基本一致，并额外包含营员报名表 student_info_list

变更场景​

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

值场景
1支付成功
2退款完成（不退营）
3退款完成（全部退营）
4退款完成（部分退营）
5更换营完成
6订单营员变更
7修改订单价格
8结营
9订单归属变更
10订单人数变更
11绑定差价
12解绑差价
13订单审核修改价格
14电子合同签署成功
15订单合并（其他订单合并到此订单）
16订单合并取消（此订单被合并且取消）
17订单被拆分（此订单被拆分金额）
18拆分生成新订单
19更换会员

请求体结构​

顶层字段​

字段类型说明
typeString固定值 order_info
exchange_typeString变更类型，见上表
request_dataObject订单完整快照数据

request_data — 订单数据​

request_data 内的订单快照字段（基础信息、优惠字段、拼团、拆单/合并、营员、换营、支付/退款/备注、团组、连报等）与 获取订单 返回结构一致，完整说明见 订单数据结构。回调额外包含营员报名表 student_info_list，见下。

request_data — 营员报名表 student_info_list[]​

动态表单字段数组，每项结构：

字段类型说明
nameString字段标识（部分项可能无）
typeString控件类型：text / radio / select / date / file
titleString字段标题
valueString字段值
true_data_valueString真实值（部分字段）

请求示例​

精简示例（支付成功）​

{
  "type": "order_info",
  "exchange_type": "1",
  "request_data": {
    "order_id": 1111,
    "ordernum": "NO20230511203452547280",
    "pid": 1,
    "period_id": 2,
    "product_name": "营种名称",
    "period": "2023/05/18-2023/05/19",
    "status": "已支付",
    "number": "2",
    "user_phone": "13683106368",
    "user_name": "张三",
    "have_pay": 1200,
    "students": [
      {
        "sid": "16516",
        "name": "吴念一",
        "phone": "139571411111",
        "idcard_type": "1",
        "idcard": "330105201******"
      }
    ],
    "pay_list": [
      {
        "addtime": "2023-05-11 20:34:52",
        "money": "1200.00",
        "moneycard": "0.00",
        "tranction_id": "4200001234567890"
      }
    ]
  }
}
完整请求示例（含拼团、拆单、换营、连报等字段）
{
  "type": "order_info",
  "exchange_type": "1",
  "request_data": {
    "order_id": 1111,
    "pid": 1,
    "period_id": 2,
    "extra_product_id": 11111,
    "ordernum": "NO20230511203452547280",
    "user_phone": "13683106368",
    "user_name": "哈哈",
    "user_idcard": "412723198902186826",
    "unionid": "oXXXX",
    "product_name": "营种名称",
    "current_product_name": "最新营种名称",
    "sign_pdf_title": "测试电子签章",
    "sign_pdf_url": "https://signature.cdn.xinduobang.cn/sign20250908115156342589177199.pdf",
    "team_id": 1222,
    "team_status": 2,
    "team_order_list": [
      { "order_id": "38461", "number": "2", "ordernum": "NO202509281057510542711" }
    ],
    "cut_order_info": {
      "master_order_id": 0,
      "cut_order_id": 0,
      "order_num": "NO202509281057510542711"
    },
    "merge_order_info": {
      "master_order_id": "38656",
      "be_merge_order_id": "38651",
      "order_num": "NO202509281057510542711"
    },
    "sku_str": "默认规格",
    "period": "2023/05/18-2023/05/19",
    "createtime": "2023-05-11 20:34:52",
    "number": "2",
    "status": "已支付",
    "unit_price": "600.00",
    "order_price": 1200,
    "discount_money": 150,
    "discount_list": [
      { "field": "full_reduction_money", "name": "满减优惠", "price": 50 },
      { "field": "agio_money", "name": "VIP折扣", "price": 100 }
    ],
    "have_pay": 1200,
    "have_pay_moneycard": "800.00",
    "students": [
      {
        "sid": "16516",
        "name": "吴念一",
        "phone": "139571411111",
        "idcard_type": "1",
        "idcard": "330105201******",
        "height": "150",
        "weight": "47.00",
        "birthday": "2015-12-26",
        "size": "100"
      }
    ],
    "exchenge_list": [
      {
        "old_pid": "345",
        "old_period_id": "714",
        "old_pname": "2026夏·少年常青藤夏校",
        "old_period": "2026/07/18-2026/07/27",
        "new_pid": "345",
        "new_period_id": "727",
        "new_pname": "2026夏·少年常青藤夏校",
        "new_period": "延期",
        "addtime": "2026-07-08 15:47:50"
      }
    ],
    "remarks_list": [
      { "content": "备注内容", "addtime": "2023-05-15 10:23:17" }
    ],
    "refund_list": [
      {
        "team_id": 0,
        "addtime": "2023-05-11 20:34:52",
        "money": "0.00",
        "moneycard": "800.00",
        "refund_types": "全部退营",
        "refund_id": 111,
        "desc": "退款原因"
      }
    ],
    "pay_list": [
      {
        "addtime": "2023-05-11 20:34:52",
        "money": "0.00",
        "moneycard": "800.00",
        "tranction_id": "1111111"
      }
    ],
    "cut_group_info": {
      "team_name": "1团",
      "team_nick_name": "背提2期",
      "group_name": "19组",
      "group_id": "513"
    },
    "student_info_list": [
      { "name": "gender", "type": "radio", "title": "性别", "value": "男" },
      { "name": "phone", "type": "text", "title": "手机号", "value": "13714132168" }
    ],
    "more_count": 2,
    "more_all_pay": "0.01",
    "more_all_pay_moneycard": "0.01",
    "more_info_list": [
      {
        "order_id": "38109",
        "ordernum": "NO20250729133708420538",
        "pname": "xmw测试-暑假集训营(多期)",
        "period": "2025/08/11-2025/08/18",
        "have_pay": "0.01"
      }
    ]
  }
}

接收方要求​

项目要求
响应状态码返回 HTTP 200 表示接收成功
幂等同一订单可能因多次变更重复推送，请按 order_id + exchange_type 去重
时效收到回调后请尽快同步更新友商侧订单数据

相关接口​