Skip to main content

Bookings

📄️Create or update a booking

Reports a booking change made on your side, identified by your `providerBookingId`: new arrival/departure dates, a new price or a new guest count, so that Holidu recalculates its commission (`metaData.commission`). If Holidu has no booking with this `providerBookingId` for your account, the call creates it as a confirmed booking on `providerApartmentId`, booked at the time of the call. `bareRentalPrice` is the commission base; if extra costs are commissionable for your account, the base is `bareRentalPrice` plus `costs` without tourist tax and deposit (or `totalPrice` if you send no `costs`). Send amounts in the booking's original currency: an update in another currency is ignored, and the call still returns 200 with the unchanged booking. Changing `numberOfGuests` replaces the guest list with that many adults without ages. An existing booking must stay on the same apartment (400); moving a booking to another apartment is not supported. Holidu Payments bookings cannot be changed here (403), and the call is not available in the sandbox (418).

📄️Cancel a booking

Cancels a Holidu booking that was cancelled on your side; call it right away: Holidu then recalculates its commission on `cancellationFee` (no commission without a fee, unless your agreement has a fixed cancellation commission). `reason` is required and `cancellationFee` is the absolute fee the guest still pays, in the booking's currency. The call is synchronous and returns `CANCELLATION_SUCCESSFUL`. Holidu Payments bookings must be cancelled in the Partner Portal instead (403), and the call is not available in the sandbox (418).