Skip to main content

Hotel-X Development - Cancel Mutation

You can use Hotel-X Cancel Mutation to easily cancel a booking made through TravelgateX.

How can I cancel a booking?💡​

You have two options to cancel a reservation:

  1. Using its booking reference.
  2. Using its bookingID.
tip

Don't forget to check our article on Book Mutation for further details on the information returned in Book response🚀

What information can I expect in Cancel response?✔️​

The information returned in Cancel response may vary between Sellers, so please check our Hotel-X Playground Documentation in order to add to your Cancel the fields expected on your side. Additionally, you may check the Sellers' Metadata for further details on the specifications established on their side for this Method and the data returned on their end.

cancel_mutation_1

warning

Please note that Travelgate cannot make reservations or cancellations on behalf of our Partners; these actions should be carried out directly by the Partner.

Some of the fields returned once a booking is cancelled are:

  1. Booking status: more information on status in cancel response here.
  2. Reference
  3. Price
  4. Holder

How are cancellation costs calculated and displayed?🔢​

Depending on the specifications provided by a Seller, cancellation costs can be calculated using three different penalty types. It is important to keep in mind that a booking may have more than one penalty type associated with it.

  • NIGHTS: It indicates the number of nights to be penalized.
  • PERCENT: It indicates the percentage to pay based on the option price (possible values between 0 and 100).
  • IMPORT: It Indicates the exact amount payable.
important

To ensure seamless billing, it's important that you handle all cancellations via our API.
Should you face any issues, please don't hesitate to get in touch with our Customer Support team for assistance. Additionally, please make sure to cancel any test bookings with Sellers and to check that such bookings are refundable.

Can I apply any filters to my Hotel-X Cancel Mutation?💡​

Unfortunately, there are no filters in the Cancel Mutation.

Is it possible to retrieve the cancellation costs without canceling the option?🔎​

If the Seller provides cancel policies information, you can access it either through Hotel-X Quote Query or Hotel-X Booking Query.

Can Travelgate remove cancellation fees from a booking after it has been canceled, in cases where hotels waive these fees?​

As cancellation policies are returned by the Supplier via the integration, it is not possible to remove cancellation fees from a booking that already includes them.

In a reservation for 2 rooms, if two rooms have the same cancellation policy, should the cancellation penalties be summed up in the node for the option?​

Yes, an option is a combination of rooms. Cancelling the option implies the cancellation of all rooms, and therefore, the charges for all the rooms are incurred.

tip

Don't forget to check our Hotel-X API Playground and Documentation for further information on Cancel Mutation. Interested in cancel penalties information as well? We've got you covered with some awesome articles that dive deep into the topic!🚀