抖音码退款申请通知
收藏
我的收藏

接口说明

在c端用户发起核销后退款申请时，开发者监听webhook退款审批通知，接收退款申请

消息可能重复推送，请使用 Msg_Id 进行去重处理！

信息推送使用说明参考：生活服务消息推送

基本信息

HTTP URL	地址由服务商提供
HTTP Method	POST
申请权限	餐饮交易退款
权限要求	生活服务商家应用，需要url配置，路径：配置方式小程序应用自行配置，路径：小程序配置商品审核回调地址

签名规则

用户可通过请求 header 中的 X-Douyin-Signature 字段判断该消息是否来自抖音开放平台。抖音服务端会将应用的(client secret + 消息体)使用 sha1 哈希作为 X-Douyin-Signature header 的 value。您可以自行使用 client secret 和收到的消息体进行 sha1 哈希，与该请求头进行比对。

请求头字段

字段	说明
Msg-Id	同一实体下同一action的msg_id相同，服务商可根据msg_id对于消息去重
X-Douyin-Signature	抖音侧签名，服务商可根据签名判断该消息是否来自抖音开放平台
Content-Type	固定值application/json

请求体字段

参数				类型	含义
event				string	事件名，唯一标识， life_hermes_akte_after_sale_audit
from_user_id				string	未使用
to_user_id				string	未使用
client_key				string	开发者唯一标识
content				string	具体内容，类型：json string
	account_id			string	商家id
	order_id			string	订单id
	certificate_id			string	券id
	refund_amount			int64	退款金额
	refund_time			int64	退款申请时间
	apply_reason			object	申请售后原因
		code		[]int64	reason 对应的code
		reason_items		[]object	完整code与当时对应文案映射
			code	int64	code
			msg	string	文案
		additional_msg		string	补充的msg信息

请求示例

{
  "event": "life_hermes_akte_after_sale_audit",
  "client_key": "axxxxxxxxxxxxx",
  "content": "{    \"account_id\":\"123\",    \"order_id\":\"12\",    \"certificate_id\":\"567\",    \"refund_amount\":20,    \"refund_time\":1312414,    \"apply_reason\":{        \"code\":[            999        ],        \"reason_items\":[            {                \"code\":999,                \"msg\":\"其他\"            }        ],        \"additional_msg\":\"跟商家协商\"    }}"
}

响应参数

响应内容可以为空。

开发者收到消息推送后，http code 响应 200 且响应时间小于 3s，抖音侧即认为推送成功。

若开发者 http 响应 code 非 200 或响应时间超过 3s，抖音侧会间隔 500ms 发起重试，最大重试次数为 3 次。

抖音侧收到成功请求时也可能会继续重复推送，请务必使用请求头中 Msg-Id 进行消息去重处理。

抖音码退款申请通知收藏我的收藏