淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
tenant_key	String	可选	234	租户标识
token	String	可选	213456789	用户登录标识
coupon_param	CouponParam	可选		使用优惠券的入参
└ coupon_template_id_list Number [] 可选 10,11,12 优惠券模板id集合 discount_param ValidateOrderParam 可选优惠价的试单相关参数透传 guest_by_room_dtos GuestByRoomDto [] 可选无多房价数据状态 └ child_ages String [] 可选 10,11,12 每个儿童的年龄 └ child_roomer_number Number 可选 2 未成年人数 └ adult_roomer_number Number 可选 1 成人数 └ roomer_number Number 可选 3 总入住人数 └ contact_last_name String 可选 f 名 └ contact_first_name String 可选 f 姓 └ payment_type Number 可选 1 支付类型 └ rate_id Number 可选 123435 价格的rateId └ total_price String 可选 12.36元总价格 └ gid Number 可选 123435 宝贝id └ check_out_date String 可选 2021-08-01 离店时间 └ check_in_date String 可选 2021-08-01 入住时间 └ rp_id Number 可选 123435 价格id └ out_room_id Number 可选 123435 飞猪外部房型id └ hotel_id String 可选 123435 外部酒店id └ hid Number 可选 123435 内部酒店id └ rp_code String 可选 1 1 └ room_id String 可选 1 1 └ verify_hotel_id String 可选 5554 前端缓存酒店id no_discount_param ValidateOrderParam 可选原价的试单相关参数透传 guest_by_room_dtos GuestByRoomDto [] 可选 1 多房价数据状态 └ child_ages String [] 可选 10,11,12 每个儿童的年龄 └ child_roomer_number Number 可选 2 未成年人数 └ adult_roomer_number Number 可选 1 成人数 └ roomer_number Number 可选 3 总入住人数 └ contact_last_name String 可选 y 名 └ contact_first_name String 可选 y 姓 └ check_out_date String 可选 2021-08-01 离店时间 └ check_in_date String 可选 2021-08-01 入住时间 └ rp_id Number 可选 123435 价格id └ out_room_id Number 可选 123435 飞猪外部房型id └ hotel_id String 可选 123435 外部酒店id └ hid Number 可选 123435 内部酒店id └ payment_type Number 可选 1 支付类型 └ rate_id Number 可选 123435 价格的rateId └ total_price String 可选 12.36元总价格 └ gid Number 可选 123435 宝贝id └ rp_code String 可选 1 1 └ room_id String 可选 1 1 └ verify_hotel_id String 可选 5554 前端缓存酒店id └ voucher_id String 可选 124357 代金券id derby_voucher_universal_dto DerbyVoucherUniversalDTO 可选权益券相关参数 └ category String 可选 ROOM_DISCOUNT 权益券类型 └ discount_off Number 可选 30 折扣百分比 └ room_type_code String 可选 AWG 房型Code └ rate_plan_code String 可选 1RENO1 价格计划Code └ is_derby_voucher_room Boolean 可选 true 是否为权益房型 └ version String 可选 1 区分版本

