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

      •POST请求
      •抖音侧异步发起退款状态/取消结果通知,通知 SaaS 服务商退款完成信息,服务商接收消息后返回结果。

    基本信息

    Scope
    life.capacity.trip_order_after_sale_refund_notify
    权限要求
    景区行业解决方案-景区退款结果通知
    回调场景
    抖音侧通知第三方景区退款结果

    请求参数

    参数名称
    参数类型
    是否必填
    是否加密
    参数描述
    order_id
    string
    是
    否
    抖音侧订单 ID
    order_out_id
    string
    否
    否
    第三方订单 ID
    biz_uniq_key
    string
    是
    否
    业务唯一键,用于审核回调
    refund_amount
    int64
    是
    否
    实际退款金额,分
    refund_fee_amount
    int64
    是
    否
    抖音侧计算的退款手续费金额,单位分
    user_refund_amount
    int64
    是
    否
    用户实退金额,单位分
    refund_time_unix
    int64
    是
    否
    退款时间戳,秒
    refund_scene
    int64
    否
    否
    退款场景客服退 50(其他不用关心)
    refund_count
    int64
    否
    否
    退款份数
    vouchers
    list
    否
    否
    退款订单对应的凭证列表
    -projects
    list<object>
    否
    否
    可自定义的项目(例:景区项目索道A、索道B等)
    --project_id
    string
    是
    否
    项目唯一标识
    ​

    响应参数

    ​
    参数名称
    参数类型
    是否必填
    参数描述
    data
    struct
    是
    ​
    .error_code
    int64
    是
    失败错误码
    .description
    string
    是
    失败原因
    请求示例
    { "order_id": "7100000000000000001", "order_out_id": "OUT_20260620_001", "biz_uniq_key": "refund_20260620_001", "refund_amount": 9900, "refund_fee_amount": 990, "user_refund_amount": 8910, "refund_time_unix": 1781000000, "refund_count": 1, "refund_type": 1, "currency": "CNY" }
    成功响应示例
    ​
    { "data": { "error_code": 0, "description": "success" } }
    ​