淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
e_trade_id	String	必须	xxxxxx		订单号
data_select	String	可选	fund_serviceFee,fund_fundPay		不传默认查询fund_serviceFee和fund_fundPay fund_refund 退款信息 fund_serviceFee 订单的服务费 fund_fundPay 预付款和尾款的支付信息多个参数英文逗号分隔即可

名称	类型	示例值	描述
value	TradeEcologyFund	fund	资金信息
fund_pay_list FundPay [] fund_pay_list 支付信息列表(包含预付款和尾款) pay_amount Price pay_amount 支付金额 └ amount String 12.00 金额 └ currency String USD 币种 └ pay_method String TT 支付方式(TT, CREDIT_CARD, E_CHECKING, OTHER, LC, BOLETO;) └ pay_status String UNPAY 支付状态: UNPAY //未支付 PAYING, //买家支付中，主要是包含验证的过程 PAID, //买家支付完成，对应批发是支付成功 CAPTURED, //请款完成，到这步就代表资金会到账，对应批发是审核成功 RELATING, //关联中，挂帐就会进入此状态 FULFILLED, //已完成，代表这个支付单已经收齐（自动收齐或者手动收齐） FAILED, //支付失败，可以重新进行支付 CANCELED, //支付撤销，可以重新进行支付 CLOSED; //支付单被关闭，终态) └ pay_step String ADVANCE 支付阶段(ADVANCE//预付款, BALANCE//尾款) pay_time DateVo 2018-10-10 00:00:00 支付时间 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台按美西时区会格式化好) └ timestamp Number 12345 时间戳 receive_amount Price receive_amount 到账金额 └ amount String 12.00 金额 └ currency String USD 币种 receive_time DateVo 2018-10-10 00:00:00 到账时间 └ timestamp Number 2345 时间戳 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台按美西时区会格式化好) should_pay_amount Price should_pay_amount 应付金额 └ amount String 12.00 金额 └ currency String USD 币种 fund_pay_detail_list FundPayDetail [] 支付详细信息列表(包含预付款和尾款) pay_amount Price 支付金额 └ amount String 12.00 金额 └ currency String USD 币种 pay_time DateVO 支付时间 └ timestamp Number 2345 时间戳 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台按美西时区会格式化好) receive_amount DateVO 实收金额 └ amount String 12.00 金额 └ currency String USD 币种 receive_time Price 到账时间 └ timestamp Number 2345 时间戳 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台按美西时区会格式化好) └ pay_status String UNPAY 支付状态: UNPAY //未支付 PAYING, //买家支付中，主要是包含验证的过程 PAID, //买家支付完成，对应批发是支付成功 CAPTURED, //请款完成，到这步就代表资金会到账，对应批发是审核成功 RELATING, //关联中，挂帐就会进入此状态 FULFILLED, //已完成，代表这个支付单已经收齐（自动收齐或者手动收齐） FAILED, //支付失败，可以重新进行支付 CANCELED, //支付撤销，可以重新进行支付 CLOSED; //支付单被关闭，终态) └ pay_method String TT 支付方式(TT, CREDIT_CARD, E_CHECKING, OTHER, LC, BOLETO;) └ id Number 111111 支付详细信息主键id service_fee Price service_fee 预估交易服务费 └ amount String 1.00 金额 └ currency String USD 币种 refund_list Refund [] {} 已成功退款的信息 amount Price {} 退款金额 └ currency String USD 币种 └ amount String 123.33 金额 refund_time DateVo {} 退款最后更新时间 └ timestamp Number 21345343 时间戳 └ format_date String MMM. d, yyyy, HH:mm:ss z. 格式化后的时间(平台按美西时区会格式化好) └ id Number 123432 退款id

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaSellerOrderFundGetRequest req = new AlibabaSellerOrderFundGetRequest();
req.setETradeId("xxxxxx");
req.setDataSelect("fund_serviceFee,fund_fundPay");
AlibabaSellerOrderFundGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaSellerOrderFundGetRequest req = new AlibabaSellerOrderFundGetRequest();
req.ETradeId = "xxxxxx";
req.DataSelect = "fund_serviceFee,fund_fundPay";
AlibabaSellerOrderFundGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaSellerOrderFundGetRequest;
$req->setETradeId("xxxxxx");
$req->setDataSelect("fund_serviceFee,fund_fundPay");
$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.seller.order.fund.get' \
-d 'partner_id=apidoc' \
-d 'session=139d1e12-dcff-4647-b600-ecaa6ff7b0d6' \
-d 'sign=ED4A9D574696D95ECF75D46E885BE099' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-22+04%3A18%3A27' \
-d 'v=2.0' \
-d 'data_select=fund_serviceFee%2Cfund_fundPay' \
-d 'e_trade_id=xxxxxx'

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

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

