When a booking is being placed on Holidu, we will send you over a booking notification (see Booking notification for more details). Most post-booking operations will then be handled on your side, between the traveler 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.
...
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 canceling a booking you need to provide us with the booking cancelation reason in the request. Please see all the possible values below.
...
Updating a booking.
| Code Block | ||
|---|---|---|
| ||
curl -X POST "https://provider-api.holidu.com/rest/public/integration/bookings" -H "accept: */*" -H "api_key: YOURAPIKEY" -H "Content-Type: application/json" -d "{ \"providerApartmentId\": 123456, \"bookingId\": \"B123456\", \"subId\": \"abc\", \"dateOfBooking\": \"2020-09-18T18:06:13.918Z\", \"arrival\": \"2020-10-20\", \"departure\": \"2020-10-30\", \"commissionablePrice\": { \"amount\": 821.8, \"currency\": \"EUR\" }, \"totalPrice\": { \"amount\": 821.8, \"currency\": \"EUR\" }, \"numberOfGuests\": 2, \"customer\": { \"country\": \"string\", \"email\": \"string\", \"firstName\": \"string\", \"lastName\": \"string\", \"phone\": \"string\" }}"
|
Cancel a Booking
| Code Block | ||
|---|---|---|
| ||
curl -X POST "https://provider-api.holidu.com/rest/public/integration/bookings/cancel?bookingId=providerbookingid123&reason=HOLIDU_TEST_BOOKING" -H "accept: */*" -H "api_key: N48TzhvLzj"
| ||
| Code Block | ||
curl -X POST "https://provider-api.holidu.com/rest/public/integration/bookings/cancel?bookingId=test_bk-538648&reason=CUSTOMER_ALTERNATIVE_ELSEWHERE_OTHER" -H "accept: */*" -H "api_key: YOURAPIKEY" |
...