抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 到店餐饮团购解决方案
  • 餐饮在线点单解决方案
  • 随心团解决方案
  • 订单推送
  • 订单配送
  • 订单接单
  • 订单查询
  • 订单退款
  • 结算对账
  • 门店配送设置
  • 三方码交易能力
  • 通知商家随心团订单创建SPI
  • 随心团订单未支付关单通知 Webhook
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档（不推荐）

    • 接口使用说明

      •针对三方码场景提供对应第二单锁定的三方码，商家自行锁定
      •调用路径：抖音 -> SaaS服务商

    接口使用限制

      •仅白名单商家可用
      •三方发码商家可申请加入白名单

    基本信息

    Scope
    life.trade.delivery_spi_create_order_notify
    权限要求
    三方码交易能力
    回调场景
    三方码发码商家，随心团团购商品，预约创单

    请求头

      •Content-Type：application/json
      •X-Bytedance-Logid: 请求 logid，用于问题排查用
      •x-life-clientkey: 服务商应用的 client_key

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    order_id
    string
    是
    抖音侧订单唯一ID（可作幂等键）
    100001
    open_id
    string
    是
    经过网关加密的用户唯一ID，购买人
    ​
    account_id
    string
    是
    商家ID
    ​
    poi_id
    string
    是
    抖音POI_ID（即门店id）
    ​
    sku_list
    list
    是
    订单购买商品结构
    ​
    - product_id
    string
    是
    抖音侧商品唯一 ID
    1773200310436864
    - product_out_id
    string
    否
    抖音侧绑定的外部商品 ID
    1773200310436864
    - sku_id
    string
    是
    抖音侧SKU唯一 ID
    ​
    - sku_out_id
    string
    否
    抖音侧绑定的外部skuid
    ​
    - count
    int
    是
    购买份数
    3
    - unit_amount
    int
    是
    商品的售卖价格（分）
    10000
    - item_list
    list
    是
    单品信息结构体
    ​
    -- item_product_id
    string
    否
    商品包含的单品唯一id
    ​
    -- item_product_out_id
    string
    否
    商品包含的单品外部id
    ​
    -- item_sku_id
    string
    否
    单品商品id
    ​
    -- item_sku_out_id
    string
    否
    单品外部商品id
    ​
    -- item_count
    int
    否
    购买的单品数量
    ​
    -- item_amount
    int
    否
    单品单价
    ​
    -- original_item_sku_id
    string
    否
    规格升级前 单品商品id
    ​
    -- original_item_sku_out_id
    string
    否
    规格升级前 单品外部商品id
    ​
    -- original_item_amount
    int
    否
    规格升级前 商品价格
    ​
    -- affiliated_list
    list
    是
    单品关联的小料信息结构体
    ​
    --- affiliated_sku_id
    string
    否
    小料skuid
    ​
    --- affiliated_sku_out_id
    string
    否
    小料外部skuid
    ​
    --- affiliated_count
    int
    否
    小料数量
    ​
    --- affiliated_amount
    int
    否
    小料价格
    ​
    -- deduction_info_list
    list
    否
    抵扣信息结构体
    ​
    --- amount
    int
    否
    商品对应的抵扣金额
    ​
    --- certificate_id
    string
    否
    对应的抵扣该商品的券id
    ​
    --- third_part_code
    string
    否
    如果抵扣商品的券码是三方码，返回具体三方码
    ​
    order_deduction_list
    list
    否
    订单抵扣结构体List
    ​
    - certificate_id
    string
    否
    该订单使用的抵扣的券id
    ​
    - amount
    int
    否
    该券原始售价
    ​
    - merchant_discount_amount
    int
    否
    该券售卖时用户使用的商家优惠金额
    ​
    - third_part_code
    string
    否
    如果抵扣商品的券码是三方码，返回具体三方码
    ​
    freight_amount
    int
    否
    订单维度的配送费
    ​

    请求示例

    ​

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    struct
    是
    ​
    ​
    - error_code
    int
    是
    错误码，合法范围为 [0,999999]
      •创单成功：error_code必须设置为0
      •请求需要重试：error_code必须设置为100
      •创单失败：error_code不能设置为0或100
    ​
    0
    - description
    string
    是
    错误信息
    ​
    - order_id
    string
    是
    抖音订单ID
    "10011123"
    - order_out_id
    string
    否
    外部订单ID；创单成功时，需要返回
    "1233"

    响应示例

    错误码

      •重试-最多12次
      ◦创建订单失败时，若请求未触达商家（如网络错误）或商家返回明确错误码（error_code=100）抖音会进行重试
      ◦重试策略：采用退避策略第一次间隔 5s，之后每次之间间隔 10s, 20s, 40, 60s, 60s, 60s 最多重试12次
      •幂等
      ◦为防止重试导致的重复下单，服务商可根据抖音订单 ID 做幂等处理