同步退款审核结果
收藏
我的收藏

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

使用限制

无

接口说明

无

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/trade/v2/merchant_audit_callback
HTTP Method	POST
权限要求	无

请求头

名称	类型	是否必填	描述
Content-Type	string	是	固定值 "application/json"
Byte-Authorization	string	是	请参见签名算法

请求参数

名称	类型	是否必填	描述	示例
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://developer.toutiao.com/api/apps/trade/v2/merchant_audit_callback' \
--header 'Content-Type: application/json' \
--header 'Byte-Authorization: SHA256-RSA2048 appid="ttxxx",nonce_str="DC10180A100073E70A48F195DA2AF2E6",timestamp="1623934869",key_version="1",signature="nwd1L3wCX+01/TVTkILeovF1DtYeghC1VHjrcjTHVkh7+gRaONEQkC2Y72Mw8JdSnIyeAtyp/pDHzyKGywjVqv5+JOBEhQG1/pvwNHN49wD26qg3AJL4hXw0fMJSRiTQEV1MszwDLuaabvo/qM9OXL9KyYiEPwVJqYtzmho4cHXT6mYgzNOW1xt5d7RDf4QO74JI3i4dtk9Uj8svJTrrBabML6AUcqcx2OP/7xukdaUgPdPf+IqmMG6GC4n52LUDogcL5n/osLdfHg9l6kW5gDcDjBfNDaggz07QMPHGdVao7pnQ2ub7VqcFIuY6Q3cBL7ndQdDGKrv+WBy5Q90QjQ=="'
--data-raw='{
        "out_refund_no": "1123",
        "refund_audit_status": 2,
        "deny_message": "不同意退款",
}'

响应参数

名称	类型	是否必填	描述	示例
err_no	`int64`	是	状态码 0 表示业务处理成功，具体错误码参见后文错误码章节	0
err_tips	`string`	是	错误提示信息	success

响应示例

正常示例

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

异常示例

{
  "err_no": 13000,
  "err_tips": "系统错误"
}

错误码

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

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

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

Q&A

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

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

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

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

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

A：

[抖音客服发起退款]、[预约失败交易系统自动发起加价单退款]无需审核

用户发起、开发者发起、过期自动退、下单即预约且预约失败自动发起退款都需要审核

下一篇：小程序文档指引

同步退款审核结果收藏我的收藏