基础能力

触达与营销

支付

运营

生活服务

通用能力

生活服务交易系统（全融合版）

通用参数

错误码和返回码

查询接口

预下单

营销算价

支付

核销

分账

退货退款

预约

生活服务交易系统（账号融合版）

CPS佣金设置与查询

即送（原随心团）解决方案

核销工具解决方案

历史版本（不推荐使用）

垂直行业

其它

同步退款审核结果

我的收藏

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

使用限制

无

接口说明

审核接口在某些场景下会返回错误，比如收到退款回调后短时间内便同步审核结果，此时系统因延迟会报错“查不到订单”。其他错误见错误码部分。

首次调用失败后，重试传参 refund_audit_status 需与首次请求一致，参数不同会引发退款卡单。

强烈建议对该接口加重试，保证审核结果通知到位。

基本信息

基本信息
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	不同意退款

请求示例

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

Q&A

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

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

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

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

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

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