阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
buyer_ip	String	可选	127.0.0.1		购买者IP
tag_list	String	可选	174574		标签
origin_pay_out_order_id	String	可选	48468486486489		在退款订单中，该字段必填
buyer_nick	String	可选	阿里体育		购买者昵称
buyer_id	String	可选	feafe4as646asfe48		购买者ID
out_order_id	String	必须	15982017082219200172935274334		业务方订单号
total_fee	Number	必须	1		订单总价
auction_title	String	必须	阿里体育比赛产品		商品标题
auction_desc	String	可选	阿里体育比赛产品		商品描述
auction_url	String	可选	https://www.taobao.com/		商品展示URL
auction_price	Number	必须	1		商品单价
buy_amount	Number	必须	1		购买数量
seller_id	String	可选	2088881821865		商家ID
seller_nick	String	可选	阿里体育票务旗舰店		商家昵称
child_order_list	ChildOrder []	可选		最大列表长度：20	子订单列表
└ buyer_pay_account String 可选 2088602010941991 支付宝或者微信返回的支付用户ID └ platform String 必须 PC 完成订单支付的平台 PC：电脑网站 MOBILE_WEB:移动网页端 MOBILE_SDK:应用SDK BARCODE:条形码支付，特指用扫描枪扫描用户 QR_CODE:用户扫描支付宝或微信生成的二维码 POS:pos机刷卡 BANK_TRANSFER：银行转账 CASH：现金支付 UNKNOMN：未知 └ pay_time String 必须 1504079090 完成支付的时间，精确到秒的时间戳 └ tag_list String 可选 58648 用逗号分隔的数字字符串，每一个数字代表一种标签 └ pay_id Number 必须 1 收款账户ID，不同的账户有不同的ID 注：即使是现金收款也可以建立一个现金账户 └ buy_amount Number 必须 1 购买数量 └ auction_price Number 必须 1 商品单价，以分为单位 └ auction_url String 可选 https://www.taobao.com/ 商品展示URL └ auction_title String 必须阿里体育比赛产品商品或订单标题 └ total_fee Number 必须 1 以分为单位的子订单价格 └ out_pay_id String 必须 2017082221001004990233484737 订单在支付宝或微信等第三方支付渠道生成的流水号 └ out_order_id String 必须 15982017082219200172935274334 业务方子订单号 └ bank_type String 可选 ALIPAY 付款银行:ALIPAY/WXPAY/POS └ venue_id String 可选 10007 默认值：0 场馆ID └ create_time String 可选 1504079090 订单创建时间
remark	String	可选	中心：安庆体育中心		备注
bank_type	String	可选	ALIPAY		付款银行:ALIPAY/WXPAY/POS
venue_id	String	可选	10007	默认值：0	场馆ID
create_time	String	可选	1504079090		订单创建时间

