Implementing or disabling CVC collection¶
You can use the HotelDescriptiveContentNotif
endpoint to enable your properties to collect the CVC or CVV (credit card verification code) of their guests.
Use case¶
To enable your properties to collect the CVC of their guests, you must:
- Read the disclaimer and activate the CVC feature at https://connect.booking.com/feature_management.
- Implement the feature per property by calling the
HotelDescriptiveContentNotif
endpoint.
Implementing (or disabling) CVC collection¶
POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif
The HotelDescriptiveContentNotif
endpoint enables you to implement or disable CVC collection for a specific property. Ensure that you read the disclaimer and activated the feature at https://connect.booking.com/feature_management.
Header parameters¶
The following table lists the header parameters in the request:
Parameter | Description | Type | Required/Optional | Notes |
---|---|---|---|---|
Authorization |
Machine account username and password | string | Required | Example: Authorization: Basic {username:password} |
Body parameters¶
You can find the body parameters in the following table:
Element | Description | Type | Required/Optional | Notes |
---|---|---|---|---|
OTA_HotelDescriptiveContentNotifRQ |
Contains the Target attribute, which specifies the request is for a real property (Production ) or a test property (Test ). |
root element | required | |
: HotelDescriptiveContents |
Contains the HotelDescriptiveContent elements. |
array | required | |
:: HotelDescriptiveContent |
Contains the following attributes: HotelDescriptiveContentNotifType : Specifies whether the request is meant to create a new property (New ) or overlay an existing one (Overlay ). Set it to Overlay to implement or disable the CVC collection. HotelCode : Specifies the unique property id. |
object | required | The default value for HotelDescriptiveContentNotifType is New . |
::: HotelInfo |
Contains the elements associated with property details and descriptions. | object | required | |
:::: TPA_Extensions |
Contains elements that are seen as extensions of the OTA standard. | object | required | |
::::: PaymentPreferences |
Contains the NoCVC attribute, which specifies whether to implement (0) or disable (1) CVC collection for a property. |
object | required | The default value for NoCVC is 0. |
Request body example¶
You must specify the property for which you want to implement or disable CVC collection. The following is a request body example for an implementation:
<OTA_HotelDescriptiveContentNotifRQ Target="Production">
<HotelDescriptiveContents>
<HotelDescriptiveContent
HotelDescriptiveContentNotifType="Overlay"
HotelCode="12345">
<TPA_Extensions>
<PaymentPreferences NoCVC="0" /> <!-- NoCVC="0" means you want to implement the collection of CVC for this property. !-->
</TPA_Extensions>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>
Sample response¶
The following is a success response:
<OTA_HotelDescriptiveContentNotifRS Target="Production">
<Success />
</OTA_HotelDescriptiveContentNotifRS>