抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购(在线预约)
  • 景区团购三方码方案
  • 交易正向
  • 交易逆向
  • 景区退款审核
  • 景区退款结果通知
  • 景区回调审核退款
  • 交易履约
  • 景区行业团购|在线预约解决方案
  • 综合
  • 历史版本文档(不推荐)
  • 接口介绍

      POST
      抖音侧请求第三方申请退款,第三方同步或异步回调审核结果。
      未预约的预售单退款不送审,直接通过【退款结果通知】进行通知。

    基本信息

    Scope
    life.capacity.trip_order_after_sale_refund_apply
    权限要求
    景区行业解决方案-景区退款审核
    回调场景
    景区申请退款

    请求参数

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    order_id
    string
    抖音订单ID,如果是预约场景,对应预约订单ID
    out_order_id
    string
    商户订单id
    biz_uniq_key
    string
    业务唯一键,用于审核回调(可作幂等键)
    after_sale_type
    int32
    售后类型:1-退款;2-取消预约
    apply_source
    int64
    申请退款类型
    301 发码失败(发码失败拒绝退款需要返回补码信息)
    302 过期自动退
    apply_refund_time_unix
    int64
    申请时间戳,秒
    vouchers
    list<object>
    凭证列表(只有部分退/取消时,且非发码失败,才会给该字段,标识涉及取消或退款的凭证)
    -projects
    list<object>
    可自定义的项目(例:景区项目索道A、索道B等)
    --project_id
    string
    项目唯一标识,不能重复(核销时需要)

    响应字段

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    data
    struct
    - error_code
    int
    错误码,合法范围为 [0,999999]
    - description
    string
    错误信息
    - audit_refund_result
    int
    审核退款结果,当处理成功时必须返回,1 接受,2 拒绝,3 等待审核
    - refund_fee_amount
    int
    退款手续费金额,退款场景,审核退款结果为接受时必须返回,分;抖音侧如果校验此金额大于抖音侧计算的手续费金额则拒绝退款
    -vouchers
    list
    凭证列表(补码需要)
    --projects
    list<object>
    可自定义的项目(例:景区项目索道A、索道B等)
    ---project_id
    string
    入园项目的唯一标识,同一个订单下不能重复(核销时需要)
    ---name
    string
    自定义的项目名称(例:景区XXXX索道)
    ---id_cards
    list<string>
    身份证号码,最多限100个
    ---qrcodes
    list<string>
    二维码凭证,展示为二维码,每个URL长度不能超过512。
    ---certificate_nos
    list<string>
    券号凭证,在C端展示为数字串,最多限100个
    ---credentials
    list<object>
    证件列表
    ----credential_type
    int
    凭证类型
    1:身份证2:港澳通行证3:台湾通行证4:回乡证5:台胞证6:护照
    ----credential_no
    string
    凭证号