淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
param_appraise_isv_order_query	AppraiseIsvOrderQuery	必须			系统自动生成
└ biz_order_id Number 必须 1323542654565445 交易订单号

名称	类型	示例值	描述
result	Result	无	接口返回model
module AppraiseIsvRefundDto 无退款信息 └ biz_order_id Number 12341354344554 订单号 └ buy_amount Number 1 商品购买数量 └ buyer_apply_reason String 商品质量问题买家申请退款原因 └ buyer_apply_sub_reason String 商品问题买家退款说明,买家申请退款二级原因 └ buyer_nick String 123asdf 买家昵称（不唯一且用户可以自己更改） └ goods_status Number 4: 未发货, 6: 已发货, 1: 未收到货, 2: 已收到货, 3: 已寄回, 5: 卖家确认收货货物状态 item AppraiseIsvItemDto 无商品信息 └ item_id Number 1234234345 商品Id └ pic_url String http://dsfakasdf.jpg 商品图片,绝对途径 └ price Number 23100 商品价格，单位分 └ title String 已验货测试商品商品标题 └ need_return_goods Boolean true 买家是否需要退货 └ order_status Number null/0:未知状态, 1:订单已创建/等待买家付款, 2:订单已付款/等待卖家发货, 3:已发货/等待买家确认收货, 4:交易成功, 5:已退款, 6:交易关闭订单状态 └ payment Number 23000 订单实付金额,单位分 └ buyer_apply_desc String 商品破损买家申请退款描述 └ refund_create_time Number 1616155551128 退款申请时间,时间戳,单位分 └ refund_fee Number 20000 退还金额(退还给买家的金额),单位分 └ refund_id Number 13423464356 退款订单号 └ refund_post_company String 顺丰退货-快递公司 └ refund_post_no String SF32453457345235 退货-快递单号 └ refund_status Number 1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束退款订单状态 └ refund_modify_time Number 1616155551128 退款最新修改时间,时间戳,单位分 └ seller_agree_msg String 可以退货卖家同意退货说明 └ seller_nick String sadfqwef 卖家昵称（不唯一且用户可以自己更改） └ seller_refuse_msg String 商品没问题卖家拒绝退款说明 └ seller_refuse_reason String 不支持退货卖家拒绝退款原因 timeout_data IsvRefundTimeoutDto 无退款超时信息 └ create Number 1621221178000 退款超时创建时间，时间戳，毫秒 └ modified Number 1621221178000 退款超时修改时间，时间戳，毫秒 └ duration Number 195200 退款超时时长，时间长度(毫秒) └ timeout Number 1621221178000 退款超时时间点(自动触发状态变更的超时时间点)，时间戳，毫秒 └ timeout_status Number 1 退款超时运行状态 0:超时创建完成, 1:超时运行中, 2:超时暂停, 3:超时关闭, 4:超时失败, 5:超时成功 └ timeout_action_type String 退款商家同意退货超时退款超时动作类型 └ encryption_buyer_id String RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ 加密的买家id（唯一且不会改变） └ encryption_seller_id String RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ 加密的卖家id（唯一且不会改变） └ tb_refund_status Number 1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束关联淘宝退款订单状态 └ tb_order_consistent Boolean true 是否与淘宝订单一致 └ success Boolean false 是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleIsvRefundQueryRequest req = new AlibabaIdleIsvRefundQueryRequest();
AlibabaIdleIsvRefundQueryRequest.AppraiseIsvOrderQuery obj1 = new AlibabaIdleIsvRefundQueryRequest.AppraiseIsvOrderQuery();
obj1.setBizOrderId(1323542654565445L);
req.setParamAppraiseIsvOrderQuery(obj1);
AlibabaIdleIsvRefundQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleIsvRefundQueryRequest req = new AlibabaIdleIsvRefundQueryRequest();
AlibabaIdleIsvRefundQueryRequest.AppraiseIsvOrderQueryDomain obj1 = new AlibabaIdleIsvRefundQueryRequest.AppraiseIsvOrderQueryDomain();
obj1.BizOrderId = 1323542654565445L;
req.ParamAppraiseIsvOrderQuery_ = obj1;
AlibabaIdleIsvRefundQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleIsvRefundQueryRequest;
$param_appraise_isv_order_query = new AppraiseIsvOrderQuery;
$param_appraise_isv_order_query->biz_order_id="1323542654565445";
$req->setParamAppraiseIsvOrderQuery(json_encode($param_appraise_isv_order_query));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.idle.isv.refund.query' \
-d 'partner_id=apidoc' \
-d 'session=479e0170-8d16-4ec9-8417-df2edf760a0a' \
-d 'sign=D09621B922ED78F8AD9048D868225657' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-26+06%3A19%3A16' \
-d 'v=2.0' \
-d 'param_appraise_isv_order_query=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaIdleIsvRefundQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.param_appraise_isv_order_query=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.idle.isv.refund.query");
add_param(pRequest,"param_appraise_isv_order_query","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.idle.isv.refund.query', {
	'param_appraise_isv_order_query':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_idle_isv_refund_query_response>
    <result>
        <module>
            <biz_order_id>12341354344554</biz_order_id>
            <buy_amount>1</buy_amount>
            <buyer_apply_reason>商品质量问题</buyer_apply_reason>
            <buyer_apply_sub_reason>商品问题</buyer_apply_sub_reason>
            <buyer_nick>123asdf</buyer_nick>
            <goods_status>4: 未发货, 6: 已发货, 1: 未收到货, 2: 已收到货, 3: 已寄回, 5: 卖家确认收货</goods_status>
            <item>
                <item_id>1234234345</item_id>
                <pic_url>http://dsfakasdf.jpg</pic_url>
                <price>23100</price>
                <title>已验货测试商品</title>
            </item>
            <need_return_goods>true</need_return_goods>
            <order_status>null/0:未知状态, 1:订单已创建/等待买家付款, 2:订单已付款/等待卖家发货, 3:已发货/等待买家确认收货, 4:交易成功, 5:已退款, 6:交易关闭</order_status>
            <payment>23000</payment>
            <buyer_apply_desc>商品破损</buyer_apply_desc>
            <refund_create_time>1616155551128</refund_create_time>
            <refund_fee>20000</refund_fee>
            <refund_id>13423464356</refund_id>
            <refund_post_company>顺丰</refund_post_company>
            <refund_post_no>SF32453457345235</refund_post_no>
            <refund_status>1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束</refund_status>
            <refund_modify_time>1616155551128</refund_modify_time>
            <seller_agree_msg>可以退货</seller_agree_msg>
            <seller_nick>sadfqwef</seller_nick>
            <seller_refuse_msg>商品没问题</seller_refuse_msg>
            <seller_refuse_reason>不支持退货</seller_refuse_reason>
            <timeout_data>
                <create>1621221178000</create>
                <modified>1621221178000</modified>
                <duration>195200</duration>
                <timeout>1621221178000</timeout>
                <timeout_status>1</timeout_status>
                <timeout_action_type>退款商家同意退货超时</timeout_action_type>
            </timeout_data>
            <encryption_buyer_id>RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ</encryption_buyer_id>
            <encryption_seller_id>RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ</encryption_seller_id>
            <tb_refund_status>1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束</tb_refund_status>
            <tb_order_consistent>true</tb_order_consistent>
        </module>
        <success>false</success>
    </result>
</alibaba_idle_isv_refund_query_response>

{
    "alibaba_idle_isv_refund_query_response":{
        "result":{
            "module":{
                "biz_order_id":12341354344554,
                "buy_amount":1,
                "buyer_apply_reason":"商品质量问题",
                "buyer_apply_sub_reason":"商品问题",
                "buyer_nick":"123asdf",
                "goods_status":4: 未发货, 6: 已发货, 1: 未收到货, 2: 已收到货, 3: 已寄回, 5: 卖家确认收货,
                "item":{
                    "item_id":1234234345,
                    "pic_url":"http:\/\/dsfakasdf.jpg",
                    "price":23100,
                    "title":"已验货测试商品"
                },
                "need_return_goods":true,
                "order_status":null/0:未知状态, 1:订单已创建/等待买家付款, 2:订单已付款/等待卖家发货, 3:已发货/等待买家确认收货, 4:交易成功, 5:已退款, 6:交易关闭,
                "payment":23000,
                "buyer_apply_desc":"商品破损",
                "refund_create_time":1616155551128,
                "refund_fee":20000,
                "refund_id":13423464356,
                "refund_post_company":"顺丰",
                "refund_post_no":"SF32453457345235",
                "refund_status":1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束,
                "refund_modify_time":1616155551128,
                "seller_agree_msg":"可以退货",
                "seller_nick":"sadfqwef",
                "seller_refuse_msg":"商品没问题",
                "seller_refuse_reason":"不支持退货",
                "timeout_data":{
                    "create":1621221178000,
                    "modified":1621221178000,
                    "duration":195200,
                    "timeout":1621221178000,
                    "timeout_status":1,
                    "timeout_action_type":"退款商家同意退货超时"
                },
                "encryption_buyer_id":"RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ",
                "encryption_seller_id":"RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ",
                "tb_refund_status":1: 买家已经申请退款，等待卖家同意, 2: 卖家已经同意退款，等待买家退货, 3: 买家已经退货，等待卖家确认收货, 4: 退款关闭, 5: 退款成功, 6: 卖家拒绝退款, 8: 等待卖家确认退货地址, 9: 没有申请退款, 11: 退款结束,
                "tb_order_consistent":true
            },
            "success":false
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
TOP_NOT_CURRENT_INSPECT_ITEM	入仓商品退款单不属于该服务商平台	服务商SaaS平台排查优化
REFUND_NOT_EXSIT	退款单不存在	服务商SaaS端优化，排查订单下是否有退款单
isp.call-limited	限流	削峰，不许要处理
TOP_USER_NOT_LOGIN	用户未登录	重新获取登录态登录
TOP_NOT_SELLER	登录用户不是卖家	正常业务逻辑校验

API测试工具错误码查询工具 SDK下载

开放平台

闲鱼已验货

alibaba.idle.isv.refund.query (闲鱼已验货交易订单退款信息查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