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

    收藏
    我的收藏

    小程序商服关系状态回调

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

    使用限制

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

    基本信息

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

    接口说明

      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" }