Skip Navigation

dc-core /pnr/mto

Air
Search
REST API
Airline Carrier

What is it?

This group of services provides functionality that enables airlines to present existing bookings for modifications by passengers. Passengers who retrieve bookings can 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/mto/ancillaries service

This is the first call in Modify Trip Options flow which initializes Modify Trip Options:Ancillaries flow and it returns PNR data for provided input parameters that identify the PNR. It also evaluates MYB rules which are also returned in tripOptions section of the response.

After this service has been called, the application can prompt the passenger to add ancillaries via /pnr/mto/products/ancillaries, seats via /pnr/mto /products/seats, or both, in any order.

/pnr/mto/seats service

This is the first call in Modify Trip Options flow which initializes Modify Trip Options: Seats flow and it returns PNR data for provided input parameters that identify the PNR. It also evaluates MYB rules which are also returned in tripOptions section of the response.

After this service has been called, the application can prompt the passenger to add or modify seat selection via /pnr/mto/products/seats. The Modify Trip Options flow can also be initialized by calling /pnr/mto/ancillaries, but in that case it will be the Modify Trip Options: Ancillaries flow, and passengers will have the option to add or modify their ancillary selection in addition to their seat selection.

/pnr/mto/products/air/farerules service

This service returns the fare rules for the current itinerary. A separate instance of fare rules is 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/mto/products/ancillaries/search service

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

After this the service will perform all the actions from GET /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/mto/products/ancillaries service

This service must be called after a PNR has been retrieved by the /pnr/mto/ancillaries service, which initializes the Modify Trip Options: Ancillaries flow.

This service allows passenger to see both currently selected and currently available ancillaries for the PNR they specified (/pnr/mto/ancillaries service).

  • The main purpose of Modify Trip Options new flow is to have a possibility to increase the quantity of my already reserved ancillary with a single transaction, instead of two transaction - refund and new purchase.
  • The Modify Trip Options new flow enhances the current ancillary contract for the MTO-Ancillary to be able to add ancillaries and/or Increase quantity and block quantity decrease for multiple AEs with same subcode.

/pnr/mto/products/air/bags service

This service returns a list of bags, carry-ons, 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/mto/products/seats service

This service returns information about seats that are currently available for the booking. This information can be displayed to passengers.

This service must be called after a PNR has been retrieved by the /pnr/mto/ancillaries service, which will initialize the MTO:Ancillaries flow, or the /pnr/mto/seats service, which initializes the MTO:Seats flow.

/pnr/mto/products service

This service provides breakdown of products (air, ancillaries, seats) selected by user. It also recalculates products prices based on given context (e.g. based on awardSwitchState prices can be recalculated between points and cash; or, based on reprice, recalculate price of basket).

Payment Options APIs

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

/pnr/mto/purchase service

This service enables the user to purchase modifications done to his existing booking. It executes payments or refunds as needed and updates the systems with the modifications.

After the passenger retrieves a booking and, optionally, updates ancillaries and/or seats, and selects a form or forms of payment, /pnr/mto/purchase will authorize payments as needed and update the booking records with the new values.

/pnr/mto/passengers/contactAddress service

The /pnr/mto/passengers/contactAddress service returns the passenger contact information that is currently available for the itinerary. This service must be called after a PNR has been retrieved by the /pnr/mto/ancillaries service, which will initialize the MTO:Ancillaries flow, or the /pnr/mto/seats service, which will initialize the MTO:Seats flow.

/pnr/mto/products/external service

This service allows airlines to add external products to the shopping cart and to remove external products from the shopping cart.