Option

Fields

Field Description Type Min/max Notes
Options/
Option
Additional configuration for certain types of StandardPhrase. string 0..* -
Option/
@Name
The type of option. enum 1..1 Accepts: KeyCollectionAddressLine, KeyCollectionCityName, KeyCollectionPostalCode, RenovationFrom, RenovationUntil, SecurityDepositAmount, SecurityDepositCollectMethod, SecurityDepositCollectWhen, SecurityDepositCollectNumDays, SecurityDepositReturnMethod, SecurityDepositReturnWhen, HotelChainBedLinenAmount. See @Name for details.

@Name

Option[@Name] accepts the values in the table below.

Note

The first part of each value's name refers to a value of StandardPhrase[@Name]. This reference indicates a certain requirement, explained in the Description column.

Value Description
KeyCollectionAddressLine The street name and number for the key collection address. Required if StandardPhrase[@Name="KeyCollection"].
KeyCollectionCityName The city name for the key collection address. Required if StandardPhrase[@Name="KeyCollection"].
KeyCollectionPostalCode The postal code for the key collection address. Required if StandardPhrase[@Name="KeyCollection"].
RenovationFrom The start date of the renovations. Format: YYYY-MM-DD. Required if StandardPhrase[@Name="Renovation"].
RenovationUntil The end date of the renovations. Format: YYYY-MM-DD. Required if StandardPhrase[@Name="Renovation"].
SecurityDepositAmount The deposit amount, in the property's default currency. Required if StandardPhrase[@Name="SecurityDeposit"]. There is a limit on maximum deposit , see security deposit limits.
SecurityDepositCollectMethod The deposit collection method. Accepts: bank_transfer, credit_card, paypal, cash. Required if StandardPhrase[@Name="SecurityDeposit"]. Note that if the property has not been verified to use credit card payments, the default value becomes cash regardless of setting it to credit_card.
SecurityDepositCollectWhen The moment when the property will collect the deposit. Accepts: before_arrival, upon_arrival, when_guest_books. Required if StandardPhrase[@Name="SecurityDeposit"] If value is set to when_guest_books, then this will be changed automatically to before_arrival and Option[@Name="SecurityDepositCollectNumDays"] will be set to 14.
SecurityDepositCollectNumDays The number of days before check-in when the property will collect the deposit. Accepts: 7, 14. Required only if StandardPhrase[@Name="SecurityDeposit"] and Option[@Name="SecurityDepositCollectWhen"] is set to before_arrival.
SecurityDepositReturnMethod The deposit return method. Accepts: bank_transfer, credit_card, paypal, cash. Required if StandardPhrase[@Name="SecurityDeposit"].
SecurityDepositReturnWhen The time period when the guest can expect the property to return their deposit. Accepts: on_checkout, within_7_days, within_14_days. Required if StandardPhrase[@Name="SecurityDeposit"].
HotelChainBedLinenAmount The cost of renting bed linens and towels specified in the property's default currency. Required if StandardPhrase[@Name="HotelChainBedLinen"].

XML

<Option
  Name="KeyCollectionAddressLine">
  Rembrandtplein
</Option>
<Option
  Name="KeyCollectionCityName">
  Amsterdam
</Option>
<Option
  Name="KeyCollectionPostalCode">
  1017 CD
</Option>
...
<Option
  Name="RenovationFrom">
  2017-02-18
</Option>
<Option
  Name="RenovationUntil">
  2017-02-19
</Option>
...
<Option
  Name="SecurityDepositAmount">
  120
</Option>
...
<Option
  Name="HotelChainBedLinenAmount">
  10
</Option>

Security Deposit Limits

There are limitations on amount you can set as a security deposit (SecurityDepositAmount). The limitations vary in different cases. If you exceed the maximum allowed amount - value of your security deposit will be reset to maximum possible and you will receive a warning message like this:

   SecurityDepositAmount exceeded the limit of X, the value has been set to X.