名称	类型	示例值	描述
alisp_code	Number	200	响应值，200为正常
alisp_msg	String	SUCCESS	响应信息
alisp_data	Json	{}	详情

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlisportsTradeOrderSyncForXportsRequest req = new AlibabaAlisportsTradeOrderSyncForXportsRequest();
req.setBuyerIp("127.0.0.1");
req.setTagList("174574");
req.setOriginPayOutOrderId("48468486486489");
req.setBuyerNick("阿里体育");
req.setBuyerId("feafe4as646asfe48");
req.setOutOrderId("15982017082219200172935274334");
req.setTotalFee(1L);
req.setAuctionTitle("阿里体育比赛产品");
req.setAuctionDesc("阿里体育比赛产品");
req.setAuctionUrl("https://www.taobao.com/");
req.setAuctionPrice(1L);
req.setBuyAmount(1L);
req.setSellerId("2088881821865");
req.setSellerNick("阿里体育票务旗舰店");
List<AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrder> list2 = new ArrayList<AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrder>();
AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrder obj3 = new AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrder();
list2.add(obj3);
obj3.setBuyerPayAccount("2088602010941991");
obj3.setPlatform("PC");
obj3.setPayTime("1504079090");
obj3.setTagList("58648");
obj3.setPayId(1L);
obj3.setBuyAmount(1L);
obj3.setAuctionPrice(1L);
obj3.setAuctionUrl("https://www.taobao.com/");
obj3.setAuctionTitle("阿里体育比赛产品");
obj3.setTotalFee(1L);
obj3.setOutPayId("2017082221001004990233484737");
obj3.setOutOrderId("15982017082219200172935274334");
obj3.setBankType("ALIPAY");
obj3.setVenueId("10007");
obj3.setCreateTime("1504079090");
req.setChildOrderList(list2);
req.setRemark("中心：安庆体育中心");
req.setBankType("ALIPAY");
req.setVenueId("10007");
req.setCreateTime("1504079090");
AlibabaAlisportsTradeOrderSyncForXportsResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlisportsTradeOrderSyncForXportsRequest req = new AlibabaAlisportsTradeOrderSyncForXportsRequest();
req.BuyerIp = "127.0.0.1";
req.TagList = "174574";
req.OriginPayOutOrderId = "48468486486489";
req.BuyerNick = "阿里体育";
req.BuyerId = "feafe4as646asfe48";
req.OutOrderId = "15982017082219200172935274334";
req.TotalFee = 1L;
req.AuctionTitle = "阿里体育比赛产品";
req.AuctionDesc = "阿里体育比赛产品";
req.AuctionUrl = "https://www.taobao.com/";
req.AuctionPrice = 1L;
req.BuyAmount = 1L;
req.SellerId = "2088881821865";
req.SellerNick = "阿里体育票务旗舰店";
List<AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrderDomain> list2 = new List<AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrderDomain>();
AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrderDomain obj3 = new AlibabaAlisportsTradeOrderSyncForXportsRequest.ChildOrderDomain();
list2.Add(obj3);
obj3.BuyerPayAccount = "2088602010941991";
obj3.Platform = "PC";
obj3.PayTime = "1504079090";
obj3.TagList = "58648";
obj3.PayId = 1L;
obj3.BuyAmount = 1L;
obj3.AuctionPrice = 1L;
obj3.AuctionUrl = "https://www.taobao.com/";
obj3.AuctionTitle = "阿里体育比赛产品";
obj3.TotalFee = 1L;
obj3.OutPayId = "2017082221001004990233484737";
obj3.OutOrderId = "15982017082219200172935274334";
obj3.BankType = "ALIPAY";
obj3.VenueId = "10007";
obj3.CreateTime = "1504079090";
req.ChildOrderList_ = list2;
req.Remark = "中心：安庆体育中心";
req.BankType = "ALIPAY";
req.VenueId = "10007";
req.CreateTime = "1504079090";
AlibabaAlisportsTradeOrderSyncForXportsResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlisportsTradeOrderSyncForXportsRequest;
$req->setBuyerIp("127.0.0.1");
$req->setTagList("174574");
$req->setOriginPayOutOrderId("48468486486489");
$req->setBuyerNick("阿里体育");
$req->setBuyerId("feafe4as646asfe48");
$req->setOutOrderId("15982017082219200172935274334");
$req->setTotalFee("1");
$req->setAuctionTitle("阿里体育比赛产品");
$req->setAuctionDesc("阿里体育比赛产品");
$req->setAuctionUrl("https://www.taobao.com/");
$req->setAuctionPrice("1");
$req->setBuyAmount("1");
$req->setSellerId("2088881821865");
$req->setSellerNick("阿里体育票务旗舰店");
$child_order_list = new ChildOrder;
$child_order_list->buyer_pay_account="2088602010941991";
$child_order_list->platform="PC";
$child_order_list->pay_time="1504079090";
$child_order_list->tag_list="58648";
$child_order_list->pay_id="1";
$child_order_list->buy_amount="1";
$child_order_list->auction_price="1";
$child_order_list->auction_url="https://www.taobao.com/";
$child_order_list->auction_title="阿里体育比赛产品";
$child_order_list->total_fee="1";
$child_order_list->out_pay_id="2017082221001004990233484737";
$child_order_list->out_order_id="15982017082219200172935274334";
$child_order_list->bank_type="ALIPAY";
$child_order_list->venue_id="10007";
$child_order_list->create_time="1504079090";
$req->setChildOrderList(json_encode($child_order_list));
$req->setRemark("中心：安庆体育中心");
$req->setBankType("ALIPAY");
$req->setVenueId("10007");
$req->setCreateTime("1504079090");
$resp = $c->execute($req);

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.alisports.trade.order.sync.for.xports' \
-d 'partner_id=apidoc' \
-d 'sign=F12777AE28AC04A08BDAE690FD2D73E1' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-26+00%3A38%3A23' \
-d 'v=2.0' \
-d 'auction_desc=%E9%98%BF%E9%87%8C%E4%BD%93%E8%82%B2%E6%AF%94%E8%B5%9B%E4%BA%A7%E5%93%81' \
-d 'auction_price=1' \
-d 'auction_title=%E9%98%BF%E9%87%8C%E4%BD%93%E8%82%B2%E6%AF%94%E8%B5%9B%E4%BA%A7%E5%93%81' \
-d 'auction_url=https%3A%2F%2Fwww.taobao.com%2F' \
-d 'bank_type=ALIPAY' \
-d 'buy_amount=1' \
-d 'buyer_id=feafe4as646asfe48' \
-d 'buyer_ip=127.0.0.1' \
-d 'buyer_nick=%E9%98%BF%E9%87%8C%E4%BD%93%E8%82%B2' \
-d 'child_order_list=null' \
-d 'create_time=1504079090' \
-d 'origin_pay_out_order_id=48468486486489' \
-d 'out_order_id=15982017082219200172935274334' \
-d 'remark=%E4%B8%AD%E5%BF%83%EF%BC%9A%E5%AE%89%E5%BA%86%E4%BD%93%E8%82%B2%E4%B8%AD%E5%BF%83' \
-d 'seller_id=2088881821865' \
-d 'seller_nick=%E9%98%BF%E9%87%8C%E4%BD%93%E8%82%B2%E7%A5%A8%E5%8A%A1%E6%97%97%E8%88%B0%E5%BA%97' \
-d 'tag_list=174574' \
-d 'total_fee=1' \
-d 'venue_id=10007'

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

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

