抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 日历票价格库存属性发布
  • 景区预订信息校验
  • 景区创建订单
  • 购券创单(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
    否
    否
    区域
    remark_info
    struct
    否
    否
    附加信息
    - QuestionAndAnswerList
    list
    否
    否
    问答列表
    -- question
    string
    否
    否
    问题
    -- answers
    list
    否
    否
    回答列表
    pay_info
    struct
    否
    否
    支付信息。支付前不传,支付后补创单时传递
    - order_source
    int32
    是
    否
    下单来源:1-抖音,2-抖省省,3-豆包。pay_info 存在时必传

    响应字段

    参数名称
    参数类型
    是否必填
    参数描述
    data
    struct
    是
    ​
    .error_code
    int32
    是
    失败错误码,失败必填
    .description
    string
    否
    失败原因
    .order_out_id
    string
    是
    第三方订单号,成功时必须填写