使用限制

接入前，请先查看接入前准备是否完成

接口说明

退款结果通知地址优先级：发起退款/退款申请回调指定的notify_url > 解决方案配置-消息通知中指定的地址

由于网络波动等原因，可能会产生重复的通知消息，接入方需要做好幂等，正确处理。

回调可能存在延时，开发者可以主动请求查询退款接口获取退款状态。

在开发者服务端收到回调且处理成功后，需要按以下正常返回示例返回并且 HTTP 响应状态码设为 200，否则会认为通知失败进行重试。

结果通知失败的重试策略为：5*(2^n)，间隔为5,10,20,40,...第10次重试间隔为120min。总耗时4h。

msg 字段

名称	类型	是否必填	描述	示例值
app_id	string	是	小程序 id	ttcfdbb0e33350
status	string	是	退款状态枚举值：SUCCESS：退款成功FAIL：退款失败	SUCCESS
order_id	string	是	抖音开平侧订单号	motb7057980663048
refund_id	string	是	抖音开平侧退款单号	motb7014925531429
refund_item_detail	Json Object	是	退款商品单信息
out_refund_no	string	是	开发者自定义的退款单号（可能为空)	530402398023
cp_extra	string	是	退款时开发者传入字段	test
refund_total_amount	int64	是	退款金额，单位分	9900
is_all_settled	bool	是	是否为分账后退款	FALSE
event_time	int64	是	退款时间戳，单位为毫秒	1643189272388
message	string	否	结果描述信息，如失败原因	余额不足
refund_type	int64	否	退款来源类型，枚举值： 1: 用户发起 2：开发者发起 4：抖音客服退款	1

msg 字段内容示例

//退款成功回调示例

{

"app_id": "ttcfdbb96650e33350",

"status": "SUCCESS",

"order_id": "motb7057980663048",

"cp_extra": "",

"message": "",

"event_time": 1643185934447,

"refund_id": "motb7014925531429",

"out_refund_no": "530402398023",

"refund_total_amount": 1,

"is_all_settled": false,

"refund_item_detail": {

"item_order_quantity": 1,

"item_order_detail": [{

"refund_amount": 1,

"item_order_id": "motb75515980663048"

}]

}

//退款失败回调示例

{

"app_id": "ttcfdbb96650e33350",

"status": "FAIL",

"order_id": "motb7057980663048",

"cp_extra": "xxxxx",

"message": "余额不足",

"event_time": 1643185934447,

"refund_id": "motb7014925531429",

"out_refund_no": "ext_order_no_1643185898403",

"refund_total_amount": 1,

"is_all_settled": true,

"refund_item_detail": {

"item_order_quantity": 1,

"item_order_detail": [{

"refund_amount": 1,

"item_order_id": "motb75515980663048"

}]

}

curl --location --request POST 'http://dev-cn.your-api-server.com/api/v2/result_callback?timestamp=1345678901234&nonce=iuy987q4htafreqw' \ --header 'Content-Type: application/json' \ --data-raw '{ "version": "3.0", //本次固定为3.0, 通过版本信息识别，用不同的结构体去解析上述关键参数 "msg": "{\"app_id\":\"ttcfdbb96650e33350\",\"status\":\"SUCCESS\",\"order_id\":\"motb7057980663048\",\"cp_extra\":\"\",\"message\":\"\",\"event_time\":1643185934447,\"refund_id\":\"motb7014925531429\",\"out_refund_no\":\"530402398023\",\"refund_total_amount\":1,\"is_all_settled\":false,\"refund_item_detail\":{\"item_order_quantity\":1,\"item_order_detail\":[{\"refund_amount\":1,\"item_order_id\":\"motb75515980663048\"}]}}", "type": "refund" }'

请求参数

Query 参数

timestamp

string

必需

示例值:

1345678901234

nonce

string

必需

示例值:

iuy987q4htafreqw

Header 参数

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

version

string

必需

本次固定为3.0, 通过版本信息识别，用不同的结构体去解析上述关键参数

msg

string

必需

订单相关信息的 JSON 字符串

type

string

必需

枚举值 refund：退款成功/退款失败

示例

退款结果通知

使用限制#

接口说明#

请求参数

返回响应

使用限制

接口说明