抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 酒店日历房接口
  • 酒店静态信息匹配/创建/更新能力
  • 酒店静态信息自助获取能力
  • 代理商-酒店静态信息自助获取
  • 物理房型静态信息匹配/创建/更新
  • 物理房型静态信息自助获取能力
  • 物理房型上下架能力
  • 售卖房型创建/更新能力
  • 房价/房态/房量更新
  • 酒店会员管理
  • 日历房交易正向
  • 确认接单接口
  • 酒店日历房可订检查
  • 酒店创建订单
  • 酒店支付结果通知
  • 日历房上下架能力
  • 日历房线上开票
  • 入住/离店状态同步能力
  • 营销查询
  • 营销规则价格模式推送
  • 营销规则价格推送
  • 营销价量态拉取
  • 营销库存推送
  • 营销退出报名
  • 主动拉取价量态
  • 创建及修改佣金计划
  • 修改佣金计划状态
  • 根据商品查佣金计划
  • 根据佣金计划查商品
  • 日历房交易逆向
  • 营销规则推送
  • 度假行业解决方案
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

    抖音侧通知第三方支付成功。供应商交易模式为支付后创单的情况下抖音不会调用该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国际标准枚举值
    非国内大陆商家必填
    » commissions
    list<struct>
    选填
    佣金信息 (预计费数据,在能获取到的情况下返回,计费和支付是同时进行的,且有场景会延迟计费)
    »» role_type
    int
    选填
    1:达人佣金 2:服务商佣金 3:平台佣金
    »» rate
    int
    选填
    佣金率
    »» amount
    int
    选填
    佣金值分

    请求示例

    { "order_id": "1000946099201940764", "order_out_id": "BYGB3lwzZQ", "biz_type": 2021, "pay_time_unix": 1682006400, "currency": "CNY", "commissions": [ { "role_type": 1, "rate": 8022, "amount": 1000 } ] }

    响应参数

    参数名称
    参数类型
    必须参数
    备注
    » error_code
    int
    必填
    错误码详见
    » description
    string
    选填
    描述信息
    » hotel_confirm_number
    string
    选填
    订单确认时必填
    » confirm_mode
    int
    选填
    通过后接单方式
    1:同步接单,需要返回hotel_confirm_number和confirm_result
    2:异步接单
    抖音订单为支付态,待三方回调 (
      1.确认接单接口(OpenAPI))
    » confirm_result
    int
    选填
    1:接单
    2:拒单

    响应示例

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