Booking Service
Overview
After you have selected an offer, you need to use SearchCriteriaToken and OfferToken to create an order in order to make a successful booking.
When creating an order, you also need to provide some additional information on the passenger (e.g. their full name and date of birth).
In addition, you need to confirm the availability of an offer before actually creating and then submitting the order, because changes may happen to an offer at any time. Order confirmation can help improve the booking experience and the success rate of booking
If booking is successful, you will get a response with OrderID included.
1.Create Offer Confirmation
You need to create a confirmation request to confirm the availability of an offer before you create an order based on this offer.
If the confirmation result is SUCCESS, you can go on to create an order in step 2.
This API is CreateOfferConfirmation.
2. Create Order
Please provide us with the passenger’s information necessary to create an order based on the selected offer.
Now the order is not submitted, you need to submit it in step 3.
This API is CreateOrder.
|
You can book ancillary products here if you want to book flights and ancillary products at the same time, but you can also book them after you have booked flights. How to book ancillary products will be elaborated on in Book ancillary products. |
The next step to take is shown in 3. Submit an order and the distributor order ID.
3. Submit an order and the distributor order ID
By creating an order with us, you may generate an order ID on your side, also known as the distributor order ID, as we call it.
You should submit the order together with your own order ID to us now.
We will then generate the corresponding internal OrderID to match your order and your order ID. If booking is
successful, you will then get a response with the OrderID generated by us included.
This API is SubmitOrder.
|
If you did not submit your own order ID to us here, you can still separately submit it to us by calling the SubmitDistributorOrderID API included in the order service, which is shown in Submit distributor order ID. |
Now you are only one step away from a successful booking with us, Please refer to Payment Service.
4.Query Order Confirmation Result (Optional)
You can use this API to improve the booking experience and the success rate of booking, thus you are recommended to keep polling this API to get the order confirmation and seat reservation results before you submit the order in step 3.
If you get a result except SUCCESS, you can make timely adjustments before actually submitting the order, e.g. asking passengers to choose another offer, in order to facilitate a successful booking.
If you skip this API, a successful booking can not be guaranteed and your ability to make timely adjustments will be surely compromised.
In addition, if you skip this API, chances are that the order submission API will take longer time to respond due to limitations on the side of the carrier’s APIs.
Therefore, skipping this API is not recommended.
This API is QueryOrderConfirmationResult.
Booking service schema
To see all of the options you can provide and everything that we’ll return back, please refer to Booking Service.