同步退款审核结果

我的收藏

开发者使用该接口回传退款单的退款审核结果。

使用限制

无

接口说明

无

基本信息

基本信息
HTTP URL	https://open.douyin.com/api/apps/trade/v2/refund/merchant_audit_callback
HTTP Method	POST
Scope	industry_open.trade.refund
权限要求	不需要用户授权

请求头

名称	类型	是否必填	描述
Content-Type	string	是	固定值 "application/json"
access-token	string	是	调用/oauth/client_token/生成的token，此token不需要用户授权。示例: clt.xxx

请求参数

名称	类型	是否必填	描述	示例
out_refund_no	`string`	是	开发者侧退款单号，长度 <= 64 byte	1123
refund_audit_status	`int8`	是	审核状态 1：同意退款 2：不同意退款	2
deny_message	`string`	否	不同意退款信息(不同意退款时必填)，长度 <= 512 byte	不同意退款

名称

类型

是否必填

描述

示例

out_refund_no

string

是

开发者侧退款单号，长度 <= 64 byte

1123

refund_audit_status

int8

是

审核状态

1：同意退款
2：不同意退款

deny_message

string

否

不同意退款信息(不同意退款时必填)，长度 <= 512 byte

不同意退款

请求示例

curl --location --request POST 'https://open.douyin.com/api/apps/trade/v2/refund/merchant_audit_callback' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.xxx' \
--data-raw='{
        "out_refund_no": "1123",
        "refund_audit_status": 2,
        "deny_message": "不同意退款",
}'

响应参数

名称	类型	是否必填	描述	示例
data	object	否	返回数据信息
extra	object	是	额外信息，参考通用参数中的说明

data 信息

名称	类型	是否必填	参数描述	示例值
error_code	int	是	错误码，0为成功	0
description	string	是	错误码描述	success

extra 信息

名称	类型	是否必填	描述	示例值
error_code	int	是	错误码，0为成功	0
description	string	是	错误码描述	success
sub_error_code	int	是	子错误码	0
sub_description	string	是	子错误码描述	success
logid	string	是	请求id	2022092115392201020812109511046
now	int	是	毫秒级时间戳	1663745962686

响应示例

正常示例

{
  "data": {
    "error_code": 0,
    "description": "success"
  },
  "extra": {
    "sub_error_code": 0,
    "sub_description": "success",
    "logid": "2022092115392201020812109511046",
    "now": 1663745962686,
    "error_code": 0,
    "description": "success"
  }
}

异常示例

{
  "data": {
    "error_code": 13000,
    "description": "系统错误"
  },
  "extra": {
    "sub_error_code": 13000,
    "sub_description": "系统错误",
    "logid": "2022092115392201020812109511046",
    "now": 1663745962686,
    "error_code": 2191000,
    "description": ""
  }
}

错误码

详情参见错误码/返回码。

错误码	错误提示	建议解决方案
22006	退款单状态不允许设置商家审核结果	按以下步骤进行排查：若刚刚发起退款，系统有一些前置流程未处理完，建议等几秒钟后再重试通过查询退款接口查询退款信息，merchant_audit_detail.audit_status 是审核状态， a.如果audit_status是初始化，则等待一会后再重试 b.如果audit_status是同意或拒绝，说明退款已经审核过，无需再审核 c. 如果audit_status是超时自动同意，说明已经过了审核ddl，无需再审核以上步骤都排查过，仍然无法处理时请提oncall
12001	操作过于频繁，请稍后再试	接口调用太频繁，请降低频次
20000	订单不存在	按以下步骤进行排查：若刚刚发起退款，系统有延迟，建议等几秒钟再重试请仔细核对参数，out_refund_no与app_id是否匹配检查out_refund_no是否存在，建议用order_id查询退款，如果退款单不存在，请检查是否成功发起了退款。如果存在退款单的out_refund_no为空，说明开发者未响应退款申请回调。建议检查退款申请回调接口。排查方法参考：退款申请回调文档末尾的退款申请回调接口排查模块。以上步骤都排查过，仍然无法处理时请提oncall

错误码

错误提示

建议解决方案

22006

退款单状态不允许设置商家审核结果

按以下步骤进行排查：

若刚刚发起退款，系统有一些前置流程未处理完，建议等几秒钟后再重试
通过查询退款接口查询退款信息，merchant_audit_detail.audit_status 是审核状态，

a.如果audit_status是初始化，则等待一会后再重试

b.如果audit_status是同意或拒绝，说明退款已经审核过，无需再审核

c. 如果audit_status是超时自动同意，说明已经过了审核ddl，无需再审核

以上步骤都排查过，仍然无法处理时请提oncall

12001

操作过于频繁，请稍后再试

接口调用太频繁，请降低频次

20000

订单不存在

按以下步骤进行排查：

若刚刚发起退款，系统有延迟，建议等几秒钟再重试
请仔细核对参数，out_refund_no与app_id是否匹配
检查out_refund_no是否存在，建议用order_id查询退款，如果退款单不存在，请检查是否成功发起了退款。
如果存在退款单的out_refund_no为空，说明开发者未响应退款申请回调。建议检查退款申请回调接口。排查方法参考：退款申请回调文档末尾的退款申请回调接口排查模块。

以上步骤都排查过，仍然无法处理时请提oncall

Q&A

1.如何判断退款单的审核状态

A:查询退款接口查询退款信息，merchant_audit_detail.audit_status 是审核状态，merchant_audit_detail.refund_audit_deadline 是审核的最后期限

2.商家未同步退款审核结果，为什么退款成功了

A：退款审核有最后期限，一般是 3 天(从发起退款的时刻开始)，在退款申请回调/查询退款能获取到，商家需要在有效期内同步审核结果。有效期过后，系统将默认审核通过。

3.哪些退款单需要审核，哪些不需要审核

A：注意这个文档是代运营链路的。只有三方码(用户退，过期退)，需要审核。其他场景均不需要审核。

下一篇：小程序文档指引