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

      •POST
      •抖音侧请求第三方申请退款,第三方同步或异步回调审核结果。
      •未预约的预售单退款不送审,直接通过【退款结果通知】进行通知。
      •团购订单部分退时只能按份数退款,不支持按游客维度退款。
      •对于未核销申请退款的订单,如果三方通过接口拒绝退款,订单会进入复审链路,此时商家可以到来客同意退款或者三方通过核销接口回传给抖音核销结果。否则,订单会在三方拒绝退款后超48小时自动同意退款。
    ​
    ​

    基本信息

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

    请求头

    Key
    字段类型
    示例
    描述
    Content-Type 必填
    String
    application/json
    -
    X-Bytedance-Logid 必填
    String
    -
    请求LogId,用于排查问题
    x-life-clientkey 必填
    String
    -
    服务商应用的client_key
    x-life-sign 必填
    String
    -

    请求参数

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

    响应字段

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

    响应示例

      •补码响应示例如下:
    { "data": { "error_code": 0, "description": "审核退款成功", "audit_refund_result": 2, "refund_fee_amount": 0, "vouchers": [ "projects": { "project_id": "proj_001", "name": "景区AAAA索道A", "qrcodes": [ "123123123" ], "certificate_nos": [ "CERT_001_2025" ], "credentials": [ { "credential_type": 1, "credential_no": "330106XXXXXXXXXXXX" } ] } ] } }
    ​