抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店日历房常见枚举值列表
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 物理房型静态信息匹配/创建/更新
  • 营销规则价格推送
  • 物理房型上下架能力
  • 主动拉取价量态
  • 营销退出报名
  • 营销价量态拉取
  • 营销规则推送
  • 营销库存推送
  • 日历房线上开票
  • 日历房上下架能力
  • 营销规则价格模式推送
  • 营销查询
  • 入住/离店状态同步能力
  • 日历房交易正向
  • 确认接单接口
  • 酒店日历房可订检查SPI
  • 酒店创建订单
  • 酒店支付结果通知SPI
  • 酒店修改订单SPI
  • 酒店会员管理
  • 日历房交易逆向
  • 售卖房型创建/更新能力
  • 物理房型静态信息自助获取能力
  • 房价/房态/房量更新
  • 代理商-酒店静态信息自助获取
  • 酒店账单详情查询
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购三方码方案
  • 综合
  • 能力
  • 历史版本文档（不推荐）

    • 接口说明

    抖音侧通知第三方支付成功。供应商交易模式为支付后创单的情况下抖音不会调用该 SPI

    基本信息

    Scope
    life.capacity.trip_trade_order
    权限要求
    酒店日历房解决方案-正向交易
    回调场景
    酒店支付结果通知

    请求头

      •Content-Type：application/json
      •X-Bytedance-Logid: 请求 logid， 用于问题排查用
      •x-life-clientkey: 服务商应用的 client_key

    请求体

    参数名称
    参数类型
    必须参数
    备注
    » order_id
    string
    选填
    抖音侧订单 ID
    » order_out_id
    string
    选填
    第三方订单 ID
    » biz_type
    int
    必填
    2011：酒店预售券 2012:酒店预约单 2021:日历房
    » pay_time_unix
    int
    选填
    支付时间戳，秒
    » currency
    ​
    string
    选填
    ​
    价格币种，CNY，USD国际标准枚举值
    非国内大陆商家必填

    请求示例

    {
    "order_id": "1000946099201940764",
    "order_out_id": "BYGB3lwzZQ",
    "biz_type": 2021,
    "pay_time_unix": 1682006400,
    "currency": "CNY"
}

    响应参数

    参数名称
    参数类型
    必须参数
    备注
    » error_code
    int
    必填
    错误码详见
    » description
    string
    选填
    描述信息
    » hotel_confirm_number
    string
    选填
    订单确认时必填
    » confirm_mode
    ​
    int
    ​
    选填
    订单创单后的接单方式说明：
    1、同步模式，创单接口即时返回接单或拒单结果，不适配酒店日历套餐发码场景。需要返回hotel_confirm_number和confirm_result；
    2、异步模式，抖音订单为待接单状态，商家需回调「确认接单接口」返回接单或拒单结果，酒店日历套餐发码场景需选择该方式
    » confirm_result
    ​
    int
    ​
    选填
    创单接口即时返回接单结果时必填，即confirm_mode=1时必填。
    1：接单
    2：拒单

    响应示例

    {
    "data":{
    "error_code": 0,
    "description": "success",
    "hotel_confirm_number": "test",
    "confirm_mode": 1,
    "confirm_result": 1
    }
}
    ​
    ​