NDC Modify, Cancel, and Exchange Guide
This guide summarizes the options and workflows for modifying, exchanging, or canceling and refunding NDC bookings and tickets.
In this guide:
- Basic Concepts
- Cancel or Modify a Reservation
- Void, Cancel and Refund, or Exchange a Ticket
- Reprice a Held Booking
- Workflow Diagrams
- Involuntary Schedule Changes
Basic Concepts
You can modify the air itinerary on or cancel any held booking, which by definition has not been ticketed. See the following section for workflows.
For a ticket, you can void, cancel, or exchange the itinerary, which may result in a refund, as follows:
-
Void: Cancel the ticket for a full refund within an allowed void period, based on the airline's rules for the market in which the ticket was issued. Generally a ticket can be voided within the same day it was issued, usually up to midnight local agency time. In some instances it may be voided up to midnight of the day after ticketing, or special holiday policies may apply.
-
Cancel: Cancel the ticket after the void period without rebooking another itinerary. Depending on the fare rules, canceling a ticket may result in a full, partial, or no refund.
-
Exchange: Cancel or modify the original air itinerary on a ticket and issue a new ticket for a different or updated itinerary.
These terms apply to how a ticket can be refunded or exchanged:
-
Automated refund: A refund processed entirely within the JSON APIs, from requesting a quote for the refund and any penalties through processing the cancellation.
-
Manual refund: Information about the refund amount and any penalties are obtained from a source other than the JSON APIs, entered into the JSON APIs, and the JSON APIs process the cancellation.
The JSON APIs do not support manual refunds. - Voluntary refund or exchange: The passenger or agency initiates the refund or exchange.
Involuntary refund: The airline cancels the ticket, such as if a flight is canceled and the passenger cannot be rebooked. Note: At this time the JSON APIs do not support processing involuntary refunds.
Cancel or Modify a Reservation
The following table summarizes the available options for an existing reservation (ticket has not yet been issued).
Action |
Workflow & links to API references
|
Notes |
---|---|---|
Cancel reservation |
Cancel NDC reservation that has not been ticketed. |
|
Modify air itinerary on reservation |
|
The NDC Reshop, Reprice, and Resell APIs update the air itinerary for a held booking: Search for the new or modified itinerary (Reshop), price the new offer and add it to the workbench (Reprice), and commit the workbench to update the itinerary on the reservation (Resell). If you want to issue the ticket at commit, add payment details to the workbench:
With FOP and payment in the workbench, Resell issues tickets for the exchanged itinerary. Without FOP and payment, Resell creates a held booking for later fulfillment. See Supported Changes and Modifiers in the table below.
|
Void, Cancel and Refund, or Exchange a Ticket
The following table summarizes available options for modifying or canceling a ticketed itinerary.
Action |
Workflow & links to API references |
Notes |
---|---|---|
Void ticket for full refund (within void period) |
Voids the ticket if within the void period. In the Order Cancel request, you must set the RetainFlag header parameter to false. The ticket is voided if within the allowed void period for the airline (generally within the same day it was issued, usually up to midnight local agency time; see Basic Concepts above). |
|
Void ticket and payment but retain itinerary (Qantas only; only within void period) |
For NDC on Qantas only, within the void period, you can cancel the payment on a ticket. This refunds the payment, cancels the ticket but retains the itinerary, and creates a held booking for later fulfillment. For example, you might want to use this workflow to use a different payment method than was sent in ticketing. |
|
Cancel ticket and issue refund (after void period) |
This workflow cancels the ticket and issues refund if eligible. In the Order Cancel request, you must set the RetainFlag header parameter to false. If the ticket is eligible for a refund, a refund will be issued to the original form of payment. For Singapore Airlines (SQ) only, you can cancel specified segments instead of the full itinerary by sending a product identifier in the Refund Quote request. Refund Quote is a mandatory step when canceling a ticket outside the void period and there is any difference between the value of any potential refund and the purchase price. If Refund Quote is not sent, and there is not an available refund in the exact amount of the purchase price, Order Cancel returns the error message OFFER CANNOT BE CANCELED WHEN REFUND AMOUNT DOES NOT EQUAL OFFER PRICE. PERFORM A REFUND QUOTE AND TRY AGAIN.
|
|
Cancel or void ticket but retain ticket value |
For Qantas (QF) only, either within or after the void period, you can cancel the ticket but retain the ticket value by setting the RetainFlag parameter in Order Cancel to true. |
|
Exchange ticket for a different itinerary or make other itinerary changes |
Supported for fully unflown itineraries. Supported for partially flown itineraries on BA, AF/KLM, AA, and LHG.
The NDC Reshop, Reprice, and Resell APIs exchange an NDC ticket for a new or modified itinerary: Search for the new or modified itinerary (Reshop), price the new offer and add it to the workbench (Reprice), and commit the workbench and issue the exchange (Resell). If a price difference applies to the new itinerary:
|
Reprice a Held Booking
The Standalone Reprice API reprices an itinerary on a held booking for NDC. Standalone Reprice can be sent before or after the price guarantee expires.
It would typically be used to check if the price has changed before issuing a ticket. You can either ticket the itinerary or hold the booking again.
Standalone Reprice must be sent in a workbench session. It must be followed by a Resell request to commit the workbench and either ticket or hold the itinerary. For ticketing, you must send the Add Form of Payment and Add Payment requests before committing the workbench.
Standalone Reprice is supported for modified and unmodified bookings, and for bookings with paid ancillaries such as baggage or seats.
Workflow Diagrams
In the following diagrams, each box represents one API call in the workflow. Itinerary changes on a booking or a ticket exchange are shown first, then the ticket cancel and refund workflow. See the workflow summaries above for additional options in these processes.
Involuntary Schedule Changes
An involuntary schedule change occurs when an airline has modified a flight schedule. You can accept an involuntary schedule change by sending a workbench commit request payload with the scheduleChangeAcceptedInd indicator set to true. You do not need to create a workbench session first.
See Accept Schedule Change in the Workbench Commit API Reference for details.