Cancel bookings
This is sad - but it happens
Cancellation basics
- This is the endpoint where you can report cancellation that happend on your side to us.
- Please always provide a reason for the cancellation.
- The endpoint is syncronous, so we will confirm the successful cancellation.
- If you use Holiday Payments, you do not need this endpoint, since the guest will directly approach Holidu Customer Happiness Team, which will then update you on the booking status.
The best option is to cancel the booking as soon as you are informed about the cancellation on your side. This way the systems are always in sync and the customer does not get different information. It also ensures you do not get invoices for already canceled bookings. Holidu will invoice you based on the data present in the Holidu system.
To cancel a booking, you just need to call the endpoint with the following parameters
| Parameter | Required | Type | Usage |
|---|---|---|---|
provider | Yes | String | A unique identifier for every provider on our side |
providerBookingId | Yes | String | Either this id orholiduBookingId |
holiduBookingId | Yes | Int64 | Either this id orproviderBookingId |
cancellationFee | Yes | Number | The fee the customer needs to pay for this booking (absolute amount that is calculated, it will be x% of original booking amount) |
reason | Yes | String | The reason for canceling this booking • Please check the below list. |
Cancellattion reasons:
| Cancellation reason | Description |
|---|---|
| PROVIDER_NO_PAYMENT | You had to cancel since the customer didn't pay during the contractual timeframe |
| PROVIDER_OVERBOOKED | You had to cancel since the property was already booked out |
| CUSTOMER_WRONG_PRICE | The customer wanted to cancel because the price shown on Holidu was wrong |
| CUSTOMER_WRONG_FACILITIES | The customer wanted to cancel because the facilities were wrongly shown on Holidu |
| CUSTOMER_UNKNOWN_REASON | The customer wanted to cancel for an unknown reason |
| CUSTOMER_REBOOKING | The customer wanted to cancel because they will rebook again or already rebooked |
| CUSTOMER_PERSONAL | The customer wanted to cancel for a personal reason |
| CUSTOMER_ALTERNATIVE_HOLIDU_PRICE | The customer wanted to cancel due to finding an alternative price on Holidu |
| CUSTOMER_ALTERNATIVE_HOLIDU_LOCATION | The customer wanted to cancel due to finding an alternative location on Holidu |
| CUSTOMER_ALTERNATIVE_HOLIDU_OTHER | The customer wanted to cancel due to finding an alternative property on Holidu |
| CUSTOMER_ALTERNATIVE_ELSEWHERE_PRICE | The customer wanted to cancel due to finding an alternative price somewhere else |
| CUSTOMER_ALTERNATIVE_ELSEWHERE_LOCATION | The customer wanted to cancel due to finding an alternative location somewhere else |
| CUSTOMER_ALTERNATIVE_ELSEWHERE_OTHER | The customer wanted to cancel due to finding an alternative property somewhere else |
| CUSTOMER_TRAVEL_RESTRICTIONS_VISA | The customer wanted to cancel due to visa restrictions |
| CUSTOMER_TRAVEL_RESTRICTIONS_COVID | The customer wanted to cancel due to COVID travel resrestrictions |
| CUSTOMER_TRAVEL_RESTRICTIONS_OTHER | The customer wanted to cancel due to different restrictions |
| CUSTOMER_PROVIDER_REQUEST_BOOK_ELSEWHERE | The provider asked the customer to book directly with them |
| CUSTOMER_PROVIDER_REQUEST_AVAILABILITY | The provider indicated a lack of availability |
| CUSTOMER_PROVIDER_REQUEST_OTHER | The provider requested to cancel due to a different reason |
| CUSTOMER_PROPERTY_QUALITY | The customer wanted to cancel due to the property quality |
| CUSTOMER_OTHER | The customer didn't state the reason behind the cancellation |
| HOLIDU_TEST_BOOKING | Holidu test booking |
Updated 4 months ago