同步退款审核结果

收藏

我的收藏

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

使用限制

无

接口说明

无

基本信息

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

请求示例

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

Q&A

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

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

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

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

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

A：

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

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