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

    收藏
    我的收藏

    小程序佣金状态变更回调

    当佣金状态变更时,会回调开发者通知

    使用限制

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

    基本信息

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

    接口说明

      1.当商家确认或拒绝佣金配置时,会回调开发者通知。

    回调参数

    名称
    类型
    描述
    示例值
    备注
    order_id
    int64
    订单id
    7187258584315758632
    commission_record_items
    list<struct>
    商家确认或拒绝的佣金配置
    item_id
    int64
    商品维度佣金配置id
    7187269249710147617
    product_id
    int64
    商品id
    7162083332832905227
    audit_commission_ratio
    int64
    佣金比例
    3000
    单位:万分之一
    commission_audit_status
    int
    商家确认/拒绝后的佣金配置状态
    1
    详细枚举值见上文

    参数示例

    { "order_id": 7187258584315758632, "commission_record_items": [ { "item_id": 7187269249710147617, "product_id": 7162083332832905227, "audit_commission_ratio": 3000, "commission_audit_status": 1 } ] }

    生活服务应用佣金状态变更回调

    对应申请能力

    代运营佣金

    请求头字段

    字段
    说明
    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_commission_notify
      content内容
    名称
    类型
    描述
    示例值
    备注
    order_id
    string
    订单id
    7187258584315758632
    commission_record_items
    list<struct>
    商家确认或拒绝的佣金配置
    item_id
    string
    商品维度佣金配置id
    7187269249710147617
    product_id
    string
    商品id
    7162083332832905227
    audit_commission_ratio
    int64
    佣金比例
    3000
    单位:万分之一
    commission_audit_status
    int
    商家确认/拒绝后的佣金配置状态
    1
    详细枚举值见上文

    请求示例

    { "event": "life_partner_commission_notify", "client_key": "axxxxxxxxxxxxx", "content": "{\"order_id\": \"7187258584315758632\", \"commission_record_items\": [{\"item_id\": \"7187269249710147617\", \"product_id\": \"7162083332832905227\", \"audit_commission_ratio\": 3000, \"commission_audit_status\": 1}]}", "log_id": "202210101930530102281180650970B5AF" }