EN
Sign In
Developers > Flight > Guides > Booking

Overview

Assuming that you have shown the offers you have retrieved to John in your user interface, John now can select flights for his family.

What should we do?

Since every offer is real-time and they will expire after a certain time period, you need to help John to select and book as soon as possible.

  1. Help John select a suitable offer

  2. Create a booking based on the selected offer

  3. Submit the order to us

1. Select and retrieve an offer

Offers expire very quickly, after which, you can not book them.

If John is interested in one of the returned offers and wants more details of the offer, you should retrieve the offer by the SearchCriteriaToken and OfferToken to get the latest version. If there are any changes to the offer, you need to give him a prompt.

After John has decided on this offer and submitted complete passenger info, you need to use the CreateOfferConfirmationAPI to confirm the availability of this offer just before John makes a payment. If there are any changes to the offer, you also need to give him a prompt.

In this way, you can improve the experience and success rate of booking.

Other necessary yet proper prompts may also be offered, including but not limited to:

  • Travel notices from airlines and the local governments of the places where the passenger will go.

  • The applicable rebooking and refund rules for the selected offer

  • The applicable baggage allowance rules

  • Any document which may be used to identify a passenger or verify aspects of a passenger’s personal identity

  • The applicable rules for the purchasing and using of the ancillary products that the passenger wants to buy

2. Create an order based on the selected offer

After John has selected the offer that he wants, we now can book for John and his family. In our API, this is called creating an order.

You need the following things now:

  • The SearchCriteriaToken and OfferToken of the selected offer

  • The ancillary product that John wants to buy

  • Information on the passengers and their identity documents

  • Information on the passengers' loyalty accounts

You need to collect every passenger’s name, date of birth, gender, e-mail (optional), and phone number (optional).

During the booking process, you may generate an order ID on your side. You can pass it to us in the node of DistributorOrderID in our API.

After creating an order with us, you will get an order in the status of "unsubmitted" as well as a response with the OrderID generated by us included.

  • Some important notices must be shown to ensure that passengers understand how their data will be used and the rules that apply to their booking.

  • When you should charge your passengers depends on the payment arrangement between you and your passengers.

  • When and how you should pay us for an order is detailed in the Payment section.

  • If the order is not submitted within the agreed time limit, the order will be automatically cancelled.

3. Submit the order to us

You now need to check the details of the order corresponding to the OrderID included in the response, if the details are correct, you should confirm the order with us by submitting it to us.

After submitting the order to us, the order info can not be modified and the status of the order will be changed to "submitted".

Now the offer is occupied.

Now you are only one step away from a successful booking with us！

Next please refer to Payment to notify us of the payment of the order, so that we can change the status of the order to "paid" within the agreed time limit before we confirm this order with the airline and then issue the tickets.

Only when the status of the order is changed to "paid" within the agreed time limit will the passengers' travel be guaranteed, or the offer will be recycled and can be consumed by others.

Booking API reference

For more details, please refer to Booking Service.