查询退款
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/apps/trade/v2/refund/query_refund
接口说明
支持 out_refund_no 查询
支持 order_id 查询
请求参数
1.
2.
请求参数
1.
2.
响应示例
正常示例
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 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.为什么开发者未发起退款，但是查询到订单在退款中？
2.为什么订单会存在抖音客服发起的退款
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/apps/trade/v2/refund/query_refund' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"refund_id": "ot1231231", //当有refund_id时，优先使用refund_id查询
"out_refund_no": "12313",
"order_id": "ots712313",
}'响应示例响应示例
200 - 成功示例
{
"data": {
"refund_list": [
{
"merchant_audit_detail": {
"audit_status": "AGREE",
"need_refund_audit": 1,
"refund_audit_deadline": 1673253628929
},
"create_at": 1671994501000,
"refund_source": 1,
"refund_at": 1672994501000,
"refund_status": "SUCCESS",
"refund_total_amount": 1992,
"item_order_detail": [
{
"item_order_id": "800000000101757849613437984",
"refund_amount": 996
},
{
"refund_amount": 996,
"item_order_id": "800000000101757824013547984"
}
],
"message": "",
"order_id": "8000000001017577984",
"out_refund_no": "ext_refund_no_718536707992153502030519534",
"refund_id": "718536707992153502030519534"
}
],
"order_id": "8000000001017577984",
"refund_id": "718536707992153502030519534",
"refund_status": "SUCCESS",
"refund_total_amount": 1992,
"merchant_audit_detail": {
"audit_status": "AGREE",
"need_refund_audit": 1,
"refund_audit_deadline": 1673253628929
},
"message": "",
"create_at": 1671994501000,
"refund_at": 1672994501000,
"item_order_detail": [
{
"item_order_id": "800000000101757849613437984",
"refund_amount": 996
},
{
"item_order_id": "800000000101757824013547984",
"refund_amount": 996
}
],
"out_refund_no": "ext_refund_no_718536707992153502030519534",
"error_code": 0,
"description": ""
},
"extra": {
"error_code": 0,
"description": "",
"sub_error_code": 0,
"sub_description": "success",
"logid": "02168173575240700000000000000000000ffff0a706f38ab32d2",
"now": 1681735753
}
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json