抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 下单确认(待下线)
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 抖音侧向服务商发起下单前确认,服务商需告知抖音侧当前条件下是否可下单。

    使用限制

    无

    接口说明

    1、抖音侧向服务商发起下单前确认,服务商需告知抖音侧当前条件下是否可下单。
    2、接口请求成功时务必确保返回的 error_code=0,确认的结果通过 result 字段返回。
    3、不可下单情况需要服务商返回原因,定义了 9 种失败原因,枚举为 fail_code 字段,如果不在这 9 种原因内,服务商返回 fail_code=10,并且用 other_fail_msg 附加失败原因。
    4、SPI 响应超时时间为 8s,超过 8s 则为无效响应。
    5、如果第三方响应不规范或者响应超时,抖音默认允许下单,会走后续链路。

    基本信息

    HTTP URL
    地址由服务商提供
    HTTP Method
    POST
    申请权限
    三方码发布
    权限要求
      •需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案
      •需要url配置,路径:见下方“服务商/商家侧SPI接口配置”
      •需要商家授权,路径:抖音来客>店铺管理>服务应用授权

    服务商/商家侧 SPI 接口配置

    配置路径:开放平台 - 服务商平台/开发者平台 - 控制台 - 应用详情页 - 开发设置 - SPI 回调。
    需配置接口:
    接口
    回调场景(配置SPI回调地址时可见)
    需提供信息
    是否必填
    预下单
    抖音请求三方系统预下单
    回调地址:预下单URL
    必填
    下单确认
    抖音请求三方系统预下单校验
    回调地址:订单确认URL
    可选
    发券
    抖音请求三方系统发码
    回调地址:发券URL
    必填
    退款
    抖音请求三方系统退款审核
    回调地址:退款URL
    必填
    信息同步
    抖音向三方系统同步退款信息
    回调地址:信息同步URL
    必填

    签名规则

    签名规则参考查看 这个地址 的说明。

    请求头

    地址由服务商提供。

    请求参数

    Body 请求

    参数名称
    参数类型
    参数描述
    必需
    count
    int
    发码数量
    是
    sku_id
    string
    抖音的商品ID
    是
    third_sku_id
    string
    三方服务商侧的商品ID
    是
    amount
    object
    金额信息
    否
    .original_amount
    int
    原始金额,单位分(不建议用)
    否
    .actualoriginalamount
    int
    原始金额,单位分(建议用)
    否
    .pay_amount
    int
    实付金额,单位分
    否
    .ticket_amount
    int
    平台营销金额,单位分
    否
    .merchant_ticket_amount
    int
    商家营销金额,单位分
    否
    .discountamount
    int
    平台和商家优惠总金额,单位分(不包含支付优惠)
    否
    contact
    object
    已弃用,联系人信息
    否
    .name
    string
    姓名
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    .phone
    string
    联系电话
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    tourists
    list(object)
    出行人信息
    否
    .name
    string
    姓名
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    .phone
    string
    联系电话
    *非酒旅/票务场景,2024年2月29日起脱敏
    否
    .id_card
    string
    身份证号码
    *非酒旅/票务场景,2024年2月29日起脱敏
    否

    请求示例

    { "count": 2, "sku_id": "23456", "third_sku_id": "345678", "amount": { "original_amount": 10000, "pay_amount": 8000, "ticket_amount": 1000, "merchant_ticket_amount": 1000 }, "contact": { "name": "张三", "phone": "13800000000" }, "tourists": [ { "name": "张三", "phone": "13800000000", "id_card": "310115199807013370" }, { "name": "李四", "phone": "13900000000", "id_card": "310115199912130020" } ] }

    响应参数

    字段名称
    字段类型
    字段描述
    data
    struct
    ​
    .error_code
    int64
    接口错误码,响应返回必须保证是0
    .description
    string
    接口错误描述
    .result
    int32
    确认结果. 1:允许下单,2:不可下单
    .fail_code
    int32
    如果不可下单,返回原因code(枚举见下表)
    .other_fail_msg
    string
    如果不可下单的原因不在枚举范围内,用该字段返回原因

    响应示例

    正常示例

    { "data": { "error_code": 0, "description": "success", "result": 1, "fail_code": 0, "other_fail_msg": "" } }

    异常示例

    { "data": { "error_code": 10, "description": "success", "result": 1, "fail_code": 0, "other_fail_msg": "" } }

    错误码

    HTTP 状态码(error_code)
    错误码(fail_code
    描述
    排查建议
    请求成功返回 0
    1
    商品不存在
    确认商品信息及状态是否准确
    2
    商品已下架
    确认商品信息及状态是否准确
    3
    商品库存不足
    确认商品库存状态是否准确
    4
    商品周期库存不足
    确认商品库存状态是否准确
    5
    商品限购不足
    确认商品信息及状态是否准确
    6
    商品周期限购不足
    确认商品信息及状态是否准确
    7
    锁库存失败
    确认商品库存状态是否准确
    8
    商户不存在
    确认商户账户信息及状态是否正确
    9
    商户异常
    确认商户账户信息及状态是否正确
    10
    其他异常(服务商自定义)
    服务商自行排查
    ​