抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 到综团购解决方案
  • 到综团购预约解决方案
  • 综合到店提货解决方案
  • 商品发布
  • 提货券三方码交易能力
  • 发券回调接口
  • 退款审核回调接口
  • 通知外部商家创单
  • 通知外部商家支付成功
  • 通知外部商家取消订单
  • 发券
  • 商家退款申请
  • 退款结果同步外部商家
  • 撤销核销
  • 券状态批量查询
  • 验券接口
  • 提货券抖音码交易能力
  • 商品查询
  • 线索管理解决方案
  • 历史版本文档(不推荐)
  • 使用限制

    接口说明

    抖音侧通知第三方创建提货券订单。ClientKey 维度默认配置是 抖音侧支付成功后 通知第三方创单。

    基本信息

    Scope
    life.capacity.comprehensive_retail_create_order
    权限要求
    综合到店提货解决方案 > 提货券三方码交易能力
    回调场景

    请求头

      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
    - sku_id
    string
    抖音侧规格 ID
    - product_id
    string
    抖音侧商品 ID
    1773200310436864
    - sku_out_id
    string
    第三方规格 ID
    - product_out_id
    string
    第三方商品 ID
    1773200310436864
    - count
    int
    购买份数
    3
    - unit_amount
    int
    商品单价
    10000
    amount
    struct
    金额信息,订单金额结构
    - origin_amount
    int
    订单原价=商品售卖价*购买数量
    30000
    - discount_amount
    int
    订单总优惠金额
    - pay_amount
    int
    订单总支付金额

    请求示例

    { "order_id": "123432212", "open_id": "dgyqwue2", "account_id": "739262934322", "poi_id": "42289371811", "sku_list": [{ "sku_id": "3211", "product_id": "132", "count": 1, "unit_amount": 100 }], "amount": { "origin_amount": 100, "discount_amount": 0, "pay_amount": 0 } }

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    struct
    - error_code
    int
    错误码,合法范围为 [0,999999]
    0
    - description
    string
    错误信息
    - order_id
    string
    抖音订单ID
    "10011123"
    - order_out_id
    string
    外部订单ID,创建订单成功时必填
    "1233"

    响应示例

    { "data":{ "error_code":0, "description":"success", "order_id": "123", "order_out_id": "123", } }

    错误码

    创单成功:error_code必须设置为0
    请求需要重试:error_code必须设置为300
    创单失败:error_code不能设置为0或300,参考下列错误码说明对失败原因进行分类。
    error_code
    description
    备注
    0
    success
    成功
    110
    库存不足
    130
    商品已下架
    200
    限购
    300
    ...
    抖音侧需要重试,其他错误码抖音不重试
    400~499
    其他自定义错误