抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 景区行业解决方案
  • 景区创建订单
  • 景区订单状态查询
  • 景区回调审核退款
  • 景区履约验券
  • 景区确认订单
  • 景区取消订单通知
  • 通知取消订单(SPI)
  • 景区退款结果通知
  • 景区退款审核
  • 景区支付通知
  • 景区预订信息校验
  • 日历票价格库存属性发布
  • 日历票商品查询
  • 三方码发布
  • 日历票商品发布
  • 团购核销
  • 门店管理
  • 景区日历票商品类目
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明

    抖音侧通知第三方取消订单,仅对未核销订单,当用户退款或取消订单时会通知。
    通知类型的接口 请勿返回业务类型的错误(譬如订单不存在),返回系统类型的错误抖音侧可以重试。

    基本信息

    Scope
    life.capacity.trip_order_cancel_notify
    权限要求
    景区行业解决方案-景区取消订单
    回调场景
    抖音侧通知第三方取消景区订单

    请求头

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

    请求参数

    名称
    类型
    是否必填
    描述
    示例值
    order_id
    string
    抖音侧订单 ID
    100001
    order_out_id
    string
    第三方订单 ID
    200001
    cancel_type
    int
    取消类型,1 抖音侧支付前取消,2 抖音侧支付后取消,3 第三方创单失败
    1
    cancel_order_time_unix
    int
    取消订单的时间戳,秒
    1678859379

    请求示例

    响应参数

    名称
    类型
    是否必填
    描述
    示例值
    data
    struct
    - error_code
    int
    错误码,合法范围为 [0,999999]
    0
    - description
    string
    错误信息

    响应示例

    { "data": { "error_code": 0, "description": "", } }

    错误码

    error_code
    description
    备注
    0
    成功
    100
    ...
    抖音侧需要重试,其他错误码抖音不重试