req.e_trade_id="xxxxxx"
req.data_select="fund_serviceFee,fund_fundPay"
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.seller.order.fund.get");
add_param(pRequest,"e_trade_id","xxxxxx");
add_param(pRequest,"data_select","fund_serviceFee,fund_fundPay");
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.seller.order.fund.get', {
	'e_trade_id':'xxxxxx',
	'data_select':'fund_serviceFee,fund_fundPay'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_seller_order_fund_get_response>
    <value>
        <fund_pay_list>
            <fund_pay>
                <pay_amount>
                    <amount>12.00</amount>
                    <currency>USD</currency>
                </pay_amount>
                <pay_method>TT</pay_method>
                <pay_status>UNPAY</pay_status>
                <pay_step>ADVANCE</pay_step>
                <pay_time>
                    <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                    <timestamp>12345</timestamp>
                </pay_time>
                <receive_amount>
                    <amount>12.00</amount>
                    <currency>USD</currency>
                </receive_amount>
                <receive_time>
                    <timestamp>2345</timestamp>
                    <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                </receive_time>
                <should_pay_amount>
                    <amount>12.00</amount>
                    <currency>USD</currency>
                </should_pay_amount>
                <fund_pay_detail_list>
                    <fund_pay_detail>
                        <pay_amount>
                            <amount>12.00</amount>
                            <currency>USD</currency>
                        </pay_amount>
                        <pay_time>
                            <timestamp>2345</timestamp>
                            <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                        </pay_time>
                        <receive_amount>
                            <amount>12.00</amount>
                            <currency>USD</currency>
                        </receive_amount>
                        <receive_time>
                            <timestamp>2345</timestamp>
                            <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                        </receive_time>
                        <pay_status>UNPAY</pay_status>
                        <pay_method>TT</pay_method>
                        <id>111111</id>
                    </fund_pay_detail>
                </fund_pay_detail_list>
            </fund_pay>
        </fund_pay_list>
        <service_fee>
            <amount>1.00</amount>
            <currency>USD</currency>
        </service_fee>
        <refund_list>
            <refund>
                <amount>
                    <currency>USD</currency>
                    <amount>123.33</amount>
                </amount>
                <refund_time>
                    <timestamp>21345343</timestamp>
                    <format_date>MMM. d, yyyy, HH:mm:ss z.</format_date>
                </refund_time>
                <id>123432</id>
            </refund>
        </refund_list>
    </value>
</alibaba_seller_order_fund_get_response>

{
    "alibaba_seller_order_fund_get_response":{
        "value":{
            "fund_pay_list":{
                "fund_pay":[
                    {
                        "pay_amount":{
                            "amount":"12.00",
                            "currency":"USD"
                        },
                        "pay_method":"TT",
                        "pay_status":"UNPAY",
                        "pay_step":"ADVANCE",
                        "pay_time":{
                            "format_date":"MMM. d, yyyy, HH:mm:ss z.",
                            "timestamp":12345
                        },
                        "receive_amount":{
                            "amount":"12.00",
                            "currency":"USD"
                        },
                        "receive_time":{
                            "timestamp":2345,
                            "format_date":"MMM. d, yyyy, HH:mm:ss z."
                        },
                        "should_pay_amount":{
                            "amount":"12.00",
                            "currency":"USD"
                        },
                        "fund_pay_detail_list":{
                            "fund_pay_detail":[
                                {
                                    "pay_amount":{
                                        "amount":"12.00",
                                        "currency":"USD"
                                    },
                                    "pay_time":{
                                        "timestamp":2345,
                                        "format_date":"MMM. d, yyyy, HH:mm:ss z."
                                    },
                                    "receive_amount":{
                                        "amount":"12.00",
                                        "currency":"USD"
                                    },
                                    "receive_time":{
                                        "timestamp":2345,
                                        "format_date":"MMM. d, yyyy, HH:mm:ss z."
                                    },
                                    "pay_status":"UNPAY",
                                    "pay_method":"TT",
                                    "id":111111
                                }
                            ]
                        }
                    }
                ]
            },
            "service_fee":{
                "amount":"1.00",
                "currency":"USD"
            },
            "refund_list":{
                "refund":[
                    {
                        "amount":{
                            "currency":"USD",
                            "amount":"123.33"
                        },
                        "refund_time":{
                            "timestamp":21345343,
                            "format_date":"MMM. d, yyyy, HH:mm:ss z."
                        },
                        "id":123432
                    }
                ]
            }
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

ICBU－交易

alibaba.seller.order.fund.get (查询交易订单资金信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