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:

  1. Read the disclaimer and activate the CVC feature at https://connect.booking.com/feature_management.
  2. 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>