抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 交易正向
  • 交易履约
  • 交易逆向
  • 景区退款审核
  • 景区退款结果通知
  • 景区回调审核退款
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 通用能力
  • 接入前准备
  • 接口介绍

      •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 过期自动退
    refund_fee_amount
    int64
    是
    否
    抖音侧计算的退款手续费金额,分
    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
    是
    是
    凭证号