Flight Servicing
This tutorial assumes that you already have your API key and have selected the authentication and authorization methods to use the Gordian API. For more information, see the getting started guide.
You can provide service to a flight booking that was not booked through Gordian. To provide service to a booking, you must register it with Gordian. After registration, you can do the following actions as needed.
Tip
The following processes are the same as in Flight booking. When you are able to provide servicing, you can start selling flight tickets with minor modifications. Contact your account manager for more information.
Register a booking
To register a booking, follow these steps:
- Create a trip using the record locator. You receive a
trip_id
to use in all servicing requests. - Wait 24 hours before making any servicing requests.
Check a booking
Airlines may change bookings without necessarily informing the customer. You can start a check of all the items in a booking with the following steps:
- Use the same
trip_id
of the trip you registered. - Start a check of the trip.
- Poll the trip information endpoint until the state is no longer
check_in_progress
.- Each of the products in the
orders
object has its own status.
- Each of the products in the
Tip
Subscribe to the callbacks to receive a notification with the final state of the checking process.
Change a booking
Voluntary changes
To voluntarily change an existing booking, follow these steps:
- Use the same
trip_id
of the trip which already has tickets booked. - Check the eligibility of the ticket booking in the trip to determine if change is allowed.
- Search for ticket change using
booking_id
from eligibility check- Define the new journeys in the search
- The prices in the search results are the cost of changing, not the base prices.
- Proceed with checking and booking changes using the same flow as the initial search.
Support By Airline
Carrier | Date Change | Route Change |
---|---|---|
LHG |
||
IB |
Tip
Contact your account manager for more information about support for voluntary changes to a booked flight
Involuntary changes
If you subscribed to notifications, you receive a callback in the event of the following involuntary changes:
involuntary_change
: there is no action to be taken by the customer. For example, the schedule changed by a small amount.involuntary_cancellation
: The product has been cancelled and refunded. Each product has its ownrefund_amount
property.customer_action_needed
: the customer must choose an option:- Get a refund. They can proceed through the cancellation process.
- Select an alternative. The customer must select an alternative from a list. Add the selection to the basket and fulfill. If the booking has ancillaries and there was a change, you receive an
involuntary_change
callback.
Cancel a booking
When the customer wants to cancel a booking, follow these steps:
- Start a cancellation check for every product in the booking.
- Poll cancellation details endpoint to get the results of the check. It includes the refund amount for the products and each product that would be cancelled with it, for example, seat or bag selection.
- Confirm cancellation. Starts the cancellation with the airline.
- Poll the trip information endpoint to see the status of the cancellation.
- Each of the products in the
orders
object has its own status.
Tip
Subscribe to the Cancellation Completed callback to receive a notification with the final state of the process.