Skip to content

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.

  1. Check a booking
  2. Change a booking
  3. Cancel a booking

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:

  1. Create a trip using the record locator. You receive a trip_id to use in all servicing requests.
  2. 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:

  1. Use the same trip_id of the trip you registered.
  2. Start a check of the trip.
  3. 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.

Tip

Subscribe to the callbacks to receive a notification with the final state of the checking process.

Change a booking

To change an existing booking, follow these steps:

  1. Use the same trip_id of the trip you registered.
  2. Search for products
    • The prices in the search results are the cost of changing, not the base prices.
  3. Proceed with checking and booking changes using the same process as before.

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 own refund_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:

  1. Start a cancellation check for every product in the booking.
  2. 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.
  3. Confirm cancellation. Starts the cancellation with the airline.
  4. Poll the trip information endpoint to see the status of the cancellation.
  5. 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.