名称	类型	示例值	描述
result	Response		携带优惠券试单结果
└ success Boolean true 成功 └ error_msg String 错误信息错误信息 └ error_code String 50030 错误码 content CouponValidateOrderDto 试单结果 coupon_info_v_o CouponInfoVo 优惠券实例对象 └ status String 有效优惠券状态 └ expired_time_min String 2021-08-31 过期时间 └ detail_desc String 凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店详细描述 └ condition_desc String 满800减50 使用条件描述 └ coupon_name String 新人专享优惠券名称 └ condition_amount String 35.51元使用门槛 └ discount_amount String 35.51元面额(减免额度) └ instance_id Number 123345 优惠券实例id └ coupon_type String DISCOUNT 折扣券 instance_v_o_list CouponInfoVo [] 优惠券实例列表 └ status String 有效优惠券状态 └ expired_time_min String 2021-08-31 过期时间 └ detail_desc String 凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店详细描述 └ condition_desc String 满800减50 使用条件描述 └ coupon_name String 新人专享优惠券名称 └ condition_amount String 35.51元使用门槛 └ discount_amount String 35.51元面额(减免额度) └ instance_id Number 123435 优惠券实例id └ coupon_type String ELIGIBILITY_COUPON 优惠券类型 discount_d_t_o ValidateResultVo 折扣价试单结果 daily_price_list DailyPrice [] 每日价格列表 └ really_price String 35.51元每日价格 └ date String 2021-08-21 日期 └ out_really_price String 40.51 外币每日价格 └ is_amount_changed Boolean true 价格发生变化 └ order_code String 213456 订单编号 └ amount_changed_display String 您所预订的酒店价格发生变化，价格上升13.4元价格变化 └ total_tax String 35.51元总税价 └ total_price_exclude_tax String 35.51元总价不含税 └ total_amount String 35.51元实际需要支付金额，含税 cancel_policy CancelPolicy 取消政策 └ cancel_policy_type Number 1 取消政策类型 └ cancel_policy_desc String 吧啦吧啦取消政策描述 └ cancel_policy_name String 限时取消取消政策名称 dining_policy_list DailyInfo [] 每日价格列表 └ day Date 2021-08-08 日期 └ day_str String 年月日日期字符串格式 └ price Number 35.51 不含税价格 └ tax Number 35.51 每天的税，单位分 └ breakfast_count Number 2 早餐数量 └ breakfast_name String 双早早餐名称 └ out_price Number 40.51 外币不含税价格 └ out_tax Number 40.51 外币每天的税，单位分 markup_info MarkupInfoVo 加价信息 └ markup_price Number 200 加价金额 └ markup_desc String 使用套餐券一张，另外需到前台支付200元加价描述 daily_markup_price_list DailyMarkupPrice [] 每日加价信息 └ daily_price String 200 实际加价金额 └ date String 2021-10-08 加价日期 └ total_markup_price Number 400 加价金额总和 foreign_currency ForeignCurrencyDTO 外币信息 └ total_amount String 111.11 外币支付金额，含税 └ total_price String 100.00 外币基础价格,不包含税费等 └ total_tax String 11.11 外币总税价 daily_price_list DailyPrice [] 外币每日价格 └ date String 2020-01-22 00:00:00 日期 └ really_price String 100.00 不含税价格 └ out_really_price String 168.00 不含税外币价格 └ currency String HKD 外币币种 └ foreign_currency_payment Boolean false 是否为外币支付 └ payment_type String 1 支付类型 no_discount_d_t_o ValidateResultVo 原价试单结果 daily_price_list DailyPrice [] 每日价格列表 └ really_price String 35.51元每日价格 └ date String 2021-08-21 日期 └ out_really_price String 40.51 外币每日价格 └ is_amount_changed Boolean true 价格发生变化 └ order_code String 234543 订单编号 └ amount_changed_display String 您所预订的酒店价格发生变化，价格上升13.4元价格变化 └ total_tax String 35.51元总税价 └ total_price_exclude_tax String 35.51元总价不含税 └ total_amount String 35.51元实际需要支付金额，含税 dining_policy_list DailyInfo [] 每日价格列表 └ breakfast_name String 双早早餐名称 └ breakfast_count Number 2 早餐数量 └ tax Number 35.51 每天的税 └ price Number 35.51 不含税价格 └ day_str String 年月日 String化日期 └ day Date 2021-08-21 日期 └ out_tax Number 40.51 外币每天的税 └ out_price Number 40.51 外币不含税价格 cancel_policy CancelPolicy 取消政策 └ cancel_policy_type Number 1 取消政策类型 └ cancel_policy_desc String 1 取消政策描述 └ cancel_policy_name String 限时取消取消政策名字 markup_info MarkupInfoVo 加价信息 └ markup_price Number 200 加价金额 └ markup_desc String 使用套餐券一张，另外需到前台支付200元加价描述 daily_markup_price_list DailyMarkupPrice [] 每日加价信息 └ daily_price String 200 加价金额 └ date String 2021-10-08 加价日期 └ total_markup_price Number 400 加价金额总和 foreign_currency ForeignCurrencyDTO 外币信息 └ total_amount String 111.11 外币支付金额，含税 └ total_price String 100.00 外币基础价格,不包含税费等 └ total_tax String 11.11 外币总税价 daily_price_list DailyPrice [] 外币每日价格 └ date String 2020-01-22 00:00:00 日期 └ really_price String 100.00 不含税价格 └ out_really_price String 168.00 不含税外币价格 └ currency String HKD 币种 └ foreign_currency_payment Boolean false 是否为外币支付 └ payment_type String 1 支付类型 derby_voucher_info DerbyVoucherInfo 权益商品展示信息 └ category String ROOM_DISCOUNT 权益券类型 └ discount_off Number 30 折扣百分比 └ member_voucher_card_id String 123456789980 权益卡卡号 └ member_voucher_id String 609876543243567 权益券id └ long_des String 1.绝对不意气用事2.绝对不漏判任何一件坏事3.绝对裁判的公正漂亮权益券使用限制描述 └ qr_code_i_d_image String dhsjnkf32858nkjnfwosolc 权益卡身份码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripMerchantGalaxyOrderCouponValidateRequest req = new AlitripMerchantGalaxyOrderCouponValidateRequest();
req.setTenantKey("234");
req.setToken("213456789");
AlitripMerchantGalaxyOrderCouponValidateRequest.CouponParam obj1 = new AlitripMerchantGalaxyOrderCouponValidateRequest.CouponParam();
obj1.setCouponTemplateIdList(new Long[] { 10,11,12 };
);
AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParam obj2 = new AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParam();
List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto> list4 = new ArrayList<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto>();
AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto obj5 = new AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto();
list4.add(obj5);
obj5.setChildAges("10,11,12");
obj5.setChildRoomerNumber(2L);
obj5.setAdultRoomerNumber(1L);
obj5.setRoomerNumber(3L);
obj5.setContactLastName("f");
obj5.setContactFirstName("f");
obj2.setGuestByRoomDtos(list4);
obj2.setPaymentType(1L);
obj2.setRateId(123435L);
obj2.setTotalPrice("12.36元");
obj2.setGid(123435L);
obj2.setCheckOutDate("2021-08-01");
obj2.setCheckInDate("2021-08-01");
obj2.setRpId(123435L);
obj2.setOutRoomId(123435L);
obj2.setHotelId("123435");
obj2.setHid(123435L);
obj2.setRpCode("1");
obj2.setRoomId("1");
obj2.setVerifyHotelId("5554");
obj1.setDiscountParam(obj2);
AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParam obj6 = new AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParam();
List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto> list8 = new ArrayList<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto>();
AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto obj9 = new AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDto();
list8.add(obj9);
obj9.setChildAges("10,11,12");
obj9.setChildRoomerNumber(2L);
obj9.setAdultRoomerNumber(1L);
obj9.setRoomerNumber(3L);
obj9.setContactLastName("y");
obj9.setContactFirstName("y");
obj6.setGuestByRoomDtos(list8);
obj6.setCheckOutDate("2021-08-01");
obj6.setCheckInDate("2021-08-01");
obj6.setRpId(123435L);
obj6.setOutRoomId(123435L);
obj6.setHotelId("123435");
obj6.setHid(123435L);
obj6.setPaymentType(1L);
obj6.setRateId(123435L);
obj6.setTotalPrice("12.36元");
obj6.setGid(123435L);
obj6.setRpCode("1");
obj6.setRoomId("1");
obj6.setVerifyHotelId("5554");
obj1.setNoDiscountParam(obj6);
obj1.setVoucherId("124357");
AlitripMerchantGalaxyOrderCouponValidateRequest.DerbyVoucherUniversalDTO obj10 = new AlitripMerchantGalaxyOrderCouponValidateRequest.DerbyVoucherUniversalDTO();
obj10.setCategory("ROOM_DISCOUNT");
obj10.setDiscountOff(30L);
obj10.setRoomTypeCode("AWG");
obj10.setRatePlanCode("1RENO1");
obj10.setIsDerbyVoucherRoom(true);
obj1.setDerbyVoucherUniversalDto(obj10);
obj1.setVersion("1");
req.setCouponParam(obj1);
AlitripMerchantGalaxyOrderCouponValidateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripMerchantGalaxyOrderCouponValidateRequest req = new AlitripMerchantGalaxyOrderCouponValidateRequest();
req.TenantKey = "234";
req.Token = "213456789";
AlitripMerchantGalaxyOrderCouponValidateRequest.CouponParamDomain obj1 = new AlitripMerchantGalaxyOrderCouponValidateRequest.CouponParamDomain();
obj1.CouponTemplateIdList = new long[] { 10,11,12 };
;
AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParamDomain obj2 = new AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParamDomain();
List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain> list4 = new List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain>();
AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain obj5 = new AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain();
list4.Add(obj5);
obj5.ChildAges = "10,11,12";
obj5.ChildRoomerNumber = 2L;
obj5.AdultRoomerNumber = 1L;
obj5.RoomerNumber = 3L;
obj5.ContactLastName = "f";
obj5.ContactFirstName = "f";
obj2.GuestByRoomDtos= list4;
obj2.PaymentType = 1L;
obj2.RateId = 123435L;
obj2.TotalPrice = "12.36元";
obj2.Gid = 123435L;
obj2.CheckOutDate = "2021-08-01";
obj2.CheckInDate = "2021-08-01";
obj2.RpId = 123435L;
obj2.OutRoomId = 123435L;
obj2.HotelId = "123435";
obj2.Hid = 123435L;
obj2.RpCode = "1";
obj2.RoomId = "1";
obj2.VerifyHotelId = "5554";
obj1.DiscountParam= obj2;
AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParamDomain obj6 = new AlitripMerchantGalaxyOrderCouponValidateRequest.ValidateOrderParamDomain();
List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain> list8 = new List<AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain>();
AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain obj9 = new AlitripMerchantGalaxyOrderCouponValidateRequest.GuestByRoomDtoDomain();
list8.Add(obj9);
obj9.ChildAges = "10,11,12";
obj9.ChildRoomerNumber = 2L;
obj9.AdultRoomerNumber = 1L;
obj9.RoomerNumber = 3L;
obj9.ContactLastName = "y";
obj9.ContactFirstName = "y";
obj6.GuestByRoomDtos= list8;
obj6.CheckOutDate = "2021-08-01";
obj6.CheckInDate = "2021-08-01";
obj6.RpId = 123435L;
obj6.OutRoomId = 123435L;
obj6.HotelId = "123435";
obj6.Hid = 123435L;
obj6.PaymentType = 1L;
obj6.RateId = 123435L;
obj6.TotalPrice = "12.36元";
obj6.Gid = 123435L;
obj6.RpCode = "1";
obj6.RoomId = "1";
obj6.VerifyHotelId = "5554";
obj1.NoDiscountParam= obj6;
obj1.VoucherId = "124357";
AlitripMerchantGalaxyOrderCouponValidateRequest.DerbyVoucherUniversalDTODomain obj10 = new AlitripMerchantGalaxyOrderCouponValidateRequest.DerbyVoucherUniversalDTODomain();
obj10.Category = "ROOM_DISCOUNT";
obj10.DiscountOff = 30L;
obj10.RoomTypeCode = "AWG";
obj10.RatePlanCode = "1RENO1";
obj10.IsDerbyVoucherRoom = true;
obj1.DerbyVoucherUniversalDto= obj10;
obj1.Version = "1";
req.CouponParam_ = obj1;
AlitripMerchantGalaxyOrderCouponValidateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripMerchantGalaxyOrderCouponValidateRequest;
$req->setTenantKey("234");
$req->setToken("213456789");
$coupon_param = new CouponParam;
$coupon_param->coupon_template_id_list="10,11,12";
$discount_param = new ValidateOrderParam;
$guest_by_room_dtos = new GuestByRoomDto;
$guest_by_room_dtos->child_ages="10,11,12";
$guest_by_room_dtos->child_roomer_number="2";
$guest_by_room_dtos->adult_roomer_number="1";
$guest_by_room_dtos->roomer_number="3";
$guest_by_room_dtos->contact_last_name="f";
$guest_by_room_dtos->contact_first_name="f";
$discount_param->guest_by_room_dtos = $guest_by_room_dtos;
$discount_param->payment_type="1";
$discount_param->rate_id="123435";
$discount_param->total_price="12.36元";
$discount_param->gid="123435";
$discount_param->check_out_date="2021-08-01";
$discount_param->check_in_date="2021-08-01";
$discount_param->rp_id="123435";
$discount_param->out_room_id="123435";
$discount_param->hotel_id="123435";
$discount_param->hid="123435";
$discount_param->rp_code="1";
$discount_param->room_id="1";
$discount_param->verify_hotel_id="5554";
$coupon_param->discount_param = $discount_param;
$no_discount_param = new ValidateOrderParam;
$guest_by_room_dtos = new GuestByRoomDto;
$guest_by_room_dtos->child_ages="10,11,12";
$guest_by_room_dtos->child_roomer_number="2";
$guest_by_room_dtos->adult_roomer_number="1";
$guest_by_room_dtos->roomer_number="3";
$guest_by_room_dtos->contact_last_name="y";
$guest_by_room_dtos->contact_first_name="y";
$no_discount_param->guest_by_room_dtos = $guest_by_room_dtos;
$no_discount_param->check_out_date="2021-08-01";
$no_discount_param->check_in_date="2021-08-01";
$no_discount_param->rp_id="123435";
$no_discount_param->out_room_id="123435";
$no_discount_param->hotel_id="123435";
$no_discount_param->hid="123435";
$no_discount_param->payment_type="1";
$no_discount_param->rate_id="123435";
$no_discount_param->total_price="12.36元";
$no_discount_param->gid="123435";
$no_discount_param->rp_code="1";
$no_discount_param->room_id="1";
$no_discount_param->verify_hotel_id="5554";
$coupon_param->no_discount_param = $no_discount_param;
$coupon_param->voucher_id="124357";
$derby_voucher_universal_dto = new DerbyVoucherUniversalDTO;
$derby_voucher_universal_dto->category="ROOM_DISCOUNT";
$derby_voucher_universal_dto->discount_off="30";
$derby_voucher_universal_dto->room_type_code="AWG";
$derby_voucher_universal_dto->rate_plan_code="1RENO1";
$derby_voucher_universal_dto->is_derby_voucher_room="true";
$coupon_param->derby_voucher_universal_dto = $derby_voucher_universal_dto;
$coupon_param->version="1";
$req->setCouponParam(json_encode($coupon_param));
$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=alitrip.merchant.galaxy.order.coupon.validate' \
-d 'partner_id=apidoc' \
-d 'sign=DD2EE256C84CB5728957CF8661F9E287' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-05+18%3A21%3A34' \
-d 'v=2.0' \
-d 'coupon_param=null' \
-d 'tenant_key=234' \
-d 'token=213456789'

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

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

