NDC Shopping Flow without seat selection (Instant Payment)
This is the basic shopping flow without seat selection. We have provided the inputs and outputs for each API at each stage of the sequence.
AirShopping
Request
-
Shop by Origin & Destination (O&D) for a specific date
-
Shop for one way, return, open jaw and multi city
-
Target specific fare products using Airline Taxonomy codes
-
Shop by airport code or city code
-
Shop for flexible/non-flexible fares
-
Request for multiple cabins per itinerary
-
Multiple pax types (ADT, CHD, INF and GBE)
Response
List of offers containing the following:
-
Total price including base fare and tax for each passenger type
-
Baggage allowance
-
Fare rules (change and refund rules)
-
Fare product info e.g. Economy Light
-
PaymentTimeLimit
AirShopping - Limitations
- Brand attributes are not returned
- Calendar search not supported
- Group bookings not supported
- Published fare only
- Maximum 9 passengers
- Infant with seats not supported
- Unaccompanied minor bookings not supported
AirShopping - Useful Information
- Offers will only be returned in the requested cabin(s)
- Although cabin can be specified for each Origin&Destination (O&D), the API will only consider the cabins specified for the first O&D and apply for the whole itinerary
- Only homogenous offers will be returned e.g. outbound Economy Classic and inbound Economy Classic
- Only flight offers will be returned i.e. without ancillaries
- The API supports the following Airline Taxonomy codes that can be used in shopping request to target specific products
- Checked bag (taxonomy code = 13EC which should used in conjunction with IncludeInd indicator)
- Preferred seat (taxonomy code = 189C which should used in conjunction with IncludeInd indicator)
- The taxonomy codes can only be requested at the itinerary level and when requested, it will be applied for all the requested cabins
- An error will be returned if there is no fare products available which meets the shopping criteria e.g. if the request is for a “No checked bag” fare in Premium Economy cabin then an error will be returned
OfferPrice
Request
-
OfferID and OfferItemIDs of the selected offer from AirShoppingRS
-
Same number of passengers and pax types (ADT, CHD, INF and GBE) returned from AirShoppingRS
Response
For the requested offer:
-
Total price including base fare, tax and tax breakdown for each passenger type
-
Baggage allowance
-
Fare rules (change and refund rules)
-
Fare product info e.g. Economy Light
-
Brand attributes for each fare product
-
PaymentTimeLimit
Upsell offers – all details returned for the requested offer will also be returned for upsell offer
OfferPrice - Useful Information
- Along with the requested offer (Priced offer section), the API also returns upsell offers (Other Offers section)
- Upsell offers will return the next higher fare products in the same cabin and all available products in the higher cabins e.g. if the requested offer is Economy Classic then upsell offers will return Economy Delight, Premium Economy and Upper Class
OrderCreate
Request
-
OfferID and OfferItemIDs of the selected offer from OfferPriceRS
-
Passenger details
-
Passenger’s FQTV details
-
Payment card details with 3DS2 authenticated details for online travel agents
-
Payment card details without 3DS2 authentication for offline travel agents
Response
-
OrderID
-
Booking reference
-
Flight segment details
-
Total Order Price
-
Price for each passenger including fare and tax breakdown
-
Ticket details
-
Ticketed baggage allowance
OrderCreate - Limitations
- Fare rules are not returned in OrderViewRS
- Hold booking (booking without tickets) not supported
- Only one payment card can be used per transaction
- Cabin and PriceClass details are not returned in OrderViewRS
- Only card payment is supported
- Only free/paid seat ancillary is supported
- No Price Guarantee
OrderCreate - Useful Information
- Travel agents can specify whether they are Offline or Online
- All Online travel agents are expected to complete 3DS2 Authentication upfront and call OrderCreate
NDC Shopping Flow with seat selection (Instant Payment)
This is the basic shopping flow with seat selection. We have provided the inputs and outputs for each API at each stage of the sequence.
AirShopping
Request
-
Shop by Origin & Destination (O&D) for a specific date
-
Shop for one way, return, open jaw and multi city
-
Target specific fare products using Airline Taxonomy codes
-
Shop by airport code or city code
-
Shop for flexible/non-flexible fares
-
Request for multiple cabins per itinerary
-
Multiple pax types (ADT, CHD, INF and GBE)
Response
List of offers containing the following:
-
Total price including base fare and tax for each passenger type
-
Baggage allowance
-
Fare rules (change and refund rules)
-
Fare product info e.g. Economy Light
-
PaymentTimeLimit
OfferPrice
Request
- OfferID and OfferItemIDs of the selected offer from AirShoppingRS
- Same number of passengers and pax types (ADT, CHD, INF and GBE) returned from AirShoppingRS
Response
For the requested offer:
-
Total price including base fare, tax and tax breakdown for each passenger type
-
Baggage allowance
-
Fare rules (change and refund rules)
-
Fare product info e.g. Economy Light
-
Brand attributes for each fare product
-
PaymentTimeLimit
Upsell offers – all details returned for the requested offer will also be returned for upsell offer
SeatAvailability
Request
- OfferID of the selected offer from AirShoppingRS or OfferPriceRS
Response
-
Seat map is returned for the requested cabin class (e.g. Economy)
-
Pricing for different seat categories (OfferItems)
-
Seat Column and Row details
-
Available and Occupied seats
-
For each seat, the seat characteristic e.g. Bulkhead seat
-
Seating policy
Note: SeatAvailability can be called after either AirShopping or OfferPrice
SeatAvailability - Limitations
- Cabin component information (e.g. Galley, Lavatory) not returned
- SeatAvailability for a specific flight within the Offer can’t be requested
- Only supports VS marketed and operated flights
OrderCreate
Request
-
OfferID and OfferItemIDs of the selected offer from OfferPriceRS
-
Passenger details
-
Passenger’s FQTV details
-
Payment card details with 3DS2 authenticated details for online travel agents
-
Payment card details without 3DS2 authentication for offline travel agents
Response
-
OrderID
-
Booking reference
-
Passenger details
-
Flight segment details
-
Total Order Price
-
Price for each passenger including fare and tax breakdown
-
Ticket details
-
EMD details (for paid seats)
-
Ticketed baggage allowance
General Limitations
- Only card payment is supported
- Only free/paid seat ancillary is supported
- No Price Guarantee
Only the following passenger types are supported:
Passenger Type
Passenger Type Code
Age
Adult
ADT
Must be 16 years and above
Child
CHD
Must be between 2 and 12 years
Young Adult
GBE
Must be between 12 and 16 years
Infant
ADT
Must be less than 2 years
Both AirShopping and OfferPrice APIs return below fare rules per passenger type for each offer:
Fare Rule type
Fare Condition
Eligibility
Penalty Amount
Change
Before departure
Allowed or not allowed
Penalty amount, if applicable
Change
After departure
Allowed or not allowed
Penalty amount, if applicable
Cancel
Before departure
Allowed or not allowed
Penalty amount, if applicable
Cancel
After departure
Allowed or not allowed
Penalty amount, if applicable