The extra for your apartment

📘

Extra cost basics

• Extra costs are a crucial part of the booking experience of the traveller, so please make sure to follow the guidance
• To update or delete extra costs, you need to push the entire extra cost object, updates for a single extra cost are not possible
• To delete all extra costs you need to push an empty object

How to use extra cost

Holidu supports a long list of possible extra costs to offer to the traveler.

You have multiple options to configure extra cost:

• Define how it should be calculated - for instance per night, per stay or per person
• Make it mandatory or selectable for the traveler
• Choose your preferred time of payment - for instance on site, on booking or with the first payment rate

The extra cost object

List of allowed extra cost names

Basis of calculation

Types of extra costs

Payment time

Examples

Final Cleaning mandatory on booking

Cost to of Final Cleaning per stay paid on booking is only applied during high season

{
    "name": "FINAL_CLEANING",
    "basisOfCalculation": "PER_STAY",
    "type": "MANDATORY",
    "paymentTime": "ON_BOOKING",
    "price": {
      "type": "FIXED",
      "amount": 100,
      "currency": "EUR"
    },
    "condition": {
      "seasonApplicable": {
        "onlyApplicableFrom": "2024-05-01",
        "onlyApplicableUntil": "2024-09-30"
      }
    },
    "id": "111"

Bedlinen selectable for all persons

Cost for bedlinen set is 10€ paid on booking per person and a maximum of 2 sets can be selected (for instance 1 at check-in and 1 extra set to change it half of the stay).

The cost will be applied to the number of persons present in the booking.

[  
    {  
      "id": "YYY",  
      "name": "BEDLINEN",  
      "basisOfCalculation": "PER_PERSON_PER_NIGHT",  
      "maximumCount": 2, 
      "type": "SELECTABLE",
      "paymentTime": "ON_BOOKING",  
      "price": { 
      	"type": "FIXED"
       	"amount": 10,  
      	"currency": "EUR",  
        }
    }  
  ]

Bedlinen selectable per unit

Cost for bedlinen set is 10€ per unit and a maximum of 2 sets can be selected (guests can select the amount of sets they need). Tt will be available to select only if number of nights is between 1 and 6.

{
    "name": "BEDLINEN",
    "basisOfCalculation": "PER_UNIT",
    "type": "SELECTABLE",
    "paymentTime": "ONSITE",
    "price": {
      "type": "FIXED",
      "amount": 10,
      "currency": "EUR"
    },
    "condition": {
      "numberOfNights": {
        "fromStayLengthInNights": 1,
        "toStayLengthInNights": 6
      }
    },
    "id": "222",
    "maximumCount": 2
  },

Refundable security deposit

Cost for refundable security deposit 100€ paid on site:

[  
    {  
      "id": ZZZ",  
      "name": "REFUNDABLE_SECURITY_DEPOSIT",  
      "basisOfCalculation": "PER_UNIT",  
      "maximumCount": 1, 
      "type": "MANDATORY",
      "paymentTime": "ONSITE",  
      "price": { 
      	"type": "FIXED"
       	"amount": 100,  
      	"currency": "EUR",  
        }
    }  
  ]

❗

️ Be aware

Extras to be paid for extra guest or for a short stay are not supported by the extra cost endpoint. Our pricing model supports defining prices based on the number of persons and for different length of stay Length of stay section.

If a condition object is pushed with seasonApplicable object, be aware that onlyApplicableFrom and onlyApplicableUntil cannot be null.

If a condition object is pushed with numberOfNights object, be aware that fromStayLengthInNights and toStayLengthInNights cannot be null.

🚧

Special treated extra costs

There are certain extra costs that are treated special on Holidu

• "REFUNDABLE_SECURITY_DEPOSIT": It is always excluded from total collected price and from payment rates. Also deposit cannot be pushed with a percentage price, only with fixed price.
• "TOURIST_OR_CITY_TAX": PaymentTime should be "ONSITE"
• "VAT_OF_RENTAL_PRICE"

For the above extra costs the type will be ignored and we consider them all as "MANDATORY"

• SERVICE_COSTS: This cost type should only be used in exceptional cases. Please ensure to discuss and review the usage of this type of extra costs with our technical support team, as costs under this label will draw extra attention on our side as it is often used to exploit booking costs and commissionable amounts.