Skip to main content

Real-time booking modification notification

When a booking is modified on the Holidu side, such as a change to dates, guest count, or payment schedule, Holidu can push an instant notification to your endpoint, eliminating the need to poll the GET booking details endpoint for updates.

This feature is available for Holidu Payments bookings only, and Holidu switches it on per provider. Holidu POSTs a payload to your endpoint; only the HTTP status of your response counts.

To enable this feature, provide your modification endpoint URL to Holidu. We will configure it on our side.


Request​

Holidu sends an HTTP POST to your configured modification endpoint with the following JSON body:

ParameterTypeRequiredDescription
holiduBookingIdLongYesHolidu's internal booking ID
providerBookingIdStringYesYour reference for the booking (the externalId you returned at booking creation)
actionStringYesAlways "MODIFICATION"
paymentHandlerStringYesAlways "HOLIDU"
checkinLocalDate YYYY-MM-DDYesUpdated check-in date
checkoutLocalDate YYYY-MM-DDYesUpdated check-out date
adultsIntegerYesTotal number of adult guests
childrenIntegerYesTotal number of child guests
paymentRatesArray of objectsYesUpdated payment schedule
paymentRates[].amountNumberYesInstallment amount
paymentRates[].currencyStringYesISO 4217 currency code (e.g. "EUR")
paymentRates[].dueDateLocalDate YYYY-MM-DDYesDate the installment is due

Example​

{
"holiduBookingId": 123123123,
"providerBookingId": "your-booking-ref-001",
"action": "MODIFICATION",
"paymentHandler": "HOLIDU",
"checkin": "2025-03-10",
"checkout": "2025-03-15",
"adults": 2,
"children": 1,
"paymentRates": [
{
"amount": 500,
"currency": "EUR",
"dueDate": "2025-03-01"
}
]
}

Response​

Respond with HTTP 200. Holidu does not read the response body, so the following body is optional:

ParameterTypeRequiredDescription
statusStringNo"ACKNOWLEDGED" (not read)

Example​

{
"status": "ACKNOWLEDGED"
}

Retry and fallback behaviour​

ScenarioBehaviour
HTTP 5xx or a timeoutHolidu tries up to 3 times in total, waiting 5 seconds, then 10 seconds
HTTP 4xx from your endpointNo retry. Treated as a permanent failure
All retries exhausted / permanent failureHolidu falls back to sending a modification email notification