req.buyer_ip="127.0.0.1"
req.tag_list="174574"
req.origin_pay_out_order_id="48468486486489"
req.buyer_nick="阿里体育"
req.buyer_id="feafe4as646asfe48"
req.out_order_id="15982017082219200172935274334"
req.total_fee=1
req.auction_title="阿里体育比赛产品"
req.auction_desc="阿里体育比赛产品"
req.auction_url="https://www.taobao.com/"
req.auction_price=1
req.buy_amount=1
req.seller_id="2088881821865"
req.seller_nick="阿里体育票务旗舰店"
req.child_order_list=""
req.remark="中心：安庆体育中心"
req.bank_type="ALIPAY"
req.venue_id="10007"
req.create_time="1504079090"
try:
	resp= req.getResponse()
	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.alisports.trade.order.sync.for.xports");
add_param(pRequest,"buyer_ip","127.0.0.1");
add_param(pRequest,"tag_list","174574");
add_param(pRequest,"origin_pay_out_order_id","48468486486489");
add_param(pRequest,"buyer_nick","阿里体育");
add_param(pRequest,"buyer_id","feafe4as646asfe48");
add_param(pRequest,"out_order_id","15982017082219200172935274334");
add_param(pRequest,"total_fee","1");
add_param(pRequest,"auction_title","阿里体育比赛产品");
add_param(pRequest,"auction_desc","阿里体育比赛产品");
add_param(pRequest,"auction_url","https://www.taobao.com/");
add_param(pRequest,"auction_price","1");
add_param(pRequest,"buy_amount","1");
add_param(pRequest,"seller_id","2088881821865");
add_param(pRequest,"seller_nick","阿里体育票务旗舰店");
add_param(pRequest,"child_order_list","数据结构JSON示例");
add_param(pRequest,"remark","中心：安庆体育中心");
add_param(pRequest,"bank_type","ALIPAY");
add_param(pRequest,"venue_id","10007");
add_param(pRequest,"create_time","1504079090");
pResponse = top_execute(pClient,pRequest,NULL);
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.alisports.trade.order.sync.for.xports', {
	'buyer_ip':'127.0.0.1',
	'tag_list':'174574',
	'origin_pay_out_order_id':'48468486486489',
	'buyer_nick':'阿里体育',
	'buyer_id':'feafe4as646asfe48',
	'out_order_id':'15982017082219200172935274334',
	'total_fee':'1',
	'auction_title':'阿里体育比赛产品',
	'auction_desc':'阿里体育比赛产品',
	'auction_url':'https://www.taobao.com/',
	'auction_price':'1',
	'buy_amount':'1',
	'seller_id':'2088881821865',
	'seller_nick':'阿里体育票务旗舰店',
	'child_order_list':'数据结构JSON示例',
	'remark':'中心：安庆体育中心',
	'bank_type':'ALIPAY',
	'venue_id':'10007',
	'create_time':'1504079090'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alisports_trade_order_sync_for_xports_response>
    <alisp_code>200</alisp_code>
    <alisp_msg>SUCCESS</alisp_msg>
    <alisp_data>{}</alisp_data>
</alibaba_alisports_trade_order_sync_for_xports_response>

{
    "alibaba_alisports_trade_order_sync_for_xports_response":{
        "alisp_code":200,
        "alisp_msg":"SUCCESS",
        "alisp_data":"{}"
    }
}

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下载

阿里体育API

alibaba.alisports.trade.order.sync.for.xports (交易系统订单同步接口，运享通专用)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