退款结果回调
收藏
我的收藏

将退款成功或失败的消息通知给开发者/服务商。

使用限制

无

接口说明

回调地址会优先使用开发者在发起退款接口传入的notify_url，如果发起退款时没有传入，会请求开发者在进件时设置的URL，该URL查看步骤如下【开放平台控制台->小程序->能力->支付能力->支付设置】。

退款成功或者退款失败都会回调。

平台会通过一定的策略定期重新发起回调，尽可能提高回调的成功率，但不保证通知最终能成功。退款回调接口最多重试 16 次，重试间隔分别为（15s/15s/30s/3min/10min/20min/30min/30min/30min/60min/3h/3h/3h/6h/6h）。

若长时间未收到回调，开发者可以通过主动请求退款结果查询接口，感知退款结果。

开发者服务端接收到异步通知时，必须通过验签（验证通知中的 msg_signature 参数）来确保支付通知是由抖音发送的。

在开发者服务端收到回调且处理成功后，需要按以下 json 返回表示处理成功，否则小程序服务端会认为通知失败进行重试。

{
  "err_no": 0,
  "err_tips": "success"
}

回调参数

名称	类型	是否必填	最大长度	描述	示例值
timestamp	string	是	12	Unix 时间戳，字符串类型	1644399124
nonce	string	是	4	随机数	797
msg	string	是	-	订单信息的 json 字符串	{\"appid\":\"app_id_test\",\"cp_refundno\":\"out_refund_no\",\"cp_extra\":\"\",\"status\":\"SUCCESS\",\"refund_amount\":999,\"is_all_settled\":false,\"refunded_at\":1691372517,\"message\":\"\",\"order_id\":\"order_id_123\",\"refund_no\":\"refund_no_123\"}
type	string	是	32	回调类型标记，退款成功回调为"refund"	refund
msg_signature	string	是	128	签名，详见签名DEMO	52fff5f7a4bf4a921c2daf83c75cf0e716432c73

msg 参数

回调参数中的 msg 字段，为以下内容序列化得到的 json 字符串

名称	类型	是否必填	最大长度	描述	示例值
appid	string	是	64	当前交易发起的小程序id	tt07e3715e98c9aac0
cp_refundno	string	是	64	开发者侧的退款订单号	401020220222383677956847349760
cp_extra	string	是	2048	预下单时开发者传入字段	一些附加信息
status	string	是	-	状态枚举值： SUCCESS：成功 FAIL：失败	SUCCESS
refund_amount	number	是	[1,99999999999]	退款金额，单位为分	100，即1元
refunded_at	number	是	10	退款时间，Unix 时间戳，10 位，整型数，秒级	1644399124
message	string	是	356	退款失败原因描述，详见发起退款错误码	商户余额不足
order_id	string	是	64	抖音侧订单号	7064214528778700000
refund_no	string	是	64	抖音侧退款单号	N6926510404499680000
is_all_settled	bool	是	-	是否为分账后退款	false

回调示例

{
  "timestamp": "1602507471",
  "nonce": "797",
  "msg": {
    "appid": "ttb8bece032785e300",
    "cp_refundno": "RD818440313350422528011772773",
    "cp_extra": "",
    "status": "SUCCESS",
    "refund_amount": 13800,
    "is_all_settled": false,
    "refunded_at": 1645523993,
    "message": "成功",
    "order_id": "7064214528778700000",
    "refund_no": "N6926510404499680000"
  },
  "msg_signature": "52fff5f7a4bf4a921c2daf83c75cf0e716432c73",
  "type": "refund"
}

响应参数

名称	类型	是否必填	最大长度	描述	示例值
err_no	number	是	-	详见错误码	0
err_tips	string	是	-	详见错误描述	success

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "success"
}

异常响应示例

{
  "err_no": 400,
  "err_tips": "business fail"
}

退款结果回调收藏我的收藏

​使用限制​

​接口说明​

​回调参数​

​回调示例​

​响应参数​

​响应示例​

​正常响应示例​

​异常响应示例​