API Basics
The Gordian API follows one flow, regardless of product and integration type. This means one integration unlocks all the Gordian products.
Common Terminology
| Term | Definition |
|---|---|
| Trip | Represents the entire itinerary, passenger set, and product set that a customer has. |
| Basket | A set of products that have been selected but not yet purchased by the customer. Gordian keeps its own state of the basket to know what the customer picked. |
| Journey | A single length of a ticket's travel, made up of one or more segments. A one-way trip has a journey, and round trip has two journeys. |
| Segment | A portion of a journey, from a boarding point to a deplaning point of the given flight. |
| In-funnel | Position of ancillary offer during the customer journey, before the payment has been made and the flight has been ticketed |
| Post-booking | Position of ancillary offer after the flight booking has been made. For example, payment confirmation page, Manage My Booking, etc. |
| Airline PNR | Passenger Name Record (PNR) of the Airline, not the GDS or aggregator |
API Flow
1. Create a trip
The first step of a customer journey is to create a trip. The trip is the main entity that helps you keep track of all the information needed to modify the reservation in any way.
When creating a trip, you receive a trip_id which is the trip identifier to use for the rest of the customer journey.
2. Build a trip
Once you’ve created a trip and received the trip_id, you can enable the customer to build the trip according to their needs. To build a trip, the customers follow these steps:
- Search for flights or ancillaries
- Add products to the basket
- Verify the basket items
Customers can go back and redo the steps freely to build the trip as they need.
3. Fulfill a trip
When the customer approves the items in the basket, you can start the fulfillment process.Fulfilling a trip is a 2-step process:
- Initiate the fulfillment process.
- Check fulfillment status.
4. Service a trip (post-sale)
Gordian supports post sale changes and cancellations to products booked through Gordian.