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

    • 接口介绍

      •POST
      •支付后，抖音侧调用第三方服务商接口推送用户下单消息，返回结果。服务商应通过前置可购校验来尽可能保证此接口成功。如果失败，抖音侧将会重试12次，每次间隔1min。如果最终失败，用户侧可能会继续进行预约操作，服务商如果超时不接单会触发用户自动退款。
      •购券创单：biz_type=1

    基本信息

    Scope
    life.capacity.trip_order_create
    权限要求
    景区行业解决方案-景区创建订单
    回调场景
    景区创建订单

    请求参数

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    order_id
    string
    是
    否
    抖音订单ID，biz_type=1时标识券订单ID，biz_type=2时代表预约订单ID
    account_id
    string
    是
    否
    商家ID
    coupon_order_id
    string
    否
    否
    抖音券订单ID，biz_type=1时无需关注，biz_type=2时代表券订单ID
    product_id
    string
    是
    否
    抖音的商品ID，预售品
    product_out_id
    string
    否
    否
    第三方商品ID，预售品
    sku_id
    string
    是
    否
    抖音商品规格ID
    sku_out_id
    string
    否
    否
    外部商品规格ID
    biz_type
    int32
    是
    否
    业务类型：1-团购，3-团购在线预约
    order_type
    int32
    是
    否
    订单类型：1-券订单
    remark
    string
    否
    否
    备注要求
    amount
    struct
    是
    否
    金额信息
    - origin_amount
    int64
    是
    否
    原始金额，单位分
    - pay_amount
    int64
    是
    否
    用户支付金额，单位分
    - currency
    string
    是
    否
    货币类型(默认人民币CNY)
    create_order_time_unix
    int64
    是
    否
    订单创建时间 时间戳（秒）
    count
    int32
    否
    否
    购买/预约份数
    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
    否
    失败原因
    .order_out_id
    string
    是
    第三方订单号，成功时必须填写