文档中心 > API类目 > 国际机票-代理商

alitrip.ie.buyer.order.bookpay (【国际机票】下单预定支付)

【国际机票】 生单预定支付接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
book_pay_order_param BookPayOrderRq 可选 生单支付请求参数
  • └ agent_name
  • String
  • 必须
  • 南方航空旗舰店
  • 代理商飞猪昵称(注意不是淘宝代理商昵称)
  • contacts_param
  • ContactsParam
  • 必须
  • 联系人信息
  • └ email
  • String
  • 必须
  • guohui.gh@alibaba-inc.com
  • 联系人邮箱地址
  • └ name
  • String
  • 必须
  • hantie
  • 联系人姓名
  • └ phone
  • String
  • 必须
  • 15388888888
  • 联系人手机号
  • └ phone_country_code
  • String
  • 必须
  • 086
  • 联系人手机号国家编码
  • item_param
  • ItemParam
  • 必须
  • 航班产品信息
  • └ adult_tax
  • Number
  • 必须
  • 66600
  • 成人税费(单位:分)
  • └ adult_ticket_price
  • Number
  • 必须
  • 88800
  • 成人票价(单位:分)
  • └ child_tax
  • Number
  • 可选
  • 33300
  • 儿童税费(单位:分)
  • └ child_ticket_price
  • Number
  • 可选
  • 55500
  • 儿童票价(单位:分)
  • itinerary_params
  • ItineraryParam []
  • 必须
  • 航班行程信息
  • flight_segment_params
  • FlightSegmentParam []
  • 必须
  • 航段信息
  • └ arr_airport_code
  • String
  • 必须
  • HKG
  • 到达机场三字码
  • └ arr_terminal
  • String
  • 可选
  • T1
  • 到达机场航站楼
  • └ arr_time
  • Date
  • 必须
  • 2016-12-22 10:55:00
  • 到达时间
  • └ cabin_class_code
  • String
  • 必须
  • Y
  • 舱位服务等级
  • └ cabin_code
  • String
  • 必须
  • S
  • 舱位等级
  • └ dep_airport_code
  • String
  • 必须
  • PEK
  • 出发机场三字码
  • └ dep_terminal
  • String
  • 可选
  • T3
  • 出发机场航站楼
  • └ dep_time
  • Date
  • 必须
  • 2016-12-22 06:50:00
  • 出发时间
  • └ elapsed_minute
  • Number
  • 可选
  • 100
  • 飞行时长(分钟)
  • └ equip_type
  • String
  • 可选
  • 332
  • 机型
  • └ marketing_airline
  • String
  • 必须
  • HX
  • 市场方航空公司
  • └ marketing_flight_number
  • String
  • 必须
  • HX305
  • 市场方航班号
  • └ operating_air_line
  • String
  • 可选
  • CA101
  • 承运航空公司
  • └ operating_flight_number
  • String
  • 可选
  • CA
  • 承运航班号
  • └ segment_rph
  • Number
  • 可选
  • 1
  • 航段序号(从1开始)
  • └ main_segment
  • Boolean
  • 必须
  • true
  • 主航段
  • └ itinerary_rph
  • Number
  • 可选
  • 1
  • 航程序号(从1开始)
  • └ trip_type
  • Number
  • 必须
  • 1
  • 行程类型(1:单程;2:往返; 3:多程)
  • └ out_order_id
  • String
  • 必须
  • 99999999
  • 外部采购订单标识(有唯一性要求)
  • passenger_params
  • PassengerParam []
  • 必须
  • 乘机人信息
  • └ birth_date
  • Date
  • 必须
  • 1980-01-29 00:00:00
  • 出生日期
  • └ cert_type
  • Number
  • 必须
  • 0
  • 证件类型(0:护照; 1:港澳通行证;2:台湾通行证;3:台胞证;4:回乡证;6:入台证)
  • └ doc_holder_nationality_name
  • String
  • 必须
  • 中国大陆
  • 证件持有人国籍名称
  • └ doc_id
  • String
  • 必须
  • 123123123
  • 证件号
  • └ effective_date
  • Date
  • 必须
  • 2017-05-03 00:00:00
  • 有效期截止日期
  • └ gender
  • Number
  • 必须
  • 1
  • 乘机人性别(0:男;1:女)
  • └ name
  • String
  • 必须
  • hant/tie
  • 乘机人姓名
  • └ passenger_type
  • Number
  • 必须
  • 0
  • 乘机人类型(0:成人; 1 儿童)
  • └ doc_issue_country_name
  • String
  • 必须
  • 中国大陆
  • 证件发放国际名称

