抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 预售券确认接单
  • 预售券查询订单poi
  • 预售券价量态-更新预售商品价库及属性
  • 预售券价量态-获取预售券商品价量态
  • 酒旅日历房解决方案
  • 通用能力
  • 接入前准备
  • 预售券确认接单

    收藏
    我的收藏

    接口说明

    抖音侧通知第三方支付成功后,第三方需要在商品上单中设置的接单时间内通知抖音侧接单结果,超时会拒单。采用异步确认。

    基本信息

    名称
    描述
    HTTP URL
    HTTP Method
    POST
    Scope
    life.capacity.trip_travel_confirm
    权限要求
    确认接单能力申请

    请求头

    名称
    类型
    必填
    描述
    content-type
    string
    是
    固定值 "application/json"
    access-token
    string
    是
    调用/oauth/client_token/生成的 token,此 token 不需要用户授权。示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******

    请求参数

    Body

    接口入参
    ​
    一级参数
    二级参数
    三级参数
    四级参数
    名称
    是否必填
    参数类型
    备注
    » order_id
    ​
    ​
    ​
    抖音侧订单号
    是
    ​
    ​
    » source_order_id
    ​
    ​
    ​
    预约订单归属的预售订单ID
    是
    string
    ​
    » confirm_info
    ​
    ​
    ​
    确认信息
    是
    struct
    ​
    ​
    »» confirm_result
    ​
    ​
    确认订单结果
    是
    int
    1:接单 2:拒单
    ​
    »» reject_code
    ​
    ​
    拒单原因
    否
    enum
    1: 库存已约满 2:商品需加价 3:无法满足顾客需求
    ​
    »» hotel_info
    ​
    ​
    境内住宿类目预定信息
    否
    struct
    境内住宿类目/酒景套餐 必填
    ​
    ​
    »»» poi_info
    ​
    ​
    是
    list<struct>
    酒店poi信息,目前只支持1个poi信息
    ​
    ​
    ​
    »»»»poi_id
    poiid
    是
    string
    poiid必须为订单关联的poi
    ​
    ​
    »»» room_items
    ​
    ​
    是
    list<struct>
    ​
    ​
    ​
    ​
    »»»»room_type
    酒店房型
    是
    string
    ​
    ​
    ​
    ​
    »»»»meals
    含早类型
    是
    int
    1-无早 2-含单早 3-含双早 4-含早
    ​
    »» play_info
    ​
    ​
    境内游玩类目预定信息
    否
    struct
    境内游玩类目必填
    ​
    ​
    »»»entrance_types
    ​
    入园方式
    是
    list<int>
    1-二维码 2-券号 3-身份证(同时需填写name)
    ​
    ​
    »»»show_certs
    ​
    入园展示凭证信息
    是
    list<struct>
    list最大容量为商品上实际出行人数
    ​
    ​
    ​
    »»»»name
    用户姓名(无需加密)
    否
    string
    ​
    ​
    ​
    ​
    »»»»card_no
    证件号(无需加密)
    否
    string
    ​
    ​
    ​
    ​
    »»»»cert_no
    券号(无需加密)
    否
    string
    ​
    ​
    ​
    ​
    »»»»qr_code_image
    二维码图片
    否
    string
    原始图片的二进制流的base64编码的字符串
    ​
    ​
    »»» poi_info
    ​
    ​
    是
    list<struct>
    景区poi信息
    ​
    ​
    ​
    »»»»poi_id
    poiid
    是
    string
    poiid必须为订单关联的poi
    ​
    ​
    »»»book_start_time
    ​
    入园时段
    否
    string
    入园时段 格式:12:00
    ​
    ​
    »»»book_end_time
    ​
    离园时段
    否
    string
    离园时段 格式:13:00
    ​
    »» free_travel_info
    ​
    ​
    境内自由行类目预定信息
    否
    list<struct>
    自由行类目必填
    ​
    ​
    »»»travel_num
    ​
    行程天数
    是
    struct
    ​
    ​
    ​
    ​
    »»»»day_num
    天数
    是
    int
    天数必须大于晚数
    ​
    ​
    ​
    »»»»night_num
    晚数
    是
    int
    天数必须大于晚数
    ​
    ​
    »»»oneday_tour_list
    ​
    每日行程
    是
    list<struct>
    对应自由行一日行程
    ​
    ​
    ​
    »»»»sequence
    行程序号
    是
    int
    第x天,要保证不重复且连续覆盖完整的行程天数
    ​
    ​
    ​
    »»»»hotel_info_list
    住宿列表
    否
    list<hotel_info>
    参见hotel_info定义
    ​
    ​
    ​
    »»»»play_info_list
    景点列表
    否
    list<play_info>
    参见play_info定义
    ​
    »» extra_msg
    ​
    ​
    其他注意事项
    否
    string
    纯文本,上限200字
    ​

    响应参数

    接口出参
    一级节点
    二级节点
    名称
    是否必填
    参数类型
    说明
    »data
    ​
    ​
    是
    string
    ​
    ​
    »» error_code
    错误码
    是
    string
    ​
    ​
    »» description
    错误描述
    否
    string
    ​
    ​
    »» order_out_id
    第三方订单ID
    否
    string
    ​
    ​
    »» order_id
    抖音订单ID
    否
    string
    ​

    错误码

    HTTP 状态码
    错误码
    描述
    排查建议
    ​
    3000001
    ...
    ​
    ​
    3000007
    操作无权限
    ​
    ​
    4000002
    参数不合法
    ​
    ​
    5000002
    操作频繁,请稍后再试
    ​
    ​