淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
mz_order_id	String	必须	412963624031	最大长度：32	麦座订单id；非空
mz_user_id	String	必须	7383771901	最大长度：32	麦座用户id；非空

名称	类型	示例值	描述
result	ResultData		api返回结果
└ msg String 成功提示 └ code String 200 状态码 data OrderDetailVO 订单出参 └ mz_order_id String 412963624031 麦座订单id └ mz_user_id String 7383771901 麦座用户id └ order_state Number 1 订单状态；1=订单未完成，2=订单已完成，3=订单已关闭 └ order_pay_state Number 2 订单支付状态；1=已支付，2=待支付 └ refund_order_state Number 1 订单退单状态；退单状态：1=未退单，2=部分退单，3=已退单，4=退单申请中 └ create_order_time String 2019-12-31 11:30:23 下单时间；精确到秒，格式：yyyy-MM-dd HH:mm:ss └ auto_cancel_order_time String 2019-12-31 12:01:23 订单失效时间；麦座超时未支付系统取消订单时间点，精确到秒，格式：yyyy-MM-dd HH:mm:ss └ order_receive_money_fen Number 38000 麦座订单应收金额；商品应收金额+订单运费金额-优惠金额；单位：分； └ price_promotion_money_fen Number 4000 票品优惠金额（套票+票品优惠）；单位：分； └ order_promotion_money_fen Number 4000 订单优惠金额；单位：分； └ coupon_code_promotion_money_fen Number 5000 优惠码优惠金额；单位：分； order_receive_info OrderReceiveInfo 订单取票人信息 └ delivery_type Number 3 取票方式；2=身份证自助换票（换纸质票），3=取票码自助换票（换纸质票）， 4=二维码自助换票（换纸质票），6=二维码电子票（无纸质票）；7=快递（门店订单为纸质票直接打票）11=证件电子票；30=未选择出票方式（只门店订单会有此情况） └ collector_name String 李xx 取票人姓名；非空 └ collector_phone String xxxxxxx4567 取票人手机号；11位；非空 └ collector_card_type Number 1 取票人证件类型；1=身份证；所购买商品实名制类型为一单一证限制时，非空； └ collector_card_no String 1xxxxxxxxxxxxxxxx2 取票人证件号；所购买商品实名制类型为一单一证限制时，非空；脱敏； └ express_receiver_name String 李xx 收货人姓名；deliveryType=快递时非空 └ express_receiver_phone String xxxxxxx1234 收货人手机号；deliveryType=快递时非空 └ express_receiver_address String 北京市朝阳区望京街道xxx号收货地址；deliveryType=快递时非空 └ express_express_company_name String 顺丰配送公司名称； order_pay_detail_list OrderPayDetail [] 订单支付详情列表 └ pay_type_id String 83731 支付类型id； └ pay_type_name String 支付宝支付方式名称； └ pay_money_fen String 22000 支付金额；单位：分 single_ticket_order_detail_list SingleTicketOrderDetail [] 订单单票明细； └ order_detail_id String 39384841341 订单单票明细id； └ coupon_ticket_type Number 1 套票类型；1=单票，2=套票 └ project_seat_type Number 1 项目座位类型；1=有座，2=无座 └ project_id String 93884143101 项目id └ project_img_url String https://xxx.jpg 项目海报图； └ project_name String 乌龙山伯爵项目名称 └ event_id String 29841900341 场次id └ event_name String 2020-02-22 18:00 场次名称 └ event_start_time String 2020-02-22 18:00 场次演出开始时间，精确到分，格式：yyyy-MM-dd HH:mm └ price_id String 29388001344 票档id └ price_name String 380元票档名称 └ price_money_fen Number 38000 票档价格；单位：分 └ venue_name String 北京世纪剧院场馆名称 └ floor_name String 1楼楼层名称； └ stand_name String vip区看台名称； └ row_name String 1排排名称； └ seat_no_name String 16号座位号名称； └ goods_promotion_money_fen Number 5000 票单优惠金额；包括各种分摊；单位：分 └ goods_receive_money_fen Number 33000 票单实收金额；单位：分 └ real_name String 李x 持票人真实姓名；所购买商品实名制类型为一票一证限制时，非空；脱敏； └ goods_source_money_fen Number 38000 商品原价；单位：分 └ card_type Number 1 持票人证件类型；1=身份证；所购买商品实名制类型为一票一证限制时，非空； └ card_no String 1xxxxxxxxxxxxxxxx2 持票人证件号；所购买商品实名制类型为一票一证限制时，非空；脱敏 └ ticket_code_no String 111452207 票单id；已支付的订单才有票单id package_ticket_order_detail_list PackageTicketOrderDetail [] 订单套票明细； └ coupon_ticket_type Number 2 套票类型；1=单票，2=套票 └ package_goods_receive_money_fen Number 60000 套票实收金额；单位：分 └ package_goods_source_money_fen Number 76000 套票商品原价；单位：分 └ price_money_fen Number 60000 套票票档价格；单位：分 single_ticket_order_detail_list SingleTicketOrderDetail [] 套票所包含单票明细 └ order_detail_id String 29301084123 订单单票明细id； └ coupon_ticket_type Number 1 套票类型；1=单票，2=套票 └ project_seat_type Number 1 项目座位类型；1=有座，2=无座 └ project_id String 8373918341 项目id └ project_img_url String https://xxx.jpg 项目海报图 └ project_name String 乌龙山伯爵项目名称 └ goods_source_money_fen Number 38000 商品原价；单位：分 └ card_type Number 1 持票人证件类型；1=身份证；所购买商品实名制类型为一票一证限制时，非空； └ real_name String 李x 持票人真实姓名；所购买商品实名制类型为一票一证限制时，非空；脱敏； └ card_no String 1xxxxxxxxxxxxxxxx2 持票人证件号；所购买商品实名制类型为一票一证限制时，非空；脱敏 └ event_id String 193730109441 场次id └ event_name String 2020-02-22 18:00 场次名称 └ event_start_time String 2020-02-22 18:00 场次演出开始时间，精确到分，格式：yyyy-MM-dd HH:mm └ price_id String 29838919311 票档id └ price_name String 380元票档名称 └ venue_name String 北京世纪剧院场馆名称 └ price_money_fen Number 38000 票档价格；单位：分 └ stand_name String vip区看台名称； └ floor_name String 1楼楼层名称； └ row_name String 3排排名称； └ seat_no_name String 5号座位号名称； └ goods_promotion_money_fen Number 3000 票单优惠金额；包括各种分摊；单位：分 └ goods_receive_money_fen Number 25000 票单实收金额；单位：分 └ ticket_code_no String 111452207 票单id；已支付的订单才有票单id └ order_express_money_fen Number 1000 订单运费金额；单位：分 └ online_payment_money_fen Number 15000 在线支付的金额；订单应收金额 - 积分抵扣的金额 - 使用余额支付的金额 - 礼品卡抵扣金额；单位：分 └ use_card_money_fen Number 1300 使用的礼品卡金额；单位：分 └ use_card_no String hag8172hg1314 使用礼品卡卡号 └ use_account_money_fen Number 1000 使用账户余额金额；单位：分 └ use_point_money_fen Number 1800 使用积分金额；单位：分； └ use_card_id String 818828184 使用礼品卡id └ use_point Number 1800 使用用户积分点数；单位：点数； └ success Boolean true api请求是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzOrderDetailRequest req = new AlibabaDamaiMzOrderDetailRequest();
req.setMzOrderId("412963624031");
req.setMzUserId("7383771901");
AlibabaDamaiMzOrderDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzOrderDetailRequest req = new AlibabaDamaiMzOrderDetailRequest();
req.MzOrderId = "412963624031";
req.MzUserId = "7383771901";
AlibabaDamaiMzOrderDetailResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzOrderDetailRequest;
$req->setMzOrderId("412963624031");
$req->setMzUserId("7383771901");
$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.damai.mz.order.detail' \
-d 'partner_id=apidoc' \
-d 'sign=73222670927112F128C94696B4816B02' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+04%3A14%3A23' \
-d 'v=2.0' \
-d 'mz_order_id=412963624031' \
-d 'mz_user_id=7383771901'

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

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

