抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 餐饮
  • 大交通
  • 酒旅
  • 会员通手机号格式说明&国家区号拆分能力
  • 酒店通用错误码
  • 酒店行业日历房解决方案
  • 酒店行业新预售券解决方案
  • 度假行业解决方案
  • 景区行业日历票解决方案
  • 景区团购(在线预约)
  • 日历票价格库存属性发布
  • 景区预订信息校验
  • 景区创建订单
  • 景区确认订单
  • 景区退款审核
  • 景区回调审核退款
  • 景区退款结果通知
  • 景区订单状态查询
  • 三方码发布
  • 发放凭证(同步发券-SPI)
  • 凭证回调(异步发券 OpenAPI )
  • 核销(验券 OpenAPI)
  • 信息同步(SPI)
  • 景区团购三方码方案
  • 景区行业团购|在线预约解决方案
  • 综合
  • 历史版本文档(不推荐)
  • 接口说明(针对于预约单)

    若存在以下几个非服务商发起的审核场景,抖音侧将会通过该接口进行同步审核结果,服务商系统需要感知这部分信息时可以接入该接口:
      1.超时未收到服务商审核结果,抖音侧将自动执行退款
      2.客服介入处理退款
      3.来客审核流程触发退款

    基本信息

    HTTP URL
    需服务商提供
    HTTP Method
    POST

    请求参数

    Body 请求

    参数名称
    参数类型
    参数描述
    必需
    备注
    order_id
    string
    抖音侧的订单号
    after_sale_id
    string
    抖音侧售后单号,多张券属于同一售后单才会返回
    after_sale_type
    int
    售后类型,枚举:1、退货退款,2、取消预约,3、仅退款
    notice_list
    list(object)
    退款通知列表
    .certificate_id
    string
    券id
    .code
    string
    三方码
    .total_count
    int64
    次卡商品总次数(仅次卡商品有)
    .verify_count
    int64
    次卡商品已核销次数(仅次卡商品有)
    .refund_count
    int64
    次卡商品退款次数(仅次卡商品有)
    .origin_amount
    int64
    应退金额,应退金额=实退金额+退款违约补偿金额(仅次卡商品有)
    .refund_amount
    int64
    实退金额(仅次卡商品有)
    .deduct_fee_amount
    int64
    退款违约补偿金额(仅次卡商品有)
    .sub_item_list
    list(object)
    次卡商品次数信息列表(仅次卡商品有)
    ..sub_item_id
    string
    次卡退款次序号(仅次卡商品有)
    ..origin_amount
    int64
    应退金额,应退金额=实退金额+退款违约补偿金额(仅次卡商品有)
    ..refund_amount
    int64
    实退金额,实退金额=营销实退金额 + 用户实退金额(仅次卡商品有)
    ..marketing_amount
    int64
    营销实退金额(仅次卡商品有)
    ..user_amount
    int64
    用户实退金额(含支付优惠退款)(仅次卡商品有)
    ..deduct_fee_amount
    int64
    退款违约补偿金额(仅次卡商品有)
    .apply_time
    int
    退款申请时间
    .audit_time
    int
    退款审核时间
    .audit_result
    int
    审核结果 1同意2拒绝
    .voucher
    string
    景区多凭证,具体字段见三方码发放凭证响应参数中的vouchers数组中的结构体(单一结构,非list)

    请求示例

    POST接口附上请求体,GET接口请将请求参数拼接至请求链接后
    { "order_id": "12345678", "after_sale_id": "8762344" "notice_list": [ { "certificate_id": "987654321", "code": "abcd1234", "apply_time": 1632657476410, "audit_time": 1632657486410, "audit_result": 1"voucher":"" } ] }

    响应参数

    参数名称
    参数类型
    参数描述
    说明
    data
    struct
    .error_code
    int64
    错误码,0为成功
    .description
    string
    错误码描述

    响应示例

    可在后续验收时进行补充,验收文档示例(复制后使用)

    正常示例

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