...
| Child pages (Children Display) |
|---|
Send data update instantly
In order to display correct data to the user and to avoid that he books a property which is not available anymore, you’ll need to send updated rates and availabilities as soon as there is a change on your side.
Whenever you have a booking on your side, you need to send us the updated availabilities of the concerned property.
Whenever there is a change in your prices, you need to send us the updated rates of the concerned properties.
Additional data needed
We’ll also need you to push us some additional information :
- All mandatory and optional extra costs
- Send the properties that should be bookable directly on Holidu as "isBookableOnHolidu": true, in the apartments endpoint
The following needs to be sent only if it is different per apartment. If it’s the same for all properties per domain, you should have given us the information already in the initial questionnaire:
- Your terms and conditions (in the languages used on domain you want to go live on)
- Your cancellation policies
- The payment methods you accept
- The payment schedule (please note that the percentages calculated are based on the nightly prices without any additional extra cost. For extra costs you should always provide us the payment time when sending the extra cost.)
Send cancellation policy
Below you can find an example for cancellation policy. Please consider that the cancellation policy line which is closest to the check-in date needs to be sent with "daysBeforeArrival": 0,
...
{
"isServiceFeeRefunded": true,
"cancellationPoliciesPerDate": [
{
"daysBeforeArrival": 20,
"cancellationFee": {
"feeType": "PERCENTAGE",
"amount": 0.9,
"currency": "USD",
"maxAmount": null,
"minAmount": 100
}
},
{
"daysBeforeArrival": 0, //daysBeforeArrival must be 0 for the cancellation policy line which is closest to the check-in date. In this example, it means this condition applies to days 0 to 19 before check-in.
"cancellationFee": {
"feeType": "PERCENTAGE",
"amount": 0.1,
"currency": "USD",
"maxAmount": null,
"minAmount": 100
}
}
]
}
Create availability and booking endpoints
We need you to build two endpoints on your side:
- An availability endpoint to check the instant availability of a property for given dates: https://docs.google.com/document/d/1-ijolg1QK6oKYrj50dyc-0CH5vAu5Gx4gab8_2bC80k
- A booking endpoint to notify you when a property is booked on Holidu: https://docs.google.com/document/d/1UYxDkB-jdRMBgwhmReYzRD2Qr5WeumPI6CyMt2SqeSk
- Please send the urls to these endpoints to partnersupport@holidu.com
For security measures we recommend you to whitelist our IPs so that we can only do requests to you from the following IPs:
- 54.77.51.111
- 34.249.124.33
- 212.114.208.106
Booking response
Please note that it is your responsibility to ensure that your servers are up and running and that the booking notification from Holidu is processed by your system.
When sending a booking response back to Holidu, status response 200 should be used for successful bookings. If a booking fails on your end, then you should not respond with status 200.
However, please note that regardless of the booking response you send to Holidu, Holidu treats all bookings as confirmed. Holidu uses the booking response for logging and monitoring purposes only. If we receive status responses other than 200, Holidu will investigate and react on a case by case basis.