同步退款审核结果
开发环境
开发环境
POST
/api/apps/trade/v2/merchant_audit_callback
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 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.如何判断退款单的审核状态
2.商家未同步退款审核结果，为什么退款成功了
3.哪些退款单需要审核，哪些不需要审核
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/apps/trade/v2/merchant_audit_callback' \
--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=="' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"out_refund_no": "1123",
"refund_audit_status": 2,
"deny_message": "不同意退款",
}'响应示例响应示例
200 - 成功示例
{
"err_no": 0,
"err_tips": "success"
}
修改于 2025-11-11 10:31:26