淘宝开放平台 - 文档中心

请求地址：

环境	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_order_create_request	OrderCreateRequest	必须			Order creation parameter
└ channel_refer_id String 必须 124232 Provide the order number corresponding to the 3rd party ISV logistics_detail LogisticsDetail 必须 Logistics details └ carrier_code String 必须 EX_ASP_JYC_FEDEX For BuyNow orders, use the value shown in the vendorCode field from the shipping cost template API; non-BuyNow orders don’t need to provide this information. alibaba.shipping.freight.calculate 's vender_code shipment_address Address 必须 shipment address └ address String 必须 1000 Fifth Avenue at 82nd Street，New York, NY Specific address └ alternate_address String 可选 1000 Fifth Avenue at 82nd Street，New York, NY Secondary address └ city String 可选 New York Name of the city where the order is completed └ city_code String 可选 NYC City abbreviation └ contact_person String 必须 jack wu Name of contact person └ country String 必须 United States of America Country name └ country_code String 必须 US Country code，ISO3166 standard and has two letters. fax Phone 可选 Fax └ area String 可选 86 fax area └ country String 可选 0571 fax country └ number String 可选 67824793472 fax number └ port String 可选 NewYork Port name └ port_code String 可选 NYC Port code └ province String 可选 California Name of state/province └ province_code String 可选 CA Province/state abbreviation telephone Phone 可选 telephone └ area String 可选 86 telephone area └ country String 可选 0751 telephone country └ number String 可选 35354244223 telephone number └ zip String 可选 314007 zip └ dispatch_location String 可选 CN或US，默认CN 发货地 payment_detail PaymentDetail 必须 Payment details └ shipment_fee String 必须 10 shipment fee └ total_amount String 必须 130 total amount product_list TradeEcologyOrderCreateProduct [] 必须 {} Product list └ product_id Number 必须 2233333 product id └ quantity String 必须 10 quantity └ sku_id String 可选 5678 sku id └ unit_price_str String 必须 10 unit price └ properties String 可选 "{\"platform\":\"Shopify\", \"orderId\": \"1111111111111\"}" Put the order number provided by the 3rd party platform and the name of the 3rd party platform. For example, if the order number is for a transaction made on Shopify, put “Shopify” and the order number. Platform Names can be case ignored: Shopify,CommerceHQ,WooCommerce,GrooveKart,BigCommerce └ remark String 可选 xxx order remark