req.tenant_key="234"
req.token="213456789"
req.coupon_param=""
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,"alitrip.merchant.galaxy.order.coupon.validate");
add_param(pRequest,"tenant_key","234");
add_param(pRequest,"token","213456789");
add_param(pRequest,"coupon_param","数据结构JSON示例");
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('alitrip.merchant.galaxy.order.coupon.validate', {
	'tenant_key':'234',
	'token':'213456789',
	'coupon_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_merchant_galaxy_order_coupon_validate_response>
    <result>
        <success>true</success>
        <error_msg>错误信息</error_msg>
        <error_code>50030</error_code>
        <content>
            <coupon_info_v_o>
                <status>有效</status>
                <expired_time_min>2021-08-31</expired_time_min>
                <detail_desc>凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店</detail_desc>
                <condition_desc>满800减50</condition_desc>
                <coupon_name>新人专享</coupon_name>
                <condition_amount>35.51元</condition_amount>
                <discount_amount>35.51元</discount_amount>
                <instance_id>123345</instance_id>
                <coupon_type>DISCOUNT</coupon_type>
            </coupon_info_v_o>
            <instance_v_o_list>
                <coupon_info_vo>
                    <status>有效</status>
                    <expired_time_min>2021-08-31</expired_time_min>
                    <detail_desc>凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店</detail_desc>
                    <condition_desc>满800减50</condition_desc>
                    <coupon_name>新人专享</coupon_name>
                    <condition_amount>35.51元</condition_amount>
                    <discount_amount>35.51元</discount_amount>
                    <instance_id>123435</instance_id>
                    <coupon_type>ELIGIBILITY_COUPON</coupon_type>
                </coupon_info_vo>
            </instance_v_o_list>
            <discount_d_t_o>
                <daily_price_list>
                    <daily_price>
                        <really_price>35.51元</really_price>
                        <date>2021-08-21</date>
                        <out_really_price>40.51</out_really_price>
                    </daily_price>
                </daily_price_list>
                <is_amount_changed>true</is_amount_changed>
                <order_code>213456</order_code>
                <amount_changed_display>您所预订的酒店价格发生变化，价格上升13.4元</amount_changed_display>
                <total_tax>35.51元</total_tax>
                <total_price_exclude_tax>35.51元</total_price_exclude_tax>
                <total_amount>35.51元</total_amount>
                <cancel_policy>
                    <cancel_policy_type>1</cancel_policy_type>
                    <cancel_policy_desc>吧啦吧啦</cancel_policy_desc>
                    <cancel_policy_name>限时取消</cancel_policy_name>
                </cancel_policy>
                <dining_policy_list>
                    <daily_info>
                        <day>2021-08-08</day>
                        <day_str>年月日</day_str>
                        <price>35.51</price>
                        <tax>35.51</tax>
                        <breakfast_count>2</breakfast_count>
                        <breakfast_name>双早</breakfast_name>
                        <out_price>40.51</out_price>
                        <out_tax>40.51</out_tax>
                    </daily_info>
                </dining_policy_list>
                <markup_info>
                    <markup_price>200</markup_price>
                    <markup_desc>使用套餐券一张，另外需到前台支付200元</markup_desc>
                    <daily_markup_price_list>
                        <daily_markup_price>
                            <daily_price>200</daily_price>
                            <date>2021-10-08</date>
                        </daily_markup_price>
                    </daily_markup_price_list>
                    <total_markup_price>400</total_markup_price>
                </markup_info>
                <foreign_currency>
                    <total_amount>111.11</total_amount>
                    <total_price>100.00</total_price>
                    <total_tax>11.11</total_tax>
                    <daily_price_list>
                        <daily_price>
                            <date>2020-01-22 00:00:00</date>
                            <really_price>100.00</really_price>
                            <out_really_price>168.00</out_really_price>
                        </daily_price>
                    </daily_price_list>
                    <currency>HKD</currency>
                </foreign_currency>
                <foreign_currency_payment>false</foreign_currency_payment>
                <payment_type>1</payment_type>
            </discount_d_t_o>
            <no_discount_d_t_o>
                <daily_price_list>
                    <daily_price>
                        <really_price>35.51元</really_price>
                        <date>2021-08-21</date>
                        <out_really_price>40.51</out_really_price>
                    </daily_price>
                </daily_price_list>
                <is_amount_changed>true</is_amount_changed>
                <order_code>234543</order_code>
                <amount_changed_display>您所预订的酒店价格发生变化，价格上升13.4元</amount_changed_display>
                <total_tax>35.51元</total_tax>
                <total_price_exclude_tax>35.51元</total_price_exclude_tax>
                <total_amount>35.51元</total_amount>
                <dining_policy_list>
                    <daily_info>
                        <breakfast_name>双早</breakfast_name>
                        <breakfast_count>2</breakfast_count>
                        <tax>35.51</tax>
                        <price>35.51</price>
                        <day_str>年月日</day_str>
                        <day>2021-08-21</day>
                        <out_tax>40.51</out_tax>
                        <out_price>40.51</out_price>
                    </daily_info>
                </dining_policy_list>
                <cancel_policy>
                    <cancel_policy_type>1</cancel_policy_type>
                    <cancel_policy_desc>1</cancel_policy_desc>
                    <cancel_policy_name>限时取消</cancel_policy_name>
                </cancel_policy>
                <markup_info>
                    <markup_price>200</markup_price>
                    <markup_desc>使用套餐券一张，另外需到前台支付200元</markup_desc>
                    <daily_markup_price_list>
                        <daily_markup_price>
                            <daily_price>200</daily_price>
                            <date>2021-10-08</date>
                        </daily_markup_price>
                    </daily_markup_price_list>
                    <total_markup_price>400</total_markup_price>
                </markup_info>
                <foreign_currency>
                    <total_amount>111.11</total_amount>
                    <total_price>100.00</total_price>
                    <total_tax>11.11</total_tax>
                    <daily_price_list>
                        <daily_price>
                            <date>2020-01-22 00:00:00</date>
                            <really_price>100.00</really_price>
                            <out_really_price>168.00</out_really_price>
                        </daily_price>
                    </daily_price_list>
                    <currency>HKD</currency>
                </foreign_currency>
                <foreign_currency_payment>false</foreign_currency_payment>
                <payment_type>1</payment_type>
            </no_discount_d_t_o>
            <derby_voucher_info>
                <category>ROOM_DISCOUNT</category>
                <discount_off>30</discount_off>
                <member_voucher_card_id>123456789980</member_voucher_card_id>
                <member_voucher_id>609876543243567</member_voucher_id>
                <long_des>1.绝对不意气用事2.绝对不漏判任何一件坏事3.绝对裁判的公正漂亮</long_des>
                <qr_code_i_d_image>dhsjnkf32858nkjnfwosolc</qr_code_i_d_image>
            </derby_voucher_info>
        </content>
    </result>
</alitrip_merchant_galaxy_order_coupon_validate_response>

{
    "alitrip_merchant_galaxy_order_coupon_validate_response":{
        "result":{
            "success":true,
            "error_msg":"错误信息",
            "error_code":"50030",
            "content":{
                "coupon_info_v_o":{
                    "status":"有效",
                    "expired_time_min":"2021-08-31",
                    "detail_desc":"凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店",
                    "condition_desc":"满800减50",
                    "coupon_name":"新人专享",
                    "condition_amount":"35.51元",
                    "discount_amount":"35.51元",
                    "instance_id":123345,
                    "coupon_type":"DISCOUNT"
                },
                "instance_v_o_list":{
                    "coupon_info_vo":[
                        {
                            "status":"有效",
                            "expired_time_min":"2021-08-31",
                            "detail_desc":"凭此欢迎礼券于Gap Inc.旗下Gap品牌中国大陆门店",
                            "condition_desc":"满800减50",
                            "coupon_name":"新人专享",
                            "condition_amount":"35.51元",
                            "discount_amount":"35.51元",
                            "instance_id":123435,
                            "coupon_type":"ELIGIBILITY_COUPON"
                        }
                    ]
                },
                "discount_d_t_o":{
                    "daily_price_list":{
                        "daily_price":[
                            {
                                "really_price":"35.51元",
                                "date":"2021-08-21",
                                "out_really_price":"40.51"
                            }
                        ]
                    },
                    "is_amount_changed":true,
                    "order_code":"213456",
                    "amount_changed_display":"您所预订的酒店价格发生变化，价格上升13.4元",
                    "total_tax":"35.51元",
                    "total_price_exclude_tax":"35.51元",
                    "total_amount":"35.51元",
                    "cancel_policy":{
                        "cancel_policy_type":1,
                        "cancel_policy_desc":"吧啦吧啦",
                        "cancel_policy_name":"限时取消"
                    },
                    "dining_policy_list":{
                        "daily_info":[
                            {
                                "day":"2021-08-08",
                                "day_str":"年月日",
                                "price":35.51,
                                "tax":35.51,
                                "breakfast_count":2,
                                "breakfast_name":"双早",
                                "out_price":40.51,
                                "out_tax":40.51
                            }
                        ]
                    },
                    "markup_info":{
                        "markup_price":200,
                        "markup_desc":"使用套餐券一张，另外需到前台支付200元",
                        "daily_markup_price_list":{
                            "daily_markup_price":[
                                {
                                    "daily_price":"200",
                                    "date":"2021-10-08"
                                }
                            ]
                        },
                        "total_markup_price":400
                    },
                    "foreign_currency":{
                        "total_amount":"111.11",
                        "total_price":"100.00",
                        "total_tax":"11.11",
                        "daily_price_list":{
                            "daily_price":[
                                {
                                    "date":"2020-01-22 00:00:00",
                                    "really_price":"100.00",
                                    "out_really_price":"168.00"
                                }
                            ]
                        },
                        "currency":"HKD"
                    },
                    "foreign_currency_payment":false,
                    "payment_type":"1"
                },
                "no_discount_d_t_o":{
                    "daily_price_list":{
                        "daily_price":[
                            {
                                "really_price":"35.51元",
                                "date":"2021-08-21",
                                "out_really_price":"40.51"
                            }
                        ]
                    },
                    "is_amount_changed":true,
                    "order_code":"234543",
                    "amount_changed_display":"您所预订的酒店价格发生变化，价格上升13.4元",
                    "total_tax":"35.51元",
                    "total_price_exclude_tax":"35.51元",
                    "total_amount":"35.51元",
                    "dining_policy_list":{
                        "daily_info":[
                            {
                                "breakfast_name":"双早",
                                "breakfast_count":2,
                                "tax":35.51,
                                "price":35.51,
                                "day_str":"年月日",
                                "day":"2021-08-21",
                                "out_tax":40.51,
                                "out_price":40.51
                            }
                        ]
                    },
                    "cancel_policy":{
                        "cancel_policy_type":1,
                        "cancel_policy_desc":"1",
                        "cancel_policy_name":"限时取消"
                    },
                    "markup_info":{
                        "markup_price":200,
                        "markup_desc":"使用套餐券一张，另外需到前台支付200元",
                        "daily_markup_price_list":{
                            "daily_markup_price":[
                                {
                                    "daily_price":"200",
                                    "date":"2021-10-08"
                                }
                            ]
                        },
                        "total_markup_price":400
                    },
                    "foreign_currency":{
                        "total_amount":"111.11",
                        "total_price":"100.00",
                        "total_tax":"11.11",
                        "daily_price_list":{
                            "daily_price":[
                                {
                                    "date":"2020-01-22 00:00:00",
                                    "really_price":"100.00",
                                    "out_really_price":"168.00"
                                }
                            ]
                        },
                        "currency":"HKD"
                    },
                    "foreign_currency_payment":false,
                    "payment_type":"1"
                },
                "derby_voucher_info":{
                    "category":"ROOM_DISCOUNT",
                    "discount_off":30,
                    "member_voucher_card_id":"123456789980",
                    "member_voucher_id":"609876543243567",
                    "long_des":"1.绝对不意气用事2.绝对不漏判任何一件坏事3.绝对裁判的公正漂亮",
                    "qr_code_i_d_image":"dhsjnkf32858nkjnfwosolc"
                }
            }
        }
    }
}

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

开放平台

飞猪商家平台

alitrip.merchant.galaxy.order.coupon.validate (携带券的试单接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