抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 到综团购解决方案
  • 到综团购预约解决方案
  • 综合到店提货解决方案
  • 商品发布
  • 提货券三方码交易能力
  • 发券回调接口
  • 退款审核回调接口
  • 通知外部商家创单
  • 通知外部商家支付成功
  • 通知外部商家取消订单
  • 发券
  • 商家退款申请
  • 退款结果同步外部商家
  • 撤销核销
  • 券状态批量查询
  • 验券接口
  • 提货券抖音码交易能力
  • 商品查询
  • 线索管理解决方案
  • 历史版本文档(不推荐)
  • 接口说明

    抖音侧通知第三方取消订单。
    通知类型的接口 请勿返回业务类型的错误(譬如订单不存在)

    使用限制

    基本信息

    Scope
    life.capacity.comprehensive_retail_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
    1
    cancel_type
    int
    取消类型,1 支付前取消,2 支付后取消
    1
    cancel_order_time_unix
    int
    取消订单的时间戳,秒
    1678859379

    请求示例

    { "order_id":"111", "order_out_id": "1", "cancel_type":1, "cancel_order_time_unix": 1678859379 }

    响应参数

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

    响应示例

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

    错误码

    error_code
    description
    备注
    0
    success
    成功
    300
    ...
    抖音侧需要重试,其他错误码抖音不重试
    400~499
    其他自定义错误