接入前准备

通用能力

门店相关接口

团购核销

团购对账

会员接入

订单查询

三方码

商品发布

代运营

团购退款

商品查询

招商入驻

KA核销对账

餐饮

大交通

酒旅

综合

历史版本文档（不推荐）

信息同步
收藏
我的收藏

用于抖音侧向商家侧同步退款状态信息变更。

使用限制

此通知在服务商返回超时情况最多重试三次，其他情况仅仅发起一次，如果服务商网络存在抖动，不确保送达

接口 SLA

服务商服务SLA请保证在99.9%以上

接口响应延时不能超过8s，超过8s则当作未响应

使用说明

若存在以下几个非服务商发起的审核场景，抖音侧将会通过该接口进行同步审核结果，服务商系统需要感知这部分信息时可以实现该接口：

超时未收到服务商审核结果，抖音侧自动退

客服退

来客审核

基本信息

HTTP URL	地址由服务商提供
HTTP Method	POST
申请权限	三方码发布
权限要求	•需要申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 •需要url配置，路径：见下方“服务商/商家侧 SPI 接口配置” •需要商家授权，路径：抖音来客>店铺管理>服务应用授权

服务商/商家侧 SPI 接口配置

配置路径：开放平台-服务商平台/开发者平台-控制台-应用详情页-开发设置-SPI 回调

需配置接口：

接口	回调场景(配置SPI回调地址时可见)	需提供信息	是否必填
预下单	抖音请求三方系统预下单	回调地址：预下单URL	必填
发券	抖音请求三方系统发码	回调地址：发券URL	必填
退款	抖音请求三方系统退款审核	回调地址：退款URL	必填
信息同步	抖音向三方系统同步退款信息	回调地址：信息同步URL	必填

签名规则

签名规则参考查看这个地址的说明

请求参数

Body 请求

参数名称	参数类型	参数描述	必需
order_id	string	抖音侧的订单号	是
after_sale_id	string	抖音侧售后单号，多张券属于同一售后单才会返回	否
after_sale_type	int64	售后类型 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拒绝	是

请求示例

{
  "order_id": "12345678",
  "after_sale_id": "8762344"
  "notice_list": [
    {
      "certificate_id": "987654321",
      "code": "abcd1234",
      "apply_time": 1632657476410,
      "audit_time": 1632657486410,
      "audit_result": 1
    }
  ]
}

响应参数

字段名称	字段类型	字段描述
data	object
.error_code	int64	接口错误码
.description	string	接口错误描述

响应示例

正常示例

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

信息同步收藏我的收藏