抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购（在线预约）
  • 日历票价格库存属性发布
  • 景区预订信息校验
  • 可购校验（SPI）
  • 景区创建订单
  • 景区确认订单
  • 景区退款审核
  • 景区回调审核退款
  • 景区退款结果通知
  • 景区订单状态查询
  • 三方码发布
  • 景区团购三方码方案
  • 景区行业团购|在线预约解决方案
  • 综合
  • 历史版本文档（不推荐）

    • 接口说明

      •POST
      •用户提交订单后，支付前，抖音侧调用第三方服务商接口进行可订检查，包括库存和限购规则等，保障消费者提交订单后不会因为库存不足或其他业务规则被拒单

    基本信息

    Scope
    life.capacity.trip_order_can_buy
    权限要求
    景区行业解决方案-景区预订信息校验
    回调场景
    景区预订信息校验

    请求参数

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    account_id
    string
    是
    否
    商家ID
    product_id
    string
    是
    否
    抖音的商品ID
    product_out_id
    string
    否
    否
    第三方商品ID
    sku_id
    string
    是
    否
    抖音商品规格ID，目前只有1个ID
    sku_out_id
    string
    否
    否
    外部商品规格ID，目前只有1个ID
    count
    int32
    是
    否
    购买份数
    biz_type
    int32
    是
    否
    业务类型：1-团购，2-日历票，3-团购在线预约
    amount
    struct
    是
    否
    金额信息
    - origin_amount
    int64
    是
    否
    原始金额，单位分
    - pay_amount
    int64
    是
    否
    用户支付金额，单位分
    - currency
    string
    是
    否
    货币类型(默认人民币CNY)
    buyer
    struct
    否
    否
    联系人信息
    - name
    string
    否
    是
    姓名
    - phone
    string
    否
    是
    联系电话
    tourists
    list<struct>
    否
    否
    游玩团购线下预约场景选填
    - name
    string
    否
    是
    姓名，加密
    - phone
    string
    否
    是
    联系电话，加密
    - license_type
    int
    否
    否
    证件类型1 身份证2 港澳通行证3 台湾通行证4 回乡证5 台胞证6 护照
    - license_id
    string
    否
    否
    证件 ID，加密
    - en_first_name
    string
    否
    否
    英文名first name
    - en_last_name
    string
    否
    否
    英文名last name
    - email
    string
    否
    否
    电子邮箱
    traveler_info
    object
    否
    否
    出行人群（对应商品 crowds），游玩团购线上预约场景选填
    -total_num
    int32
    是
    否
    出行人数
    -diff_target_crowd
    bool
    是
    否
    是否区分人群
    -crowd_list
    list
    否
    否
    人群列表
    --crowd_type
    int32
    是
    否
    人群类型 Child=1 儿童 Adult=2 成人 Old=3 老人Student=4 学生Special=5 特殊人群Male=6 男士Female=7 女士Group=8 团体Couple=9 情侣Military = 10 军人 Teacher = 11 教师 Disabled = 12 残疾
    --traveler_num
    int32
    是
    否
    此人群的适用人数
    appointment_rule
    object
    否
    否
    预约规则（线上预约时返回），游玩团购线上预约场景选填
    - ahead_day
    int32
    否
    否
    需要提前X天预约
    - ahead_sec
    int64
    否
    否
    预约提前时间（单位：秒）. i.e. 20:00点前预约，值为 72000
    - part_appointment
    bool
    否
    否
    是否支持分开预约
    - open_time_period
    object
    否
    否
    日开放预约时间
    -- start_time
    string
    否
    否
    起始时间
    -- end_time
    string
    否
    否
    结束时间
    appointment_cancel_rule
    object
    否
    否
    预约取消规则，游玩团购线上预约场景选填
    - cancel_type
    int32
    否
    否
    取消类型，2 不可取消，4 限时取消（按规则） ，5 未用随时取消
    - cancel_detail_list
    list<object>
    否
    否
    取消规则明细
    -- max_cancel_time
    object
    否
    否
    最晚取消时间
    --- day
    int32
    否
    否
    天
    --- hour
    int32
    否
    否
    小时
    --- minute
    int32
    否
    否
    分
    ticket_rule
    struct
    否
    否
    票务规则，包含凭证方式、券码类型、券码服务商，游玩团购线上预约场景选填
    - code_sending_info
    list<int32>
    是
    否
    凭证发放方式，多选（建议全部写入list，凭证回调时，如果有额外类型的凭证会报错）
    1 身份证件
    2 券号
    3 券码
    6 链接URL
    - code_type
    int32
    是
    否
    券码类型，日历票 code_type=2
    - url_type
    int32
    否
    否
    如果code_sending_info=6 凭证类型为url，则必填
    ticket_specification
    struct
    否
    否
    预约下单参数，票种规格说明，游玩团购线上预约场景选填
    - ticket_session
    struct
    否
    否
    场次
    -- ticket_session_name
    string
    是
    否
    名称
    -- ticket_session_time
    string
    否
    否
    时间
    - ticket_seat
    string
    否
    否
    坐席
    - ticket_area
    string
    否
    否
    区域

    响应字段

    参数名称
    参数类型
    是否必填
    参数描述
    data
    struct
    是
    ​
    .error_code
    int32
    是
    请求失败时返回的业务错误标识码（错误发生时必传）
    .description
    string
    否
    失败原因

    错误码说明

    error_code
    description
    ​
    0
    成功
    ​
    1
    商品不存在
    ​
    2
    商品已下线
    ​
    3
    未到商品开始售卖时间
    ​
    4
    已过商品结束售卖时间
    ​
    5
    商品库存售罄
    ​
    6
    已达到购买上限
    ​
    7
    价格校验失败
    ​
    100
    其他异常，需要重试
    期票预售场景无此错误码