名称	类型	示例值	描述
value	OrderCreateResponse	{}	Response
└ pay_url String https://biz.alibaba.com/ta/detail.htm?orderId=1234 pay url └ trade_id String 1234 order number

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaBuynowOrderCreateRequest req = new AlibabaBuynowOrderCreateRequest();
AlibabaBuynowOrderCreateRequest.OrderCreateRequest obj1 = new AlibabaBuynowOrderCreateRequest.OrderCreateRequest();
obj1.setChannelReferId("124232");
AlibabaBuynowOrderCreateRequest.LogisticsDetail obj2 = new AlibabaBuynowOrderCreateRequest.LogisticsDetail();
obj2.setCarrierCode("EX_ASP_JYC_FEDEX");
AlibabaBuynowOrderCreateRequest.Address obj3 = new AlibabaBuynowOrderCreateRequest.Address();
obj3.setAddress("1000 Fifth Avenue at 82nd Street，New York, NY");
obj3.setAlternateAddress("1000 Fifth Avenue at 82nd Street，New York, NY");
obj3.setCity("New York");
obj3.setCityCode("NYC");
obj3.setContactPerson("jack wu");
obj3.setCountry("United States of America");
obj3.setCountryCode("US");
AlibabaBuynowOrderCreateRequest.Phone obj4 = new AlibabaBuynowOrderCreateRequest.Phone();
obj4.setArea("86");
obj4.setCountry("0571");
obj4.setNumber("67824793472");
obj3.setFax(obj4);
obj3.setPort("NewYork");
obj3.setPortCode("NYC");
obj3.setProvince("California");
obj3.setProvinceCode("CA");
AlibabaBuynowOrderCreateRequest.Phone obj5 = new AlibabaBuynowOrderCreateRequest.Phone();
obj5.setArea("86");
obj5.setCountry("0751");
obj5.setNumber("35354244223");
obj3.setTelephone(obj5);
obj3.setZip("314007");
obj2.setShipmentAddress(obj3);
obj2.setDispatchLocation("CN或US，默认CN");
obj1.setLogisticsDetail(obj2);
AlibabaBuynowOrderCreateRequest.PaymentDetail obj6 = new AlibabaBuynowOrderCreateRequest.PaymentDetail();
obj6.setShipmentFee("10");
obj6.setTotalAmount("130");
obj1.setPaymentDetail(obj6);
List<AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProduct> list8 = new ArrayList<AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProduct>();
AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProduct obj9 = new AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProduct();
list8.add(obj9);
obj9.setProductId(2233333L);
obj9.setQuantity("10");
obj9.setSkuId("5678");
obj9.setUnitPriceStr("10");
obj1.setProductList(list8);
obj1.setProperties("\"{\\"platform\\":\\"Shopify\\", \\"orderId\\": \\"1111111111111\\"}\"");
obj1.setRemark("xxx");
req.setParamOrderCreateRequest(obj1);
AlibabaBuynowOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaBuynowOrderCreateRequest req = new AlibabaBuynowOrderCreateRequest();
AlibabaBuynowOrderCreateRequest.OrderCreateRequestDomain obj1 = new AlibabaBuynowOrderCreateRequest.OrderCreateRequestDomain();
obj1.ChannelReferId = "124232";
AlibabaBuynowOrderCreateRequest.LogisticsDetailDomain obj2 = new AlibabaBuynowOrderCreateRequest.LogisticsDetailDomain();
obj2.CarrierCode = "EX_ASP_JYC_FEDEX";
AlibabaBuynowOrderCreateRequest.AddressDomain obj3 = new AlibabaBuynowOrderCreateRequest.AddressDomain();
obj3.Address = "1000 Fifth Avenue at 82nd Street，New York, NY";
obj3.AlternateAddress = "1000 Fifth Avenue at 82nd Street，New York, NY";
obj3.City = "New York";
obj3.CityCode = "NYC";
obj3.ContactPerson = "jack wu";
obj3.Country = "United States of America";
obj3.CountryCode = "US";
AlibabaBuynowOrderCreateRequest.PhoneDomain obj4 = new AlibabaBuynowOrderCreateRequest.PhoneDomain();
obj4.Area = "86";
obj4.Country = "0571";
obj4.Number = "67824793472";
obj3.Fax= obj4;
obj3.Port = "NewYork";
obj3.PortCode = "NYC";
obj3.Province = "California";
obj3.ProvinceCode = "CA";
AlibabaBuynowOrderCreateRequest.PhoneDomain obj5 = new AlibabaBuynowOrderCreateRequest.PhoneDomain();
obj5.Area = "86";
obj5.Country = "0751";
obj5.Number = "35354244223";
obj3.Telephone= obj5;
obj3.Zip = "314007";
obj2.ShipmentAddress= obj3;
obj2.DispatchLocation = "CN或US，默认CN";
obj1.LogisticsDetail= obj2;
AlibabaBuynowOrderCreateRequest.PaymentDetailDomain obj6 = new AlibabaBuynowOrderCreateRequest.PaymentDetailDomain();
obj6.ShipmentFee = "10";
obj6.TotalAmount = "130";
obj1.PaymentDetail= obj6;
List<AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProductDomain> list8 = new List<AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProductDomain>();
AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProductDomain obj9 = new AlibabaBuynowOrderCreateRequest.TradeEcologyOrderCreateProductDomain();
list8.Add(obj9);
obj9.ProductId = 2233333L;
obj9.Quantity = "10";
obj9.SkuId = "5678";
obj9.UnitPriceStr = "10";
obj1.ProductList= list8;
obj1.Properties = "\"{\\"platform\\":\\"Shopify\\", \\"orderId\\": \\"1111111111111\\"}\"";
obj1.Remark = "xxx";
req.ParamOrderCreateRequest_ = obj1;
AlibabaBuynowOrderCreateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaBuynowOrderCreateRequest;
$param_order_create_request = new OrderCreateRequest;
$param_order_create_request->channel_refer_id="124232";
$logistics_detail = new LogisticsDetail;
$logistics_detail->carrier_code="EX_ASP_JYC_FEDEX";
$shipment_address = new Address;
$shipment_address->address="1000 Fifth Avenue at 82nd Street，New York, NY";
$shipment_address->alternate_address="1000 Fifth Avenue at 82nd Street，New York, NY";
$shipment_address->city="New York";
$shipment_address->city_code="NYC";
$shipment_address->contact_person="jack wu";
$shipment_address->country="United States of America";
$shipment_address->country_code="US";
$fax = new Phone;
$fax->area="86";
$fax->country="0571";
$fax->number="67824793472";
$shipment_address->fax = $fax;
$shipment_address->port="NewYork";
$shipment_address->port_code="NYC";
$shipment_address->province="California";
$shipment_address->province_code="CA";
$telephone = new Phone;
$telephone->area="86";
$telephone->country="0751";
$telephone->number="35354244223";
$shipment_address->telephone = $telephone;
$shipment_address->zip="314007";
$logistics_detail->shipment_address = $shipment_address;
$logistics_detail->dispatch_location="CN或US，默认CN";
$param_order_create_request->logistics_detail = $logistics_detail;
$payment_detail = new PaymentDetail;
$payment_detail->shipment_fee="10";
$payment_detail->total_amount="130";
$param_order_create_request->payment_detail = $payment_detail;
$product_list = new TradeEcologyOrderCreateProduct;
$product_list->product_id="2233333";
$product_list->quantity="10";
$product_list->sku_id="5678";
$product_list->unit_price_str="10";
$param_order_create_request->product_list = $product_list;
$param_order_create_request->properties="\"{\\"platform\\":\\"Shopify\\", \\"orderId\\": \\"1111111111111\\"}\"";
$param_order_create_request->remark="xxx";
$req->setParamOrderCreateRequest(json_encode($param_order_create_request));
$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.buynow.order.create' \
-d 'partner_id=apidoc' \
-d 'session=a6f3a5e2-f74d-4d2b-9579-413ff806e790' \
-d 'sign=9A526170B32143DBB81A86CCF6C0FC4E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+18%3A07%3A54' \
-d 'v=2.0' \
-d 'param_order_create_request=null'

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

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

