信息同步收藏我的收藏
收藏
我的收藏用于抖音侧向商家侧同步退款状态信息变更。
使用限制
此通知在服务商返回超时情况最多重试三次,其他情况仅仅发起一次,如果服务商网络存在抖动,不确保送达
接口 SLA
- 1.服务商服务SLA请保证在99.9%以上
- 2.接口响应延时不能超过8s,超过8s则当作未响应
使用说明
若存在以下几个非服务商发起的审核场景,抖音侧将会通过该接口进行同步审核结果,服务商系统需要感知这部分信息时可以实现该接口:
- 1.超时未收到服务商审核结果,抖音侧自动退
- 2.客服退
- 3.来客审核
基本信息
HTTP URL | 地址由服务商提供 | |||
HTTP Method | POST | |||
申请权限 | 三方码发布 | |||
权限要求 |
|
服务商/商家侧 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" } }