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

    抖音侧完成退款后,通知第三方实际退款结果。
    通知类型的接口 请勿返回业务类型的错误(譬如订单不存在)

    基本信息

    Scope
    life.capacity.trip_order_after_sale_refund_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
    biz_uniq_key
    string
    业务唯一键,用于审核回调
    123456
    refund_amount
    int
    实际退款金额,分
    2340
    refund_time_unix
    int
    退款时间戳,秒
    1678859904
    refund_scene
    int64
    退款场景
      1 :用户发起
      2:客商协商一致(订单核销后用户联系商家发起的仅退款不会通知,订单未核销的退货退款会通知)
      3:用户主动协商
      50:客服发起
      100:商家发起
      101:原外卖商家发起退款(无需关注)
      150:过期退
      151:超时未接单
      152:超付退
      153:拒单
      154:闭店
      155:发码失败
      156:运单取消
      158:团购升级次卡
      159:线下核销
      160:拼团失败
      161:尾款支付超时自动退定金
      170:业务取消
    refund_count
    int64
    退款份数
    vouchers
    list
    退款订单对应的凭证列表
    - entrance
    struct
    景区的入园项目(若入园凭证是单独的凭证,则使用此字段用来传入园凭证。若不是单独的凭证,可使用自定义项目的字段传入)
    --project_id
    string
    入园项目的唯一标识,与projects中不能重复
    -projects
    list<object>
    可自定义的项目(例:景区项目索道A、索道B等)
    --project_id
    string
    项目唯一标识

    请求示例

    响应参数

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

    响应示例

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

    错误码

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