Flow Overview
The Distribusion API facilitates a fully native search, booking and after-sales flow, consisting of these steps:
- Preparing Metadata: Sets the metadata from stations/areas/cities and carries in advance to support the steps in the flow.
- Searching for Trips: Retrieves the list of available trips for a specific departure/arrival date and time, for selected stations/areas/cities, for a defined number of passengers and other search criteria you define.
- Checking Price & Vacancy: Confirms if the trip selected has vacancy and if the price is still the same as in the previous step.
- Creating Reservation: Creates a reservation while the user completes the checkout process.
- Confirming Reservation: Sends a request to confirm the reservation with the carrier.
- Checking Reservation Status: Checks the status of the reservation until is is confirmed by the carrier.
- Booking Confirmation: Displays the booking details after the reservation is confirmed.
- Cancel Booking: Requests the cancellation conditions and process a cancellation.
Optionally, you can call Quick Search before step 2 to check whether content exists on a route and show an indicative "from" price. It sits in front of the flow above and does not replace any of these steps.
Steps 2 to 4 run on offer ids: the search returns an
offer_idfor each fare, and vacancy and reservation creation take that id instead of repeating the trip parameters. See The Offers Flow. Integrations built before offers were introduced continue to work
unchanged.
Was this section helpful?
On this page
- Flow Overview