req.mz_order_id="412963624031"
req.mz_user_id="7383771901"
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.damai.mz.order.detail");
add_param(pRequest,"mz_order_id","412963624031");
add_param(pRequest,"mz_user_id","7383771901");
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.damai.mz.order.detail', {
	'mz_order_id':'412963624031',
	'mz_user_id':'7383771901'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_mz_order_detail_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <mz_order_id>412963624031</mz_order_id>
            <mz_user_id>7383771901</mz_user_id>
            <order_state>1</order_state>
            <order_pay_state>2</order_pay_state>
            <refund_order_state>1</refund_order_state>
            <create_order_time>2019-12-31 11:30:23</create_order_time>
            <auto_cancel_order_time>2019-12-31 12:01:23</auto_cancel_order_time>
            <order_receive_money_fen>38000</order_receive_money_fen>
            <price_promotion_money_fen>4000</price_promotion_money_fen>
            <order_promotion_money_fen>4000</order_promotion_money_fen>
            <coupon_code_promotion_money_fen>5000</coupon_code_promotion_money_fen>
            <order_receive_info>
                <delivery_type>3</delivery_type>
                <collector_name>李xx</collector_name>
                <collector_phone>xxxxxxx4567</collector_phone>
                <collector_card_type>1</collector_card_type>
                <collector_card_no>1xxxxxxxxxxxxxxxx2</collector_card_no>
                <express_receiver_name>李xx</express_receiver_name>
                <express_receiver_phone>xxxxxxx1234</express_receiver_phone>
                <express_receiver_address>北京市朝阳区望京街道xxx号</express_receiver_address>
                <express_express_company_name>顺丰</express_express_company_name>
            </order_receive_info>
            <order_pay_detail_list>
                <order_pay_detail>
                    <pay_type_id>83731</pay_type_id>
                    <pay_type_name>支付宝</pay_type_name>
                    <pay_money_fen>22000</pay_money_fen>
                </order_pay_detail>
            </order_pay_detail_list>
            <single_ticket_order_detail_list>
                <single_ticket_order_detail>
                    <order_detail_id>39384841341</order_detail_id>
                    <coupon_ticket_type>1</coupon_ticket_type>
                    <project_seat_type>1</project_seat_type>
                    <project_id>93884143101</project_id>
                    <project_img_url>https://xxx.jpg</project_img_url>
                    <project_name>乌龙山伯爵</project_name>
                    <event_id>29841900341</event_id>
                    <event_name>2020-02-22 18:00</event_name>
                    <event_start_time>2020-02-22 18:00</event_start_time>
                    <price_id>29388001344</price_id>
                    <price_name>380元</price_name>
                    <price_money_fen>38000</price_money_fen>
                    <venue_name>北京世纪剧院</venue_name>
                    <floor_name>1楼</floor_name>
                    <stand_name>vip区</stand_name>
                    <row_name>1排</row_name>
                    <seat_no_name>16号</seat_no_name>
                    <goods_promotion_money_fen>5000</goods_promotion_money_fen>
                    <goods_receive_money_fen>33000</goods_receive_money_fen>
                    <real_name>李x</real_name>
                    <goods_source_money_fen>38000</goods_source_money_fen>
                    <card_type>1</card_type>
                    <card_no>1xxxxxxxxxxxxxxxx2</card_no>
                    <ticket_code_no>111452207</ticket_code_no>
                </single_ticket_order_detail>
            </single_ticket_order_detail_list>
            <package_ticket_order_detail_list>
                <package_ticket_order_detail>
                    <coupon_ticket_type>2</coupon_ticket_type>
                    <package_goods_receive_money_fen>60000</package_goods_receive_money_fen>
                    <package_goods_source_money_fen>76000</package_goods_source_money_fen>
                    <price_money_fen>60000</price_money_fen>
                    <single_ticket_order_detail_list>
                        <single_ticket_order_detail>
                            <order_detail_id>29301084123</order_detail_id>
                            <coupon_ticket_type>1</coupon_ticket_type>
                            <project_seat_type>1</project_seat_type>
                            <project_id>8373918341</project_id>
                            <project_img_url>https://xxx.jpg</project_img_url>
                            <project_name>乌龙山伯爵</project_name>
                            <goods_source_money_fen>38000</goods_source_money_fen>
                            <card_type>1</card_type>
                            <real_name>李x</real_name>
                            <card_no>1xxxxxxxxxxxxxxxx2</card_no>
                            <event_id>193730109441</event_id>
                            <event_name>2020-02-22 18:00</event_name>
                            <event_start_time>2020-02-22 18:00</event_start_time>
                            <price_id>29838919311</price_id>
                            <price_name>380元</price_name>
                            <venue_name>北京世纪剧院</venue_name>
                            <price_money_fen>38000</price_money_fen>
                            <stand_name>vip区</stand_name>
                            <floor_name>1楼</floor_name>
                            <row_name>3排</row_name>
                            <seat_no_name>5号</seat_no_name>
                            <goods_promotion_money_fen>3000</goods_promotion_money_fen>
                            <goods_receive_money_fen>25000</goods_receive_money_fen>
                            <ticket_code_no>111452207</ticket_code_no>
                        </single_ticket_order_detail>
                    </single_ticket_order_detail_list>
                </package_ticket_order_detail>
            </package_ticket_order_detail_list>
            <order_express_money_fen>1000</order_express_money_fen>
            <online_payment_money_fen>15000</online_payment_money_fen>
            <use_card_money_fen>1300</use_card_money_fen>
            <use_card_no>hag8172hg1314</use_card_no>
            <use_account_money_fen>1000</use_account_money_fen>
            <use_point_money_fen>1800</use_point_money_fen>
            <use_card_id>818828184</use_card_id>
            <use_point>1800</use_point>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_order_detail_response>

