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

    收藏
    我的收藏

    小程序佣金状态变更回调​

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

    使用限制

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

    基本信息

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

    接口说明

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