When a booking is being placed on Holidu, we will send you a booking notification (see Booking notification for more details). Most post-booking operations will then be handled on your side, between the traveller and you, out of synchronization with the initial Holidu booking entry. This is why it is important that you keep notifying us for any change relating to the bookings.
Example of use case 1: Booking cancellation
User [email protected] has booked on Holidu a trip for next summer to Italy. A few weeks before the trip, user [email protected] is requesting you to cancel his trip. In this case, you should notify Holidu of this cancellation.
Example of use case 2: Booking modification
User [email protected] has booked on Holidu a trip for next summer to Italy. A few weeks before the trip, user [email protected] is requesting you to delay the trip by 1 week, and to add 2 more adults to the reservation. In this case, you should notify Holidu of this modification (even if the price did not change).
To fulfil this purpose, the HOLIDU API offers three endpoints available to implement automatic update / synchronisation of bookings between Holidu and your own system:
POST /rest/public/integration/bookings → for updating or creating a booking.
This endpoint should be used in the following cases :
A customer has updated his/her booking (changed travel dates, changed number of travellers, added extra_costs, ...). You will need to notify us of these changes.
A customer has cancelled his/her trip, received a voucher, and created a new one with the voucher. You will need to notify us of this new trip.
POST /rest/public/integration/bookings/cancel → for canceling a booking. (This endpoint is required)
This endpoint should be used whenever a booking is cancelled on your end, either by you or by the traveler.
GET /rest/public/integration/bookings/details → for retrieving a booking information of booking.
This endpoint lets you retrieve all details associated to a booking.
When updating or canceling the booking you need to provide us with a bookingId or a holiduBookingId. If you are using bookingId (ID in your system) please make sure that you include a transactionId in your response to our booking notification.
If you are updating bookings for mutual (sub) partners, please note that a partner account name on Holidu is mandatory.
When cancelling a booking you need to provide us with the booking cancellation reason in the request. Please see all the possible values below.
List of cancellation reasons
|PROVIDER_NO_PAYMENT||You cancelled because the customer did not pay|
|PROVIDER_OVERBOOKED||You had to cancel because the house 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 a facility was wrongly shown on Holidu|
|CUSTOMER_UNKNOWN_REASON||The customer wanted to cancel because of an unknown reason|
|HOLIDU_TEST_BOOKING||This was cancelled because it was just a Holidu testbooking|
Updated 10 months ago