req.param_order_create_request=""
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.buynow.order.create");
add_param(pRequest,"param_order_create_request","数据结构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.buynow.order.create', {
	'param_order_create_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_buynow_order_create_response>
    <value>
        <pay_url>https://biz.alibaba.com/ta/detail.htm?orderId=1234</pay_url>
        <trade_id>1234</trade_id>
    </value>
</alibaba_buynow_order_create_response>

{
    "alibaba_buynow_order_create_response":{
        "value":{
            "pay_url":"https:\/\/biz.alibaba.com\/ta\/detail.htm?orderId=1234",
            "trade_id":"1234"
        }
    }
}

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

错误码	错误描述	解决方案
430005	Payment total amount is wrong ？ The reason may be that shipment_fee is not the latest cost, which causes the product price plus the actual shipping cost to be inconsistent with the total price of the incoming order。 So please make sure shipment_fee is the latest	see https://www.yuque.com/docs/share/5bd0917b-399e-4d81-9d1c-6f66672294d4?#nFoVJ
130602	shipping fee is Incorrect	see https://www.yuque.com/docs/share/5bd0917b-399e-4d81-9d1c-6f66672294d4?#nFoVJ
410010	product price is invalid ? The reason is that the unit_price_str passed in is not the latest	see https://www.yuque.com/docs/share/5bd0917b-399e-4d81-9d1c-6f66672294d4?#nFoVJ

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

开放平台

ICBU-DropShipping

alibaba.buynow.order.create (阿里巴巴买家buynow下单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