EN
Sign In
Developers > Flight > Guides > Order

Flight ticket order

Overview

Assuming that after the flight ticket order is paid,

John now wants to know the details of the flight ticket order and the ancillary product order that he has placed with you as well as any updates from the airline,

such as the order status, the AncillaryProductID of ancillary products or any changes made by the airline to his flights.

You then need to retrieve these details from us and show them to John in your user interface.

What do you need to start?

All you need to get started with retrieving order details is the OrderID of the flight ticket order that John is looking for.

Here is what the order service offers you at the moment:

  1. Retrieve a flight ticket order and its details by its OrderID

  2. Retrieve QMailBox messages

1. Retrieve a flight ticket order and its details by its OrderID.

You can retrieve a flight ticket order and its details by its OrderID which you can get from us after you have submitted the order to us during booking.

2. Retrieve QMailBox messages

The Q MailBox contains queue messages from airlines.

After making changes to a flight, the airline will send a message indicating the changes to the QMailBox. We will then parse the message sent by the airline, after which, the parsed message will be sent to the distributor who can then timely inform John about the changes made by the airline to his flights.

Ancillary product order

Overview

Assuming that after the ancillary product order is paid,

John now wants to know the details of the ancillary product order that he has placed with you,

such as the order status. In addition, John wants to cancel one of the purchased ancillary products—lounge service.

You then need to retrieve order details from us to show them in your user interface to John and also help John cancel the lounge service.

What do you need to start?

All you need is the OrderID of the flight ticket order that includes the ancillary product.

Here is what the order service offers you at the moment:

  • Retrieve an ancillary product order and its details by the OrderID of the flight ticket order that includes the ancillary product

  • Cancel or refund the ancillary product order

1. Retrieve an ancillary product order

You can retrieve an ancillary product order and its details by the OrderID of the flight ticket order that includes the ancillary product. You can get the OrderID of the flight ticket order that includes the ancillary product from us after you have submitted the order to us during flight ticket booking.

2. Cancel or refund an ancillary product order

There are two scenarios with regard to canceling or refunding an ancillary product order.

  • To cancel an unissued ancillary product order, you only need to create an order cancellation application. You can get your money back, if the order has been paid.

  • To cancel a paid and issued ancillary product order, you need to create a refund application to refund the order as long as the applicable refund rules allow refund.

The two steps that need to be taken for the second scenario are detailed below:

1. Query refundability

If the order is paid and order items are already issued, then your ability to cancel the order is not guaranteed, because refund in this scenario is subject to applicable refund rules. That means whether you can refund the order and how much refund you can get depend on the applicable rules.

You can use the InquireAncillaryProductCancel API to get the refundability info of order items.

  • If the response of the API shows that the order items are non-refundable, then you are unable to refund the order, which means you can not get your money back.

  • If the response of the API shows that the order items are refundable, then you will be able to refund the order. How much refund you can get depends on the applicable rules.

Please check the refund that you will get in the response.

If you are happy to go ahead, please perform the second step.

2. Create an order refund application

If you find out that the applicable refund rules allow refund, then you need to use the CancelAncillaryProduct API to create an order refund application to actually refund an order.

Order API reference

  1. Please refer to Order Service.

  2. Please refer to Ancillary Order Service.