响应参数

名称 类型 示例值 描述
book_pay_order_result BaseApiResult book_pay_order_result 响应
  • └ error_code
  • Number
  • -100
  • 错误编码
  • └ error_msg
  • String
  • 系统错误
  • 错误信息
  • model
  • IeBookPayOrderVo
  • 209110010175
  • 创建支付订单结果
  • └ order_id
  • Number
  • 订单ID
  • orderId
  • └ success
  • Boolean
  • 是否成功
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripIeBuyerOrderBookpayRequest req = new AlitripIeBuyerOrderBookpayRequest();
BookPayOrderRq obj1 = new BookPayOrderRq();
obj1.setAgentName("南方航空旗舰店");
ContactsParam obj2 = new ContactsParam();
obj2.setEmail("guohui.gh@alibaba-inc.com");
obj2.setName("hantie");
obj2.setPhone("15388888888");
obj2.setPhoneCountryCode("086");
obj1.setContactsParam(obj2);
ItemParam obj3 = new ItemParam();
obj3.setAdultTax(66600L);
obj3.setAdultTicketPrice(88800L);
obj3.setChildTax(33300L);
obj3.setChildTicketPrice(55500L);
List<ItineraryParam> list5 = new ArrayList<ItineraryParam>();
ItineraryParam obj6 = new ItineraryParam();
list5.add(obj6);
List<FlightSegmentParam> list9 = new ArrayList<FlightSegmentParam>();
FlightSegmentParam obj10 = new FlightSegmentParam();
list9.add(obj10);
obj10.setArrAirportCode("HKG");
obj10.setArrTerminal("T1");
obj10.setArrTime(StringUtils.parseDateTime("2016-12-22 10:55:00"));
obj10.setCabinClassCode("Y");
obj10.setCabinCode("S");
obj10.setDepAirportCode("PEK");
obj10.setDepTerminal("T3");
obj10.setDepTime(StringUtils.parseDateTime("2016-12-22 06:50:00"));
obj10.setElapsedMinute(100L);
obj10.setEquipType("332");
obj10.setMarketingAirline("HX");
obj10.setMarketingFlightNumber("HX305");
obj10.setOperatingAirLine("CA101");
obj10.setOperatingFlightNumber("CA");
obj10.setSegmentRph(1L);
obj10.setMainSegment(true);
list7.setFlightSegmentParams(list9);
obj6.setItineraryRph(1L);
obj3.setItineraryParams(list5);
obj3.setTripType(1L);
obj1.setItemParam(obj3);
obj1.setOutOrderId("99999999");
List<PassengerParam> list12 = new ArrayList<PassengerParam>();
PassengerParam obj13 = new PassengerParam();
list12.add(obj13);
obj13.setBirthDate(StringUtils.parseDateTime("1980-01-29 00:00:00"));
obj13.setCertType(0L);
obj13.setDocHolderNationalityName("中国大陆");
obj13.setDocId("123123123");
obj13.setEffectiveDate(StringUtils.parseDateTime("2017-05-03 00:00:00"));
obj13.setGender(1L);
obj13.setName("hant/tie");
obj13.setPassengerType(0L);
obj13.setDocIssueCountryName("中国大陆");
obj1.setPassengerParams(list12);
req.setBookPayOrderParam(obj1);
AlitripIeBuyerOrderBookpayResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ie_buyer_order_bookpay_response>
    <book_pay_order_result>
        <error_code>-100</error_code>
        <error_msg>系统错误</error_msg>
        <model>
            <order_id>订单ID</order_id>
        </model>
        <success>是否成功</success>
    </book_pay_order_result>
</alitrip_ie_buyer_order_bookpay_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部