Example flight booking journey

Search

Flight Search Request

A search request made for a return flight from London Gatwick (Departure Airport ID 1 in this set up) to Palma (Arrival Airport ID 27 in this set up) for 2 adults for 7 nights, arriving 13 November 2014.

<FlightSearchRequest>
<LoginDetails>
<Login>TestLogin</Login>
<Password>TestPassword</Password>
</LoginDetails>
<DepartureAirportID>1</DepartureAirportID>
<ArrivalAirportID>27</ArrivalAirportID>
<DepartureDate>2014-11-13</DepartureDate>
<Duration>7</Duration>
<OneWay>false</OneWay>
<GuestConfiguration>
<Adults>2</Adults>
</GuestConfiguration>
</FlightSearchRequest>

Flight Search Response

The response returns a list of matching available flights.

<FlightSearchResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
</ReturnStatus>
<Flights>
<Flight>
<BookingToken>TokenString</BookingToken>
<FlightCarrierID>820</FlightCarrierID>
<Source>EasyJetAPI</Source>
<FlightSupplierID>83</FlightSupplierID>
<TPSessionID>1</TPSessionID>
<DepartureAirportID>1</DepartureAirportID>
<ArrivalAirportID>27</ArrivalAirportID>
<AltReturnAirportID>0</AltReturnAirportID>
<OutboundDepartureDate>2014-11-13T00:00:00</OutboundDepartureDate>
<OutboundDepartureTime>11:50</OutboundDepartureTime>
<OutboundArrivalDate>2014-11-13T00:00:00</OutboundArrivalDate>
<OutboundArrivalTime>15:05</OutboundArrivalTime>
<OutboundFlightClassID>1</OutboundFlightClassID>
<OutboundFlightCode>EZY8627</OutboundFlightCode>
<OutboundOperatingFlightCarrierID>0</OutboundOperatingFlightCarrierID>
<OutboundFareCode />
<ReturnDepartureDate>2014-11-20T00:00:00</ReturnDepartureDate>
<ReturnDepartureTime>15:40</ReturnDepartureTime>
<ReturnArrivalDate>2014-11-20T00:00:00</ReturnArrivalDate>
<ReturnArrivalTime>17:15</ReturnArrivalTime>
<ReturnFlightClassID>1</ReturnFlightClassID>
<ReturnFlightCode>EZY8628</ReturnFlightCode>
<ReturnOperatingFlightCarrierID>0</ReturnOperatingFlightCarrierID>
<ReturnFareCode />
<NumberOfOutboundStops>0</NumberOfOutboundStops>
<NumberOfReturnStops>0</NumberOfReturnStops>
<TotalSeatCost>177.16</TotalSeatCost>
<TotalSeatPrice>218.00</TotalSeatPrice>
<TotalBaggagePrice>0.00</TotalBaggagePrice>
<Saving>0.00</Saving>
<TotalPrice>218.00</TotalPrice>
<ExactMatch>true</ExactMatch>
<HotelArrivalDate>2014-11-13T00:00:00</HotelArrivalDate>
<HotelDuration>7</HotelDuration>
<IncludesSupplierBaggage>false</IncludesSupplierBaggage>
<SupplierDetails>
<SupplierID>2875</SupplierID>
<SupplierReference>SupplierReferenceString</SupplierReference>
<PropertyID>0</PropertyID>
<CurrencyID>5</CurrencyID>
<Cost>177.16</Cost>
<SystemCost>177.16</SystemCost>
<GrossCost>0</GrossCost>
<TotalMargin>0</TotalMargin>
<CommissionPercentage>0</CommissionPercentage>
</SupplierDetails>
<FlightErrata />
</Flight>
</Flights>
</FlightSearchResponse>

Prebook

A Flight Prebook Request is sent for the first flight to get detailed pricing information

<FlightPreBookRequest>  
<LoginDetails>
<Login>TestLogin</Login>
<Password>TestPassword</Password>
</LoginDetails>
<BookingToken>TokenString(from FlightSearchResponse)</BookingToken>
</FlightPreBookRequest>

The Flight Prebook Response returns this information for the specific flight

<FlightPreBookResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
</ReturnStatus>
<BookingToken>TokenString</BookingToken>
<TotalPrice>243.00</TotalPrice>
<TotalCommission>0.00</TotalCommission>
<VATOnCommission>0.000</VATOnCommission>
<TotalInfantCost>0</TotalInfantCost>
<AdditionalSupplierCosts>0</AdditionalSupplierCosts>
<SeatMapCost>0</SeatMapCost>
<ShowDateOfBirth>true</ShowDateOfBirth>
<MultiCarrierOutbound>false</MultiCarrierOutbound>
<MultiCarrierReturn>false</MultiCarrierReturn>
<Extras>
<Extra>
<ExtraBookingToken>pfttkimHgy8=</ExtraBookingToken>
<ExtraType />
<Description>Baggage</Description>
<DefaultBaggage>true</DefaultBaggage>
<CostingBasis>Per Passenger</CostingBasis>
<Price>10.00</Price>
<QuantityAvailable>8</QuantityAvailable>
<QuantitySelected>0</QuantitySelected>
<GuestID>0</GuestID>
<Mandatory>false</Mandatory>
</Extra>
</Extras>
<CreditCardSurcharges>
<CreditCardSurcharge>
<CreditCardTypeID>2</CreditCardTypeID>
<Amount>5.0</Amount>
</CreditCardSurcharge>
</CreditCardSurcharges>
<Cancellations>
<Cancellation>
<StartDate>2014-10-14T00:00:00</StartDate>
<EndDate>2014-10-15T00:00:00</EndDate>
<Amount>0.000</Amount>
</Cancellation>
</Cancellations>
<PaymentsDue>
<PaymentDue>
<Amount>243.00</Amount>
<DateDue>2014-10-14T00:00:00</DateDue>
</PaymentDue>
</PaymentsDue>
<SeatMaps />
<TerminalInformations />
<FlightErrata />
</FlightPreBookResponse>

A Flight Prebook Request is sent for the 2nd flight to get the same information

<FlightPreBookRequest>  
<LoginDetails>
<Login>TestLogin</Login>
<Password>TestPassword</Password>
</LoginDetails>
<BookingToken>TokenString(from First Flight Prebook Response)</BookingToken>
<Extras>
<Extra>
<ExtraBookingToken>ExtraBookingToken(from First Flight Prebook Response)</ExtraBookingToken>
<Quantity>1</Quantity>
</Extra>
</Extras>
</FlightPreBookRequest>

The Flight Prebook Response for the 2nd flight returns the same information

<FlightPreBookResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
</ReturnStatus>
<BookingToken>TokenString</BookingToken>
<TotalPrice>243.00</TotalPrice>
<TotalCommission>0.00</TotalCommission>
<VATOnCommission>0.000</VATOnCommission>
<TotalInfantCost>0</TotalInfantCost>
<AdditionalSupplierCosts>33.00</AdditionalSupplierCosts>
<SeatMapCost>0</SeatMapCost>
<ShowDateOfBirth>true</ShowDateOfBirth>
<MultiCarrierOutbound>false</MultiCarrierOutbound>
<MultiCarrierReturn>false</MultiCarrierReturn>
<Extras>
<Extra>
<ExtraBookingToken>ExtraTokenString</ExtraBookingToken>
<ExtraType />
<Description>Baggage</Description>
<DefaultBaggage>true</DefaultBaggage>
<CostingBasis>Per Passenger</CostingBasis>
<Price>10.00</Price>
<QuantityAvailable>8</QuantityAvailable>
<QuantitySelected>1</QuantitySelected>
<GuestID>0</GuestID>
<Mandatory>false</Mandatory>
</Extra>
</Extras>
<CreditCardSurcharges>
<CreditCardSurcharge>
<CreditCardTypeID>2</CreditCardTypeID>
<Amount>5.0</Amount>
</CreditCardSurcharge>
</CreditCardSurcharges>
<Cancellations>
<Cancellation>
<StartDate>2014-10-15T00:00:00</StartDate>
<EndDate>2014-10-15T00:00:00</EndDate>
<Amount>0.000</Amount>
</Cancellation>
</Cancellations>
<PaymentsDue>
<PaymentDue>
<Amount>243.00</Amount>
<DateDue>2014-10-15T00:00:00</DateDue>
</PaymentDue>
</PaymentsDue>
<SeatMaps />
<TerminalInformations />
<FlightErrata />
</FlightPreBookResponse>

