查询退款

开发者可通过此接口查询退款单的详情。适用场景举例：查询是否发起退款，查询退款单状态。

接口说明

支持 refund_id 查询
支持 out_refund_no 查询
支持 order_id 查询

请求参数

注意：

refund_id , out_refund_no , order_id 三选一，不能都不选。
order_id维度的不兼容老退款单查询，只支持查询交易系统的退款。查询返回的结果数限制50条

错误码

错误码	错误提示	建议解决方案
20000	订单不存在	按以下步骤进行排查：若刚刚发起退款，系统有延迟，建议等几秒钟再重试请仔细核对参数，out_refund_no、refund_id、order_id与app_id是否匹配如果是以refund_id、order_id查询，说明没有对应的退款单。如果是以out_refund_no查询，很可能是out_refund_no不存在。建议改用order_id查询退款，确认是否存在退款单。如果不存在退款单，说明没有成功发起退款。如果存在退款单且out_refund_no为空，说明开发者未响应退款申请回调。建议检查退款申请回调接口。具体请参考退款申请回调文档末尾的退款申请回调接口排查模块以上步骤都排查过，仍然无法处理时请提oncall

1.为什么开发者未发起退款，但是查询到订单在退款中？

A：除开发者发起外，还存在用户在退款组件发起、系统自动退款、抖音客服发起等场景，请通过查询退款接口查询订单的退款记录，并检查 refund_source 字段，可以获得具体的退款来源。

2.为什么订单会存在抖音客服发起的退款

A：用户找到抖音客服投诉，客服会联系商家确认后发起客服退款，如有疑问请咨询行业运营。客服退不需要商家审核，但需要开发者响应退款申请回调，客服退流程详见退款申请回调-接口说明模块的流程图。

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

curl --location --request POST '/api/apps/trade/v2/query_refund' \ --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 '{ "refund_id": "ot1231231", //当有refund_id时，优先使用refund_id查询 "out_refund_no": "12313" }'

{ "data": { "refund_list": [ { "refund_at": 1672994501000, "create_at": 1672994428929, "refund_source": 1, "refund_total_amount": 1992, "refund_status": "SUCCESS", "out_refund_no": "ext_refund_no_718536707992153502030519534", "message": "", "item_order_detail": [ { "item_order_id": "800000000101757849613437984", "refund_amount": 996 }, { "item_order_id": "800000000101757824013547984", "refund_amount": 996 } ], "merchant_audit_detail": { "audit_status": "AGREE", "deny_message": "", "need_refund_audit": 1, "refund_audit_deadline": 1673253628929 }, "order_id": "8000000001017577984", "refund_id": "718536707992153502030519534" } ], "item_order_detail": [ { "item_order_id": "800000000101757849613437984", "refund_amount": 996 }, { "refund_amount": 996, "item_order_id": "800000000101757824013547984" } ], "refund_id": "718536707992153502030519534", "out_refund_no": "ext_refund_no_718536707992153502030519534", "refund_status": "SUCCESS", "message": "", "merchant_audit_detail": { "need_refund_audit": 1, "refund_audit_deadline": 1673253628929, "audit_status": "AGREE", "deny_message": "" }, "create_at": 1672994428929, "order_id": "8000000001017577984", "refund_total_amount": 1992, "refund_at": 1672994501000 }, "resp_extra": { "logid": "02168173448144300000000000000000000ffff0a99604dfab9fd" }, "err_no": 0, "err_tips": "success" }

接口说明#

请求参数#

错误码#

1.为什么开发者未发起退款，但是查询到订单在退款中？#

2.为什么订单会存在抖音客服发起的退款#

请求参数

返回响应

接口说明

请求参数

错误码

1.为什么开发者未发起退款，但是查询到订单在退款中？

2.为什么订单会存在抖音客服发起的退款