Implementing or disabling CVC collection
Use the PaymentPreferences
element within the HotelDescriptiveContentNotif
endpoint to enable your properties to collect the CVC or CVV (credit card verification code) of their guests.
Implementing (or disabling) CVC collection
POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif
Use the PaymentPreferences
element while updating the property details (HotelDescriptiveContentNotif
endpoint) to implement or disable CVC collection for a specific property.
The Activate CVC collection(capi_payment_collect_cvc
) feature is deprecated. Irrespective of the feature setting, you can implement the NoCVC
attribute of PaymentPreferences
.
Body parameters
The following table contains the body parameters specific to enabling/disabling collecting CVC/CVV:
Element | Attribute | 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 details about the property. | object | required | ||
HotelDescriptiveContentNotifType | Specify whether the request is meant to create a new property (New ) or overlay an existing one (Overlay ). | enumerated string | optional | The default value is New . | |
HotelCode | Specifies the unique property ID. | string | required | ||
>>> 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 details such as whether properties can see guest's credit card details and and collect CVC codes. | object | optional | The default value for NoCVC is 1. | |
NoCVC | Specify whether properties can collect CVC for a booking. | boolean | optional | * 0 - Properties can collect CVC details. * 1 - Properties cannot collect CVC details. | |
ViewCCDetails | Specify whether trusted properties can view the guest's credit card details. | boolean | optional | * 0 - Properties cannot view credit card details. * 1 - A trusted property can view the credit card details. |
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"> <HotelInfo> <TPA_Extensions> <PaymentPreferences NoCVC="0" ViewCCDetails="true" /> <!-- NoCVC="0" means collect CVC for this property. !--> </TPA_Extensions> </HotelInfo> </HotelDescriptiveContent> </HotelDescriptiveContents> </OTA_HotelDescriptiveContentNotifRQ>
Sample response
The following is a success response:
<OTA_HotelDescriptiveContentNotifRS Target="Production"> <Success /> </OTA_HotelDescriptiveContentNotifRS>