Book

A Basket Book Request is sent to make the booking for the second flight and provide card details for payment

<BasketBookRequest>
<LoginDetails>
<Login>TestLogin</Login>
<Password>TestPassword</Password>
</LoginDetails>
<LeadCustomer>
<CustomerTitle>Mr</CustomerTitle>
<CustomerFirstName>John</CustomerFirstName>
<CustomerLastName>Test</CustomerLastName>
<CustomerAddress1>House</CustomerAddress1>
<CustomerAddress2>Road</CustomerAddress2>
<CustomerTownCity>Croydon</CustomerTownCity>
<CustomerCounty>Surrey</CustomerCounty>
<CustomerPostcode>p05tcode</CustomerPostcode>
<CustomerBookingCountryID>1</CustomerBookingCountryID>
<CustomerPhone>1234567890</CustomerPhone>
<CustomerFax>1234567890</CustomerFax>
<CustomerEmail>testteam@intuitivesystems.co.uk</CustomerEmail>
</LeadCustomer>
<GuestDetails>
<GuestDetail>
<GuestID>1</GuestID>
<Type>Adult</Type>
<Title>Mr</Title>
<FirstName>John</FirstName>
<LastName>Smith</LastName>
<Age>25</Age>
<DateOfBirth>1986-10-10</DateOfBirth>
</GuestDetail>
<GuestDetail>
<GuestID>2</GuestID>
<Type>Adult</Type>
<Title>Mrs</Title>
<FirstName>Joan</FirstName>
<LastName>Smith</LastName>
<Age>25</Age>
<DateOfBirth>1986-10-10</DateOfBirth>
</GuestDetail>
</GuestDetails>
<Payment>
<PaymentType>CreditCard</PaymentType>
<CCCardHoldersName>test</CCCardHoldersName>
<CCCardTypeID>1</CCCardTypeID>
<CCCardNumber>XXXXXXXXXXXXXXXX</CCCardNumber>
<CCExpireMonth>12</CCExpireMonth>
<CCExpireYear>14</CCExpireYear>
<CCSecurityCode>XXX</CCSecurityCode>
<CCIssueNumber>0</CCIssueNumber>
<Amount>238.00</Amount>
<Surcharge>5.00</Surcharge>
<TotalAmount>243.00</TotalAmount>
</Payment>
<FlightBookings>
<FlightBookRequest>
<BookingToken>TokenString(From 2nd Flight Prebook Response)</BookingToken>
<ExpectedTotal>243.00</ExpectedTotal>
<GuestIDs>
<GuestID>1</GuestID>
<GuestID>2</GuestID>
</GuestIDs>
</FlightBookRequest>
</FlightBookings>
</BasketBookRequest>

The Basket Book Response returns a booking reference, confirmation of the flight booking and information about cancellation charges & payments due.

<BasketBookResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
</ReturnStatus>
<BookingReference>6433158</BookingReference>
<TotalPrice>243.00</TotalPrice>
<TotalCommission>0.0</TotalCommission>
<VATOnCommission>0.0</VATOnCommission>
<PropertyBookings />
<FlightBookings>
<FlightBookResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
</ReturnStatus>
<BookingReference />
<TotalPrice>0</TotalPrice>
<TotalCommission>0.0</TotalCommission>
<VATOnCommission>0</VATOnCommission>
<Cancellations>
<Cancellation>
<StartDate>2014-10-15T00:00:00</StartDate>
<EndDate>2014-10-15T00:00:00</EndDate>
<Amount>0.00</Amount>
</Cancellation>
</Cancellations>
</FlightBookResponse>
</FlightBookings>
<TransferBookings />
<ExtraBookings />
<CarHireBookings />
<PaymentsDue>
<PaymentDue>
<Amount>243.00</Amount>
<DateDue>2014-10-15T00:00:00</DateDue>
</PaymentDue>
</PaymentsDue>
<QuoteID>0</QuoteID>
</BasketBookResponse>