抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 代运营
  • 创建合作关系
  • 合作列表获取
  • 合作详情查询
  • 商服关系状态回调
  • 创建/修改佣金
  • 佣金变更记录列表
  • 佣金变更记录详情
  • 商品佣金详情
  • 佣金状态变更回调
  • 团购退款
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 商服关系状态回调

    收藏
    我的收藏

    小程序商服关系状态回调​

    当商服合作关系状态变更时,会回调开发者通知​

    使用限制

    需要先在抖音开放平台配置回调地址,配置教程:小程序配置代运营合作状态、佣金状态回调
    解决方案选择你需要配置的解决方案即可。本文以【生活服务代运营服务商解决方案】为例:​
    在解决方案配置里,选择「开环代运营消息通知能力」- 「开环代运营合作状态回调」​

    基本信息

    抖音侧回调开发者,不需要开发者主动请求​

    接口说明

      1.当商服合作关系状态变更时,会回调开发者通知​

    回调参数

    请求体

    名称​
    类型​
    描述​
    示例值​
    备注​
    order_id​
    int64​
    订单id​
    7173597169424025644​
    status​
    int32​
    订单状态​
    102​
    待商户确认 = 102​
    等待服务 = 301​
    服务中 = 302​
    订单取消 = 401​
    订单完成 = 201​
    服务商发起订单合作模式由闭环切换为开环 = 90000​
    商家接受订单合作模式由闭环切换为开环 = 90001​
    商家拒绝订单合作模式由闭环切换为开环 = 90002​
    merchant_id​
    int64​
    商家ID​
    705300094638223815​
    partner_id​
    int64​
    服务商ID​
    7077814303214028844​
    抖音林客后台获取​
    event_time​
    int64​
    事件发生的时间,毫秒时间戳​
    1673416707000​
    供开发者判断哪个事件是最新发生的​

    参数示例

    { "order_id": 7777758810506119212, "merchant_id": 8888858810506119212, "partner_id": 9999998810506119212, "status": 302, "event_time": 1684468374637 }

    生活服务应用商服关系状态回调​

    对应申请能力​

    代运营合作​

    请求头字段​

    字段
    说明
    Msg-Id​
    同一实体下同一action的msg_id相同,服务商可根据msg_id对于消息去重​
    X-Douyin-Signature​
    抖音侧签名,服务商可根据签名判断该消息是否来自抖音开放平台​
    Content-Type​
    固定值application/json​
    消息可能重复推送,请使用 Msg_Id 进行去重处理!

    请求体字段​

    字段
    类型
    说明
    event​
    string​
    消息类型,用于区分各类消息​
    client_key​
    string​
    对应服务商平台或开发者平台中的APPID,应用ID​
    content​
    string​
    消息内容,根据需要解析消息内容,不同类型的消息内容不同​
    log_id​
    string​
    抖音内部日志id,可提供给抖音方便排查问题​
      event:life_partner_order_notify​
      content内容​
    名称​
    类型​
    描述​
    示例值​
    备注​
    order_id​
    string​
    订单id​
    7173597169424025644​
    status​
    int32​
    订单状态​
    102​
    待商户确认 = 102​
    等待服务 = 301​
    服务中 = 302​
    订单取消 = 401​
    订单完成 = 201​
    服务商发起订单合作模式由闭环切换为开环 = 90000​
    商家接受订单合作模式由闭环切换为开环 = 90001​
    商家拒绝订单合作模式由闭环切换为开环 = 90002​
    merchant_id​
    string​
    商家ID​
    705300094638223815​
    partner_id​
    string​
    服务商ID​
    7077814303214028844​
    抖音林客后台获取​
    event_time​
    int64​
    事件发生的时间,毫秒时间戳​
    1673416707000​
    供开发者判断哪个事件是最新发生的​

    请求示例​

    { "event": "life_partner_order_notify", "client_key": "axxxxxxxxxxxxx", "content": "{\"status\": 401, \"order_id\": \"7187258584315758632\", \"event_time\": 1673503112000, \"partner_id\": \"7102235043199879179\", \"merchant_id\": \"7108650295156033544\"}", "log_id": "202210101930530102281180650970B5AF" }