抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店静态信息匹配/创建/更新
  • 酒店静态信息自助获取
  • 物理房型静态信息匹配/创建/更新
  • 物理房型静态信息自助获取
  • 物理房型上下架
  • 房价/房态/房量更新
  • 主动拉取价量态
  • 住宿预售券交易正向
  • 支付结果通知
  • 确认接单接口
  • 可订检查
  • 创建预售订单
  • 创建预约订单
  • 预售券线上开票
  • 酒店会员管理
  • 住宿预售券创建和更新
  • 酒旅商品上架和下架信息推送
  • 住宿预售券交易逆向
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

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

    基本信息

    Scope
    life.capacity.trip_trade_order
    权限要求
    住宿预售券交易正向能力
    Header
      Content-Type:application/json
      X-Bytedance-Logid: 请求 logid, 用于问题排查用
      x-life-clientkey: 服务商应用的 client_key
    Body
    参数名称
    参数类型
    必须参数
    备注
    » 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
    选填
    佣金值分
    » remark_from_douyin
    string
    选填
    仅预约单创单支付通知结果赋值
    抖音平台备注
    格式 权益订单、抖音预售券订单id:xxx、商品名称(预售券名称):xx、原始金额:x元、加价金额:x元、实付金额:x元、商家应收金额:x元、商品搭配:xxx (住:x选x+房型名称、餐:全部可选或x选x+餐食内容、享/礼遇:全部可选或x选x+内容)、权益内容、Order from douyin 币种
    » origin_amount
    int
    选填
    预售券原始金额,取值为商品售价,单位分
    仅预约单创单支付通知结果赋值
    » add_amount
    int
    选填
    取加价金额的应付原始金额,单位分
    仅预约单创单支付通知结果赋值
    » pay_amount
    int
    选填
    预售券实付金额 + 预约单加价实付金额,单位分
    仅预约单创单支付通知结果赋值
    » merchant_receivable_amount
    int
    选填
    预售券原始金额 + 加价原始金额 - 商家补贴,单位分
    仅预约单创单支付通知结果赋值
    json示例
    { "order_id": "1000946099201940764", "order_out_id": "BYGB3lwzZQ", "biz_type": 2011, "pay_time_unix": 1682006400, "currency": "CNY", "commissions": [ { "role_type": 1, "rate": 8022, "amount": 1000 } ], "origin_amount": 100, "add_amount":30, "pay_amount": 80, "merchant_receivable_amount": 90 }

    响应参数

    预售券无接单,支付通知之后只要ack默认成功
    Body
    参数名称
    参数类型
    必须参数
    备注
    » error_code
    int
    必填
    错误码详见
    » description
    string
    选填
    描述信息
    » hotel_confirm_number
    string
    选填
    订单确认时必填
    » confirm_mode
    int
    选填
    通过后接单方式
    1:同步接单,需要返回hotel_confirm_number和confirm_result
    2:异步接单
    抖音订单为支付态,待三方回调 接单接口
    » confirm_result
    int
    选填
    1:接单
    2:拒单
    json示例
    { "data":{ "error_code": 0, "description": "success", "hotel_confirm_number": "test", "confirm_mode": 1, "confirm_result": 1 } }