抖音开放平台Logo
开发者文档
生活服务商家应用
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 预售券
  • KA核销对账
  • 日历品
  • 旅行社日历品操作
  • 旅行社日历品价量态操作
  • 旅行社日历品行业交易商家接单
  • 旅行社日历品行业交易可定检查
  • 可定检查（SPI）
  • 旅行社日历品行业交易创建订单
  • 旅行社日历品行业交易支付结果通知
  • 旅行社日历品行业交易退款成功通知
  • 旅行社日历品-订单取消通知
  • 酒旅-旅行社支付结果通知
  • 旅行社poi查询
  • 旅行社直连相关枚举&常见错误码
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档（不推荐）
    • 调用可定检查时机
      • 用户进入提单页时、刷新提单页或者点击提交订单按钮时
      a.刷新提单页是指如用户新增了一份、用了一个优惠券时，用户实付金额有变动时，会再次调用可定检查
    调用口径
      •除非商家可定检查明确返回不合法，如若服务商接口超时，则弱依赖放行

    接口说明

    可定检查
      •当且仅当明确告知可定检查失败时拒绝用户下单，其余情况默认放行

    基本信息

    Header
      •Content-Type：application/json
      •X-Bytedance-Logid: 请求 logid， 用于问题排查用
      •x-life-clientkey: 服务商应用的 client_key
    Body
    参数
    ​
    ​
    一级参数
    名称
    是否必填
    参数类型
    备注
    备注
    product_id
    抖音商品id
    否
    string
    商品id(若有第三方id可不传）
    一二三级类目
    out_id
    三方商品id
    否
    string
    商品第三方id
    ​
    biz_type
    商品类型
    是
    int
    日历套餐 3021
    ​
    actual_pay_amount
    用户支付金额
    否
    int
    用户实际支付（含支付补贴）
    ​
    merchant_discount_amount
    商家补贴金额
    否
    int
    商品补贴
    ​
    item_count
    购买份数
    是
    int
    本期只有一份
    ​
    book_start_unix
    出行开始日期
    是
    int
    秒时间戳
    ​
    book_end_unix
    出行结束日期
    是
    int
    秒时间戳
    ​
    occupancies
    出行人列表
    否
    list<struct>
    除「无需填写」的情况，其余情况必传
    以下不校验是否必传
    -license_type
    证件类型
    否
    int
    详见 旅行社直连接口返回码汇总 中的附录
    ​
    -license_id
    证件ID，加密
    否
    string
    如果选择了证件，则该证件ID必填
    ​
    -chinese_name
    中文姓名，加密
    否
    string
    勾选证件时必传
    ​
    -english_name
    英文/拼音姓名，加密
    否
    string
    勾选除身份证外的证件时必传
    ​
    -license_validity
    证件有效期
    否
    string
    勾选除身份证外的证件时必传
    ​
    -gender
    性别
    否
    int
    1-男，2-女
    ​
    -birthday
    出生年月日
    否
    string
    字段是否必填看商家在商品模版上的配置
    ​
    json示例
    ​
    {
  "product_id": "1791401504359467",
  "product_out_id": "987654321",
  "biz_type": 3021,
  "actual_pay_amount": 10,
  "item_count": 1,
  "book_start_unix": 1708624920,
  "book_end_unix": 1708714980,
  "occupancies": [
    {
      "license_type": 1,
      "license_id": "1················9",
      "chinese_name": "张恩奇",
      "license_validity": "2033-11-27",
      "gender": 1
    }
  ]
}

    响应参数

    Body
    ​
    接口出参
    ​
    一级参数
    二级参数
    名称
    是否必填
    参数类型
    备注
    data
    ​
    ​
    ​
    ​
    ​
    ​
    error_code
    返回编码
    是
    int
    错误码详见 旅行社直连相关枚举 中的（一）
    ​
    description
    描述信息
    否
    string
    接口描述
    ​
    can_buy
    是否可购买
    是
    bool
    true 可购买 false不可购买。 在error_code为0时才会生效。在本可定检查接口内，error_code不为零代表服务商系统异常而非正常业务逻辑，error_code为0时 can_buy才会生效。否则抖音内部会弱依赖服务商接口系统异常
    ​
    reason
    描述
    否
    string
    可定失败时具体原因描述
    ​
    json示例
    {
    "data": {
        "reason": "",
        "error_code": 0,
        "description": "",
        "can_buy": true
    }
}