{
    "alibaba_damai_mz_order_detail_response":{
        "result":{
            "msg":"成功",
            "code":"200",
            "data":{
                "mz_order_id":"412963624031",
                "mz_user_id":"7383771901",
                "order_state":1,
                "order_pay_state":2,
                "refund_order_state":1,
                "create_order_time":"2019-12-31 11:30:23",
                "auto_cancel_order_time":"2019-12-31 12:01:23",
                "order_receive_money_fen":38000,
                "price_promotion_money_fen":4000,
                "order_promotion_money_fen":4000,
                "coupon_code_promotion_money_fen":5000,
                "order_receive_info":{
                    "delivery_type":3,
                    "collector_name":"李xx",
                    "collector_phone":"xxxxxxx4567",
                    "collector_card_type":1,
                    "collector_card_no":"1xxxxxxxxxxxxxxxx2",
                    "express_receiver_name":"李xx",
                    "express_receiver_phone":"xxxxxxx1234",
                    "express_receiver_address":"北京市朝阳区望京街道xxx号",
                    "express_express_company_name":"顺丰"
                },
                "order_pay_detail_list":{
                    "order_pay_detail":[
                        {
                            "pay_type_id":"83731",
                            "pay_type_name":"支付宝",
                            "pay_money_fen":"22000"
                        }
                    ]
                },
                "single_ticket_order_detail_list":{
                    "single_ticket_order_detail":[
                        {
                            "order_detail_id":"39384841341",
                            "coupon_ticket_type":1,
                            "project_seat_type":1,
                            "project_id":"93884143101",
                            "project_img_url":"https:\/\/xxx.jpg",
                            "project_name":"乌龙山伯爵",
                            "event_id":"29841900341",
                            "event_name":"2020-02-22 18:00",
                            "event_start_time":"2020-02-22 18:00",
                            "price_id":"29388001344",
                            "price_name":"380元",
                            "price_money_fen":38000,
                            "venue_name":"北京世纪剧院",
                            "floor_name":"1楼",
                            "stand_name":"vip区",
                            "row_name":"1排",
                            "seat_no_name":"16号",
                            "goods_promotion_money_fen":5000,
                            "goods_receive_money_fen":33000,
                            "real_name":"李x",
                            "goods_source_money_fen":38000,
                            "card_type":1,
                            "card_no":"1xxxxxxxxxxxxxxxx2",
                            "ticket_code_no":"111452207"
                        }
                    ]
                },
                "package_ticket_order_detail_list":{
                    "package_ticket_order_detail":[
                        {
                            "coupon_ticket_type":2,
                            "package_goods_receive_money_fen":60000,
                            "package_goods_source_money_fen":76000,
                            "price_money_fen":60000,
                            "single_ticket_order_detail_list":{
                                "single_ticket_order_detail":[
                                    {
                                        "order_detail_id":"29301084123",
                                        "coupon_ticket_type":1,
                                        "project_seat_type":1,
                                        "project_id":"8373918341",
                                        "project_img_url":"https:\/\/xxx.jpg",
                                        "project_name":"乌龙山伯爵",
                                        "goods_source_money_fen":38000,
                                        "card_type":1,
                                        "real_name":"李x",
                                        "card_no":"1xxxxxxxxxxxxxxxx2",
                                        "event_id":"193730109441",
                                        "event_name":"2020-02-22 18:00",
                                        "event_start_time":"2020-02-22 18:00",
                                        "price_id":"29838919311",
                                        "price_name":"380元",
                                        "venue_name":"北京世纪剧院",
                                        "price_money_fen":38000,
                                        "stand_name":"vip区",
                                        "floor_name":"1楼",
                                        "row_name":"3排",
                                        "seat_no_name":"5号",
                                        "goods_promotion_money_fen":3000,
                                        "goods_receive_money_fen":25000,
                                        "ticket_code_no":"111452207"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "order_express_money_fen":1000,
                "online_payment_money_fen":15000,
                "use_card_money_fen":1300,
                "use_card_no":"hag8172hg1314",
                "use_account_money_fen":1000,
                "use_point_money_fen":1800,
                "use_card_id":"818828184",
                "use_point":1800
            },
            "success":true
        }
    }
}

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

错误码	错误描述	解决方案
40100000	api未知错误	通用系统异常
40100001	api请求失败	通用业务异常
40100006	请求必须的参数麦座会员id不能为空	请求必须的参数麦座会员id不能为空
15010001	单据不存在	单据不存在
15010014	请求参数不能为空	请求参数不能为空
15010018	请求参数不合法	请求参数不合法
15010020	操作正在进行中，请稍后再试	操作正在进行中，请稍后再试

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

开放平台

麦座API

alibaba.damai.mz.order.detail (订单详情API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