查询退款
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/trade_basic/v1/developer/refund_query/
使用限制
接口说明
请求头
请求参数
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 10000 | 参数不合法：xxxx | 对照错误提示和接口字段定义，检查对应的参数 |
| 13000 | 系统错误，请重试 | 请重试，若多次重试仍然报错，请联系oncall |
| 20000 | 退款单不存在 | 按以下步骤进行排查： 1. 若刚刚发起退款，系统有延迟，建议等几秒钟再重试 2. 请仔细核对参数，out_refund_no、refund_id、order_id与app_id是否匹配 3. 如果是以refund_id、order_id查询，说明没有对应的退款单。 4. 如果是以out_refund_no查询，很可能是out_refund_no不存在。 建议改用order_id查询退款，确认是否存在退款单。如果不存在退款单，说明没有成功发起退款。如果存在退款单且out_refund_no为空，说明开发者未响应退款申请回调。建议检查退款申请回调接口。 以上步骤都排查过，仍然无法处理时请提oncall |
常见问题
1.为什么开发者未发起退款，但是查询到订单在退款中？
2.为什么订单会存在抖音客服发起的退款
3.为什么一直处于退款中
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/trade_basic/v1/developer/refund_query/' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"refund_id": "ot1231231"
}'响应示例响应示例
200 - 成功示例
{
"data": {
"refund_list": [
{
"merchant_audit_detail": {
"audit_status": "AGREE",
"need_refund_audit": 1,
"refund_audit_deadline": 1673253628929
},
"create_at": 1671994501000,
"refund_at": 1672994501000,
"refund_status": "SUCCESS",
"refund_total_amount": 1992,
"item_order_detail": [
{
"item_order_id": "motb700000000101",
"refund_amount": 996
},
{
"refund_amount": 996,
"item_order_id": "motb700000000102"
}
],
"message": "",
"order_id": "motb700000000777",
"out_refund_no": "ext_refund_no_812832",
"refund_id": "motb7000000007666"
}
]
},
"err_no": 0,
"err_msg": "success",
"log_id": "2022092115392201020812109511046"
}请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json