Skip to main content

dc-core /pnr/exchange

Air
Search
REST API
Airline Carrier
Try Now

Beta Release - Use for test purpose only - Work in progress

DRAFT - Subject to change

What is it?

This group of services provides a functionality that enables airlines to process passenger exchange request. Passengers who retrieve bookings can change flights, add/remove seats, ancillaries and baggage or change passenger details.

Any changes that the passenger makes to their journey are reflected in the PNR. After each modification, the passenger's shopping cart is updated to show the old and new selections together with their prices.

How it works

/pnr/exchange service

This service initializes Exchange process. The /pnr/exchange Service returns information for the PNR specified in the parameters. Airlines can prompt passengers for information that identifies a PNR, retrieve the information and format it for display to the passenger. It evaluates MYB rules which are also returned in tripOptions section of the response. It returns also the business loyalty program information as part of the PNR details.

The airline uses the /pnr/exchange service to enable the passenger to retrieve their reservation.

/pnr/exchange/products/air/search service

This service searches for flights that match the criteria specified in the parameter. Airlines can collect search criteria from passengers and then use this service to obtain a list of flights meeting the passenger’s search criteria. The response contains a list of flights meeting the search criteria, with fare offerings and detailed price breakdowns. Airlines can use the search results to populate a selectable list of flights.

/pnr/exchange/products/air/farerules service

This service returns the fare rules for the current itinerary. A separate instance of fare rules will be returned for each segment (each origin and destination pair) in the current itinerary. (The current itinerary consists of any flight selections the passenger has made and is currently held in the session.) The Airline can use this information to format a display of fare rules for the passengers.

/pnr/exchange/products/air service

This service selects itinerary for exchange. It enables an airline to work with the list of air transport products that have been added to an itinerary and held in the session.

It provides ability to select flights by indicating its basketRef (One value should be passed for each selected flight; the value should be the shoppingBasketHashCode from /products/air/search response. If the passenger selects more than one flight, pass a value for each selected flight. The number of select Flights passed must match the number of flights in the itinerary. The service retrieves the current state of the itinerary from the session.

/pnr/exchange/products/seats/preview service

This service is used to display a read-only seat map for one flight, useful for previewing seat availability. Seat map is returned without any passenger details.The flight is selected by passing the hashcode for the selected flight to the service.

The Airline can use the /pnr/exchange/products/seats/preview GET operation to let passengers preview seat availability before selecting a flight. This is typically done after a flight search, when some passengers prefer to check seat availability before selecting their flights.

/pnr/exchange/products service

This service allows the airline to retrieve available products from current exchange and from original booking. It also retrieves available products from current exchange and from original booking The PUT operation initiates EMD recalculation procedure required to do refund. It performs refunds of not re-associable EMDs.

/pnr/exchange/passengers service

This service allows the airline to build and update a list of passengers in exchange flow. The Airline can collect passenger details from the passenger, and then use this service to associate the passenger details with the itinerary while it is stored in the user session.

/pnr/exchange/passengers/contactAddress service

This service allows the airline to retrieve trip contact details for the current itinerary and display it for passenger review/confirmation, and if the passenger updates the trip contact details, to update the booking.

/pnr/exchange/products/ancillaries/search service

The service analyzes the provided AncillarySearchContext. Based on its contents it preselects free discounted ancillaries if preselectFreeDiscountedAncillaries field value is set to true and automatically adds them to the shopping cart, free of charge.

Subsequently the service performs all the actions from GET /pnr/exchange/products/ancillaries service and return the list of ancillary products that are available for any flights that the passenger has selected. Airline can use the information to populate a display of available ancillary products to the passenger.

/pnr/exchange/products/ancillaries service

The airline can use this service to obtain a list of ancillary products that are available for any flights that the passenger has selected. Airline can use the information to populate a display of available ancillary products for the passenger. The airline can also use the POST operation to add any ancillary products selected by the passenger to the itinerary.

/pnr/exchange/products/air/bags service

This service returns a list of bags, carry-on, and embargo information available on the flights the passenger has selected. The information includes the number of free bags provided on the selected flights, the number of carry-ons, and information about the availability of additional paid bags and carry-ons.

/pnr/exchange/products/seats service

This service enables seat selection for passengers during the exchange process. End user can see important features about the seating and cabin configuration for a particular aircraft type as well as which seats are available or unavailable for their flight(s).

Depending on age, Frequent Flyer tier level, alliance, disabilities and/or any other SSR, a traveler and/or their companion(s) may be eligible for seat waivers/discounts.

Payment Options APIs

This group of services allows the airline to retrieve information about available forms of payment and determine which forms of payment are applicable to the products the passenger has selected and added to the itinerary.

/pnr/exchange/purchase service

This service enables the Airline to initiate a purchase transaction when the passenger indicates that the itinerary is complete. Collect form of payment information from the passenger and invoke a POST operation.