# Option

## Fields

| Field | Description | Type | Min/max | Notes |
|  --- | --- | --- | --- | --- |
| [Options](/connectivity/docs/api-reference/options)/`Option` | Additional configuration for certain types of [StandardPhrase](/connectivity/docs/api-reference/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](#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](/connectivity/docs/api-reference/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](/connectivity/docs/api-reference/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](/connectivity/docs/api-reference/standardphrase)`[@Name="KeyCollection"]`. |
| `RenovationFrom` | The start date of the renovations. Format: `YYYY-MM-DD`. Required if [StandardPhrase](/connectivity/docs/api-reference/standardphrase)`[@Name="Renovation"]`. |
| `RenovationUntil` | The end date of the renovations. Format: `YYYY-MM-DD`. Required if [StandardPhrase](/connectivity/docs/api-reference/standardphrase)`[@Name="Renovation"]`. |
| `SecurityDepositAmount` | The deposit amount, in the property's default currency. Required if [StandardPhrase](/connectivity/docs/api-reference/standardphrase)`[@Name="SecurityDeposit"]`. There is a limit on maximum deposit , see [security deposit limits](#security-deposit-limits). |
| `SecurityDepositCollectMethod` | The deposit collection method. Accepts: `bank_transfer`, `credit_card`, `paypal`, `cash`. Required if [StandardPhrase](/connectivity/docs/api-reference/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](/connectivity/docs/api-reference/standardphrase)`[@Name="SecurityDeposit"]` If value is set to `when_guest_books`, then this will be changed automatically to `before_arrival` and [Option](/connectivity/docs/api-reference/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](/connectivity/docs/api-reference/standardphrase)`[@Name="SecurityDeposit"]` and [Option](/connectivity/docs/api-reference/option)`[@Name="SecurityDepositCollectWhen"]` is set to `before_arrival`. |
| `SecurityDepositReturnMethod` | The deposit return method. Accepts: `bank_transfer`, `credit_card`, `paypal`, `cash`. Required if [StandardPhrase](/connectivity/docs/api-reference/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](/connectivity/docs/api-reference/standardphrase)`[@Name="SecurityDeposit"]`. |
| `HotelChainBedLinenAmount` | The cost of renting bed linens and towels specified in the property's default currency. Required if [StandardPhrase](/connectivity/docs/api-reference/standardphrase)`[@Name="HotelChainBedLinen"]`. |


## XML


```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>
```

## Related endpoints

* [/ota/OTA_HotelDescriptiveContentNotif](/connectivity/docs/ota-hoteldescriptivecontentnotif)


## Security Deposit Limits

There are limitations on amount you can set as a security deposit (SecurityDepositAmount). The amount must be greater than 0. Other 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.
```