Last updated

Migrating to new versions

At Booking.com, we want to continuously improve the Connectivity Partner experience. This means we try to build better products and deprecate the older versions. When Booking.com plans to deprecate a feature or a product, you can no longer use it after the communicated date of deprecation. To help facilitate the potential changes you must make, the migration guide tables on this page aim to help you understand what is deprecated and what its (improved) alternative is.

Migrating to a new promotion ID prefix

The Promotions API, as of March 27, 2024, returns the new prefix TB instead of the previously used VR prefix whenever you create or update a promotion. We plan to automatically change the ID of promotions prefixed with VR to a new ID using the getpromotions endpoint, effective from January 31st, 2025. After the change, those promotions will get a new ID prefixed with TB, followed by a unique string.

What we expect from Connectivity Partners

To ensure all your promotions use the new prefix, complete the following actions before January 31st, 2025:

  1. Retrieve all existing promotions for a property using the getpromotions endpoint and note down the promotions with prefix VR. Make sure to specify the hotel_id and active parameters.

Request example

The following example shows how to retrieve all active promotions including those with prefix VR of an existing property using the POST /hotels/xml/getpromotions endpoint.

<request>
    <hotel_id>12312</hotel_id>
    <active>1</active>
 </request>
  1. For each promotion still using the VR prefix, generate a new promotion ID with the TB prefix. Use the POST /promotions endpoint and send only the existing promotion ID in the request body. This will return a new promotion ID with the TB prefix.

Request example

The following example shows how to update the ID of an existing promotion with a VR prefix to get a new promotion ID with a TB prefix using the POST /hotels/xml/promotions endpoint.

<request>
    <hotel_id>12312</hotel_id>
     <promotion 
         id="VR123456789">
     </promotion>
 </request>

Sample response

<promotions>
    <id>TB437287097257498474</id>
</promotions>
<!-- RUID: [...] -->

Changes to the Reservations API response

We are rolling out changes to the way the Reservations API calculates and displays the breakdown of the total price for each booking. You can get the changed Reservations API response by enabling the new feature: Payments Clarity Package V2 (payment_clarity_package_v2) once you have completed testing the feature.

The feature is enabled, after prior confirmation, only for providers who manage properties located in a region where Booking.com is obligated to withhold and remit taxes on behalf of the property.
If you have been using the Include Price Details (include_price_details) or the existing Payments Clarity Package (vcc_payment_v2) feature earlier, post enabling the PCP 2.0 feature, you will receive data only from the Payments Clarity Package V2 (payment_clarity_package_v2) feature.

For more information on how to test the feature per request and without enabling for all properties, see Testing Payments Clarity Package v2. To enable the PCP 2.0 feature, contact the Connectivity Support team.

What is Payments Clarity Package v2?

Payments Clarity Package V2 (PCP 2.0) is a new and improved version of the Payments Clarity Package feature with significant changes to the response elements. This feature is relevant only when used along with the Reservations API.

What are the changes?

The response element changes impact both the OTA and the B.XML Reservations API response. This section summarises the changes for each of the response schema.

Summary of B.XML response change

There are three changes to the B.XML response schema:

  • The yes | no values in the extracomponent > included field now specifies:
    • Under <guest>, whether the guest paid the amount for Payments by Booking reservations. For non-Payments by Booking reservations (agency bookings), it indicates whether the amount is included in the total amount the guest will pay to the property.
    • Under <hotel>, whether the amount is included in the payout to the property for Payments by Booking reservations. For agency bookings, it indicates whether the amount is included in the total amount that the property should collect from the guest.
  • The total amount is computed based on the above logic and so differs from the existing implementation.
  • For properties where Booking.com is obligated to withhold taxes, the response includes an additional entry for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (Withheld tax) under extracomponent > text.

Summary of OTA response change

There are three changes to the OTA response schema:

  • Introduction of <GuestView> and <HotelView> sections to list the booking amount breakup.
  • The Inclusive | Exclusive values in the Type field now specifies:
    • Under <GuestView>, whether the guest paid the amount for Payments by Booking reservations. For non-Payments by Booking reservations (agency bookings), it indicates whether the amount is included in the total amount the guest will pay to the property.
    • Under <HotelView>, whether the amount is included in the payout to the property for Payments by Booking reservations. For agency bookings, it indicates whether the amount is included in the total amount that the property should collect from the guest.
  • The total amount is computed based on the above logic and so differs from the existing implementation.
  • For properties where Booking.com is obligated to withhold taxes, the response includes an additional entry for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (Withheld tax) under Tax > TaxDescription > Text.

B.XML response changes at a glance

Payment solutionResponse elements ChangedWhen using the Payments Clarity Package
(vcc_payment_v2)
When using the Payments Clarity Package V2
payment_clarity_package_v2
VCC Bookings
Property where Booking.com is obligated to withhold tax
guest > includedIndicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether Booking.com collected the taxes/fees amount from the guest during the booking process.
guest > totalIndicates the price amount that Booking.com shows to guests.Indicates the total amount that Booking.com collected from the guests for the booked room.
hotel > includedIndicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates whether the taxes/fees amount is included in the payout to the property for the booked room.
hotel > totalIndicates the price amount of the reservation.Indicates the total payout amount to the property for the booked room.
VCC balanceIndicates the amount that the properties can charge on the VCC.- Bookings with withheld tax: The amount that properties can charge on the VCC. Note that this excludes the withheld tax that Booking.com has withheld and will remit on property's behalf.
- Bookings without withheld tax: The amount that properties can charge on the VCC.
Bank transfer bookings
Property where Booking.com is obligated to withhold tax
guest > includedIndicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether Booking.com collected the taxes/fees amount from the guest during the booking process for the booked room.
guest > totalIndicates the price amount that Booking.com shows to guests.Indicates the total amount that Booking.com collected from the guests for the booked room.
hotel > includedIndicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates whether the taxes/fees amount is included in the payout to the property for the booked room.
hotel > totalIndicates the price amount of the reservation.Indicates the total payout amount to the property for the booked room.
Agency bookings^guest > includedIndicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether the taxes/fees amount is included in the total amount the guest will pay to the property for the booked room.
guest > totalIndicates the price amount that Booking.com shows to guests.Indicates the total amount that the guest will pay to the property for the booked room.
hotel > includedIndicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates whether the taxes/fees amount is included in the total amount that the property should collect from the guest for the booked room.
hotel > totalIndicates the price amount of the reservation.Indicates the total amount the property should collect from the guest.

^ - hotel > total amount is always the same as the guest > total amount.
   - hotel > included value is always the same as the guest > included value.

For detailed changes when implementing the Payments Clarity Package V2 (payment_clarity_package_v2) feature directly, see the B.XML response changes.

OTA response changes at a glance

Payment solutionResponse elements ChangedWhen using the Payments Clarity Package
(vcc_payment_v2)
When using the Payments Clarity Package V2
payment_clarity_package_v2 feature
VCC Bookings
Property where Booking.com is obligated to withhold tax
GuestView > Tax > Type
Inclusive/Exclusive
Indicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether Booking.com collected the taxes/fees amount from the guest during the booking process.
GuestView > TotalIndicates the price amount that Booking.com shows to guests.Indicates the total amount that Booking.com collected from the guests.
HotelView > Tax > Type
Inclusive/Exclusive
Indicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates whether the taxes/fees amount is included in the payout to the property.
HotelView > TotalIndicates the price amount of the reservation.Indicates the total payout amount to the property.
VCC balanceIndicates the amount that properties can charge on the VCC.- Bookings with withheld tax: The amount that properties can charge on the VCC. Note that this excludes the withheld tax that Booking.com has withheld and will remit on property's behalf.
- Bookings without withheld tax: The amount that properties can charge on the VCC.
Bank transfer bookings
Property where Booking.com is obligated to withhold tax
GuestView > Tax > Type
Inclusive / Exclusive
Indicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether Booking.com collected the taxes/fees amount from the guest during the booking process.
GuestView > TotalIndicates the price amount that Booking.com shows to guests.Indicates the total amount that Booking.com collected from the guests.
HotelView > Tax > Type
Inclusive/Exclusive
Indicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates whether the taxes/fees amount is included in the payout to the property.
HotelView > TotalIndicates the price amount of the reservation.Indicates the total payout amount to the property.
Agency bookings^GuestView > Tax > Type
Inclusive/Exclusive
Indicates whether the taxes/fees are included in the room price that Booking.com shows to guests.Indicates whether the taxes/fees amount is included in the total amount the guest will pay to the property.
GuestView > TotalIndicates the price amount that Booking.com shows to guests.Indicates the total amount the guest will pay to the property.
HotelView > Tax > Type
Inclusive/Exclusive
Indicates whether the taxes/fees are included in the room price of the reservation as specified in the Extranet VAT/tax/charges page.Indicates if the taxes/fees amount is included in the total amount that the property should collect from the guest.
HotelView > TotalIndicates the price amount of the reservation.Indicates the total amount the property should collect from the guest.

^ - HotelView > Total amount is always the same as the GuestView > Total amount.
   - HotelView > Tax > Type Inclusive/Exclusive value is always the same as the GuestView > Tax > Type Inclusive/Exclusive value.

For detailed changes when implementing the Payments Clarity Package V2 (payment_clarity_package_v2) feature directly, see the OTA response changes.

Implementing Payments Clarity Package v2 directly

The following are the changes when you implement Payments Clarity Package v2 without having used the Payments Clarity Package vcc_payment_v2 or the Include Price Details (include_price_details) feature.

B.XML response changes

Following are the changes to the B.XML response:

The yes | no values in the extracomponent > included field specifies:

  • Under <guest>, whether the guest paid the amount
  • Under <hotel>, whether the amount is included in the payout to the property.
  • The total amount is computed based on the above logic and so differs from the existing implementation.

Also for properties where Booking.com is obligated to withhold taxes, the response includes an additional entry for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (withheld tax) under extracomponent > text.

Updated B.XML response elements
Expand this section to view the change in the B.XML response elements.
ElementAttributeDescriptionTypeNotes
> price_detailsContains price details.object
>> guestContains the total amount paid by the guest and the details of the extra charges that were either included or excluded from the total amount.object
>>> extracomponentContains the details of the extra charges that were either included or excluded from the total amount paid by the guest.objectTypically, the charges listed under guest are also listed under hotel.
- Handling fee waivers: If the property waives a specific charge, then the extra charge is excluded (included=no) from guest > total amount and also excluded (included=no) from hotel > total amount.
- Handling tax amount: Where Booking.com handles tax amount and submits them directly to the tax authority on behalf of the property, then the extra charge is included (included=yes) in the guest > total but excluded (included=no) from the hotel > total amount.
- In few cases where Booking.com sponsors the extra charge, then the extra component would show as included=no under the guest > total amount, but included=yes under the hotel > total amount.
- If the guest has to pay a fee/charge and if the property has to be paid the extra amount, then the extra component would show as included=yes under the guest > total amount, and included=yes under the hotel > total amount.
textSpecifies the description of the extra charge as entered from the Booking.com Extranet by the property.
amountSpecifies the extra charge amount.integer
currencySpecifies the currency code for the charge amount.enumerated stringFollows the ISO 4217 currency code. The value is always the same for a property and is set by Booking.com.
includedSpecifies whether this extra charge is included in the total amount.booleanYes, denotes that the extra amount is included in the total amount.
per_nightIndicates whether this extra charge is applied per night.boolean
per_personIndicates whether this extra charge is applied per personboolean
percentageThe percentage of the extra charge applied to the total amount.
>>> totalSpecifies the total amount paid by the guest.integerThe amount is computed based on the value in the included field and so differs from the existing implementation.
>> hotelContains the total amount owed to the property and the details of the extra charges that were either included or excluded from the total amount.object
>>> extracomponentContains the details of the extra charges that were either included or excluded from the total amount (that is owed to the property).objectTypically, the charges listed under guest are also listed under hotel.
- Handling fee waivers: If the property waives a specific charge, then the extra charge is excluded (included=no) from guest > total amount and also excluded (included=no) from hotel > total amount.
- Handling tax amount: Where Booking.com handles tax amount and submits them directly to the tax authority on behalf of the property, then the extra charge is included (included=yes) in the guest > total but excluded (included=no) from the hotel > total amount.
- In few cases where Booking.com sponsors the extra charge, then the extra component would show as included=no under the guest > total amount, but included=yes under the hotel > total amount.
- If the guest has to pay a fee/charge and if the property has to be paid the extra amount, then the extra component would show as included=yes under the guest > total amount, and included=yes under the hotel > total amount.
textSpecifies the description of the extra charge as entered from the Booking.com Extranet by the property.
amountSpecifies the extra charge amount.integer
currencySpecifies the currency code for the charge amount.enumerated stringFollows the ISO 4217 currency code. The value is always the same for a property and is set by Booking.com.
includedSpecifies whether this extra charge is included in the total amount.booleanYes, denotes that the extra amount is included in the total amount.
per_nightIndicates whether this extra charge is applied per night.boolean
per_personIndicates whether this extra charge is applied per personboolean
percentageThe percentage of the extra charge applied to the total amount.
>>> totalSpecifies the total amount owed to the property.integerThe amount is computed based on the value in the included field and so differs from the existing implementation.

For B.XML response examples, see the B.XML response changes.

OTA response changes

The following are the OTA response changes:

  • Introduction of <GuestView> and <HotelView> sections to list the booking amount breakup.
  • The Inclusive | Exclusive values in the Type field specifies:
    • Under <GuestView>, whether the guest paid the amount.
    • Under <HotelView>, whether the amount is included in the payout to the property.
  • The Amount > Total is computed based on the above logic and so differs from the existing implementation.

Also for properties where Booking.com is obligated to withhold taxes, the response includes an additional entry for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (withheld tax) under Tax > TaxDescription > Text

Changed OTA response elements
Expand this section to view the change in the OTA response elements.
ElementAttributeDescriptionTypeNotes
RoomStaysContains the room reservation details.object
> RoomStayContains the room reservation details for each booked room.object
>> PriceDetailsContains the guest and property-level price details for the reservation.object
>>> GuestViewContains the guest-level price details for the reservation.objectTypically, the charges listed under GuestView are also listed under HotelView.
- Handling fee waivers: If the property waives a specific charge, then the extra charge is excluded (Tax Type="Exclusive") from GuestView > Total amount and also excluded (Tax Type="Exclusive") from HotelView > Total amount.
- Handling tax amount: Where Booking.com handles tax amount and submits them directly to the tax authority on behalf of the property, then the extra charge is included (Tax Type="Inclusive") in the GuestView > Total but excluded (Tax Type="Exclusive") from the HotelView > Total amount.
- In few cases where Booking.com sponsors the extra charge, then the extra component would show as Tax Type="Exclusive" under the GuestView > Total amount, but Tax Type="Inclusive" under the HotelView > Total amount.
- If the guest has to pay a fee/charge and if the property has to be paid the extra amount, then the extra component would show as Type=Inclusive under the GuestView > Total amount, and Type=Inclusive under the HotelView > Total amount.
>>>> TaxesContains tax details.object
>>>>> TaxContains tax details.object
AmountSpecifies the tax amount.integer
ChargeFrequencySpecifies the charge frequency.enumerated integerFor a list of charge frequency code, see charge type codes.
CodeSpecifies the tax code.integerNote that we show the information in the preferred language of the property's primary point of contact. If you have implemented the Content API, then you can set the language under ContactInfos ... >... Language for the ContactProfileType as general via the [OTA_HotelDescriptiveContentNotif endpoint.][OTA_HotelDescriptiveContentNotif] For a list of fee tax type codes, see Tax type codes.
CurrencyCodeSpecifies the currency used for pricing the room.enumerated stringThis is always the same for a property and is set by Booking.com.
DecimalPlacesSpecifies the number of decimal places to represent the minor unit of a particular currency.integer
TypeSpecifies whether this extra charge is included in the total amount.enumerated stringPossible values are:
- Inclusive: The extra charge was collected from the guest.
- Exclusive: The extra charge was not collected from the guest.
>>>>>> TaxDescriptionContains the tax description.object
>>>>>>> TextSpecifies the tax description.string
>>>> TotalContains the room price details.object
AmountSpecifies the total amount collected from the guest.integerThe amount is computed based on the value in the Type field and so differs from the existing implementation.
DecimalPlacesSpecifies the number of decimal places to represent the minor unit of a particular currency.integer
>>> HotelViewContains the property-level price details for the reservation.objectTypically, the charges listed under HotelView are also listed under GuestView.
- Handling fee waivers: If the property waives a specific charge, then the extra charge is excluded (Tax Type="Exclusive") from GuestView > Total amount and also excluded (Tax Type="Exclusive") from HotelView > Total amount.
- Handling tax amount: Where Booking.com handles tax amount and submits them directly to the tax authority on behalf of the property, then the extra charge is included (Tax Type="Inclusive") in the GuestView > Total but excluded (Tax Type="Exclusive") from the HotelView > Total amount.
- In few cases where Booking.com sponsors the extra charge, then the extra component would show as Tax Type="Exclusive" under the GuestView > Total amount, but Tax Type="Inclusive" under the HotelView > Total amount.
- If the guest has to pay a fee/charge and if the property has to be paid the extra amount, then the extra component would show as Type=Inclusive under the GuestView > Total amount, and Type=Inclusive under the HotelView > Total amount.
>>>> TaxesContains tax details.object
>>>>> TaxContains individual tax or fee details.object
AmountSpecifies the tax amount.integer
ChargeFrequencySpecifies the charge frequency.enumerated integerFor a list of charge frequency code, see charge type codes.
CodeSpecifies the tax code.integerNote that we show the information in the preferred language of the property's primary point of contact. If you have implemented the Content API, then you can set the language under ContactInfos ... >... Language for the ContactProfileType as general via the [OTA_HotelDescriptiveContentNotif endpoint.][OTA_HotelDescriptiveContentNotif] For a list of fee tax type codes, see Tax type codes.
CurrencyCodeSpecifies the currency used for pricing the room.enumerated stringThis is always the same for a property and is set by Booking.com.
DecimalPlacesSpecifies the number of decimal places to represent the minor unit of a particular currency.integer
TypeSpecifies whether this extra charge is included in the total amount.enumerated stringPossible values are:
- Inclusive: The extra charge is included in the payout to the property.
- Exclusive: The extra charge is excluded from the payout to the property.
>>>>>> TaxDescriptionContains the tax description.object
>>>>>>> TextSpecifies the tax description.string
>>>> TotalContains the total room price details.object
AmountSpecifies the total amount owed to the property.integerThe amount is computed based on the value in the Type field and so differs from the existing implementation.
DecimalPlacesSpecifies the number of decimal places to represent the minor unit of a particular currency.integer

For API response examples, see the OTA response changes.

Upgrading Payments Clarity Package to PCP 2.0

The following are the changes when migrating the Payments Clarity Package from v1 to v2:

B.XML response changes

By enabling the Payments Clarity Package V2 feature you can expect the following changed behaviour using the Reservations API:

  • guest > extracomponent > included: yes/no : Indicates whether Booking.com collected the specified amount from the guest.
  • hotel > extracomponent > included: yes/no : Indicates whether Booking.com includes the specified amount in the total as owed to the property.

In addition to the extra fields returned by the existing vcc_payment_v2 feature, the response includes an additional entry for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (withheld tax) under the extracomponent field. This specifies whether Booking.com has withheld tax for a reservation for properties where Booking.com is obligated to withhold taxes.

Changes to Include Price Details and Payments Clarity Package v1 behaviour

If you have been validating whether fees, taxes or charges are included in the price when recalculating the reservation prices (with the Include Price Details (include_price_details) or the Payments Clarity Package (vcc_payment_v2) feature turned on), then you must revisit the price calculation as the relevant flags and amounts will change once the new Payments Clarity Package V2 (payment_clarity_package_v2) feature is enabled. Doing this can avoid showing incorrect reservation prices.

Summary of different combinations of included value

The following table captures the intended behaviour of the included field. The value Excluded here denotes included="no"

ScenarioGuest ViewProperty ViewPayments by Booking behaviourAgency Booking behaviour
1ExcludedExcluded- Fees/tax was not collected during the book process.
- Fees/tax will not be paid out to the property.
- Fees/tax will be collected from guests by the property at the time of check-in.
-
2ExcludedIncluded- Fees/tax was not collected from the guest during booking.
- Fees/tax cost will be borne by Booking and paid out to the property as a benefit.
-
3IncludedExcluded- Fees/tax was collected from the guest during booking.
- Fees/tax is withheld and will be paid directly to the authorities and not to property.
-
4IncludedIncluded- Fees/tax was collected from the guest during booking.
- Fees/tax will be paid out to property.
- Fees/tax will be collected from guests by the property.

For Reservations API response examples, see B.XML endpoint examples.

OTA response changes

To support showing the pricing breakup between the guest (what was collected from the guest) and the property (what is paid out to the property), we have encapsulated the pricing details within the GuestView and HotelView in the response details:

  • PriceDetails > GuestView > Taxes > Tax > Type: Inclusive/Exclusive: [For bookings where Booking.com handles payments] Indicates whether Booking.com collected the specified amount from the guest.
  • PriceDetails > HotelView > Taxes > Tax > Type: Inclusive/Exclusive: [For bookings where Booking.com handles payments] Indicates whether Booking.com includes the specified amount in the total as owed to the property.
  • RoomStay > <Total AmountAfterTax="10000"> is now changed to show total for the guest and the property as follows:
    • PriceDetails > GuestView > <Total Amount="10000">
    • PriceDetails > HotelView > <Total Amount="10000">

In addition, you also get an additional attribute in the Tax field for every tax component that Booking.com has to withhold with the value {{Tax_Name}} (Withheld tax) under Tax > TaxDescription > Text.

Summary of different combinations of Tax > Type values

The following table captures the intended behaviour of the Type="Inclusive" or "Exclusive" field.

ScenarioGuest ViewProperty ViewPayments by Booking behaviourAgency Booking behaviour
1ExclusiveExclusive- Fees/tax was not collected during the book process.
- Fees/tax will not be paid out to the property.
- Fees/tax will be collected from guests by the property at the time of check-in.
-
2ExclusiveInclusive- Fees/tax was not collected from the guest during booking.
- Fees/tax cost will be borne by Booking and paid out to the property as a benefit.
-
3InclusiveExclusive- Fees/tax was collected from the guest during booking.
- Fees/tax is withheld and will be paid directly to the authorities and not to property.
-
4InclusiveInclusive- Fees/tax was collected from the guest during booking.
- Fees/tax will be paid out to property.
Fees/tax will be collected from guests by the property.

For Reservations API response examples, see OTA endpoint examples.

Response examples for Payments Clarity Package v2

This section contains example responses based on multiple scenarios including multiple payment solutions, before and after activating the Payments Clarity package v2 (payment_clarity_package_v2) feature.

Property on Payments by Booking using VCC as payout

This section shows the current (with Payments Clarity Package (vcc_payment_v2) feature enabled) and with the new Payments Clarity Package V2 (payment_clarity_package_v2) feature enabled to help you compare the difference in behaviour. This section contains examples from both B.XML and OTA responses based on the VCC payment solution and with/without withheld tax components in the response.

Expand to see relevant response examples

As we have included multiple response examples, to improve readability we have collapsed all examples. You can expand to see the examples of specific scenarios that you are interested in.

B.XML response examples

Following is a summary of B.XML response examples covered in this section:

B.XML response with Payments Clarity Package (vcc_payment_v2)B.XML response with Payments Clarity Package V2 (payment_clarity_package_v2)
Current exampleResponse with withheld tax
Multiroom property response exampleMultiroom property response with withheld tax
Current exampleResponse without withheld tax

OTA response examples

Following is a summary of OTA response examples covered in this section:

OTA response with Payments Clarity Package (vcc_payment_v2)OTA response with Payments Clarity Package V2 (payment_clarity_package_v2)
Current exampleResponse with withheld tax
Multiroom property response exampleMultiroom property response with withheld tax
Current exampleResponse without withheld tax

B.XML response with the existing Payments Clarity Package

For the example responses in this section, the following price configurations are set up for the property:

  • The price of the room is $10.
  • The price excludes:
    • Withheld tax of 2.00%
    • Withheld tax of 5.00%
    • Withheld tax of 1.50%
    • City tax of 5.50%

Also, either the Payments Clarity Package (vcc_payment_v2), or the Include Price Details (include_price_details) feature is turned on.

Expand this section to view the B.XML response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<reservations>  
    <reservation>  
        <commissionamount>0</commissionamount>  
        <currencycode>USD</currencycode>  
        <customer>  
            <address>********</address>  
            <cc_activation_date>********</cc_activation_date>  
            <cc_current_balance>11.45</cc_current_balance>  
            <cc_cvc>********</cc_cvc>  
            <cc_expiration_date>********</cc_expiration_date>  
            <cc_name>********</cc_name>  
            <cc_number>****************</cc_number>  
            <cc_type>MasterCard (virtual credit card)</cc_type>  
            <city></city>  
            <company></company>  
            <countrycode>NL</countrycode>  
            <currencycode>USD</currencycode>  
            <dc_issue_number></dc_issue_number>  
            <dc_start_date></dc_start_date>  
            <email>dennis@guest.booking.com</email>  
            <first_name>Dennis</first_name>  
            <last_name>Stanford</last_name>  
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-04-24.  
</remarks>  
            <telephone>+31 6 14901111</telephone>  
            <vcc_expiration_date>2025-04-01</vcc_expiration_date>  
            <zip></zip>  
        </customer>  
        <date>2024-04-05</date>  
        <hotel_id>11783895</hotel_id>  
        <hotel_name>PCP Property</hotel_name>  
        <id>4310937700</id>  
        <reservation_extra_info>  
            <flags>  
                <flag name="booker_is_genius" />  
            </flags>  
            <payer>  
                <payments>  
                    <payment amount="11.45"  
                   currency="USD"  
                   payment_type="payment_on_Booking.com"  
                   payout_type="Virtual credit card" />  
                </payments>  
            </payer>  
        </reservation_extra_info>  
        <room>  
            <arrival_date>2024-04-24</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-04-25</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Dennis Stanford</guest_name>  
            <id>1178389503</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 14:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 14:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>2</numberofguests>  
            <price date="2024-04-24"  
             genius_rate="no"  
             rate_id="43584505"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>11.45</total>  
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>10</total>  
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4817804923</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <status>new</status>  
        <time>16:05:59</time>  
        <totalprice>10</totalprice>  
    </reservation>  
</reservations>                

B.XML response with the new Payments Clarity Package V2

For the following example, the new Payments Clarity Package V2 (payment_clarity_package_v2) is enabled.

Expand this section to view the B.XML response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
The example shows multiple withheld tax components

The following example shows multiple withheld tax components. The number of withheld tax components depends on the local tax regulations and may vary for your implementation.

<reservations>  
    <reservation>  
        <commissionamount>0</commissionamount>  
        <currencycode>USD</currencycode>  
        <customer>  
            <address>********</address>  
            <cc_activation_date>********</cc_activation_date>  
            <cc_current_balance>10.55</cc_current_balance>  
            <cc_cvc>********</cc_cvc>  
            <cc_expiration_date>********</cc_expiration_date>  
            <cc_name>********</cc_name>  
            <cc_number>****************</cc_number>  
            <cc_type>MasterCard (virtual credit card)</cc_type>  
            <city></city>  
            <company></company>  
            <countrycode>NL</countrycode>  
            <currencycode>USD</currencycode>  
            <dc_issue_number></dc_issue_number>  
            <dc_start_date></dc_start_date>  
            <email>dennis@guest.booking.com</email>  
            <first_name>Dennis</first_name>  
            <last_name>Stanford</last_name>  
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-04-24.  
</remarks>  
            <telephone>+31 6 14901111</telephone>  
            <vcc_expiration_date>2025-04-01</vcc_expiration_date>  
            <zip></zip>  
        </customer>  
        <date>2024-04-05</date>  
        <hotel_id>11783895</hotel_id>  
        <hotel_name>PCP Property</hotel_name>  
        <id>4310937700</id>  
        <reservation_extra_info>  
            <flags>  
                <flag name="booker_is_genius" />  
            </flags>  
            <payer>  
                <payments>  
                    <payment amount="10.55"  
                   currency="USD"  
                   payment_type="payment_on_Booking.com"  
                   payout_type="Virtual credit card" />  
                </payments>  
            </payer>  
        </reservation_extra_info>  
        <room>  
            <arrival_date>2024-04-24</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-04-25</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Dennis Stanford</guest_name>  
            <id>1178389503</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 14:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 14:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>2</numberofguests>  
            <price date="2024-04-24"  
             genius_rate="no"  
             rate_id="43584505"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.16"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="1.50%"  
                          text="Tax (Withheld Tax)" />  
                    <extracomponent amount="0.21"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="2.00%"  
                          text="Tax (Withheld Tax)" />  
                    <extracomponent amount="0.53"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.00%"  
                          text="Tax (Withheld Tax)" />  # Only applicable for properties located in a region where Booking.com is
                                                        # obligated to withhold and remit taxes on behalf of the property.
                                                        # Can contain as many withheld tax components as the local tax
                                                        # regulation stipulates.
                    <total>11.45</total>                # Indicates the amount that Booking.com collected from the guest during booking process
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.16"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="1.50%"  
                          text="Tax (Withheld Tax)" />  
                    <extracomponent amount="0.21"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="2.00%"  
                          text="Tax (Withheld Tax)" />  
                    <extracomponent amount="0.53"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.00%"  
                          text="Tax (Withheld Tax)" /> # Only applicable for properties located in a region where Booking.com is
                                                       # obligated to withhold and remit taxes on behalf of the property.
                                                       # Can contain as many withheld tax components as the local tax
                                                       # regulation stipulates.                                                     
                    <total>10.55</total>               # Indicates the total payout amount to the property                                           
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4817804923</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <status>new</status>  
        <time>16:05:59</time>  
        <totalprice>10</totalprice>  
    </reservation>  
</reservations> 

B.XML response for multiroom property using existing Payments Clarity Package

For the following response examples the following price configurations are set up for the property:

  • The price of the room is $10.
  • The price excludes:
    • Withheld tax of 8.50%
    • City tax of 5.50%

Also, either the Payments Clarity Package (vcc_payment_v2), or the Include Price Details (include_price_details) feature is turned on.

Expand this section to view the B.XML response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<reservations>  
    <reservation>  
        <commissionamount>0</commissionamount>  
        <currencycode>USD</currencycode>  
        <customer>  
            <address>********</address>  
            <cc_activation_date>********</cc_activation_date>  
            <cc_current_balance>22.90</cc_current_balance>  
            <cc_cvc>********</cc_cvc>  
            <cc_expiration_date>********</cc_expiration_date>  
            <cc_name>Bookingcom Agent</cc_name>  
            <cc_number>****************</cc_number>  
            <cc_type>MasterCard (virtual credit card)</cc_type>  
            <city></city>  
            <company></company>  
            <countrycode>NL</countrycode>  
            <currencycode>USD</currencycode>  
            <dc_issue_number></dc_issue_number>  
            <dc_start_date></dc_start_date>  
            <email>lucy@guest.booking.com</email>  
            <first_name>Lucy</first_name>  
            <last_name>Taylor</last_name>  
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-30.  
</remarks>  
            <telephone>+31 6 14901111</telephone>  
            <vcc_expiration_date>2025-03-01</vcc_expiration_date>  
            <zip></zip>  
        </customer>  
        <date>2024-03-28</date>  
        <hotel_id>11761142</hotel_id>  
        <hotel_name>PCP Property</hotel_name>  
        <id>4787168583</id>  
        <reservation_extra_info>  
            <flags>  
                <flag name="booker_is_genius" />  
            </flags>  
            <payer>  
                <payments>  
                    <payment amount="22.90"  
                   currency="USD"  
                   payment_type="payment_on_Booking.com"  
                   payout_type="Virtual credit card" />  
                </payments>  
            </payer>  
        </reservation_extra_info>  
        <room>  
            <arrival_date>2024-03-30</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-03-31</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Lucy Taylor</guest_name>  
            <id>1176114203</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>1</numberofguests>  
            <price date="2024-03-30"  
             genius_rate="no"  
             rate_id="43470373"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>11.45</total>  
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>10</total>  
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4803678746</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <room>  
            <arrival_date>2024-03-30</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-03-31</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Lucy Taylor</guest_name>  
            <id>1176114203</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>1</numberofguests>  
            <price date="2024-03-30"  
             genius_rate="no"  
             rate_id="43470373"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>11.45</total>  
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.5%"  
                          text="Tax" />  
                    <total>10</total>  
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4803678762</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <status>new</status>  
        <time>15:24:22</time>  
        <totalprice>20</totalprice>  
    </reservation>  
</reservations>

B.XML response for multiroom property with the new PCP 2.0

Expand this section to view the B.XML response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
<reservations>  
    <reservation>  
        <commissionamount>0</commissionamount>  
        <currencycode>USD</currencycode>  
        <customer>  
            <address>********</address>  
            <cc_activation_date>********</cc_activation_date>  
            <cc_current_balance>21.10</cc_current_balance>  
            <cc_cvc>********</cc_cvc>  
            <cc_expiration_date>********</cc_expiration_date>  
            <cc_name>Bookingcom Agent</cc_name>  
            <cc_number>****************</cc_number>  
            <cc_type>MasterCard (virtual credit card)</cc_type>  
            <city>********</city>  
            <company>********</company>  
            <countrycode>NL</countrycode>  
            <currencycode>USD</currencycode>  
            <dc_issue_number></dc_issue_number>  
            <dc_start_date></dc_start_date>  
            <email>lucy@guest.booking.com</email>  
            <first_name>Lucy</first_name>  
            <last_name>Taylor</last_name>  
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-30.  
</remarks>  
            <telephone>+31 6 14901111</telephone>  
            <vcc_expiration_date>2025-03-01</vcc_expiration_date>  
            <zip></zip>  
        </customer>  
        <date>2024-03-28</date>  
        <hotel_id>11761142</hotel_id>  
        <hotel_name>PCP Property</hotel_name>  
        <id>4787168583</id>  
        <reservation_extra_info>  
            <flags>  
                <flag name="booker_is_genius" />  
            </flags>  
            <payer>  
                <payments>  
                    <payment amount="21.10"  
                   currency="USD"  
                   payment_type="payment_on_Booking.com"  
                   payout_type="Virtual credit card" />  
                </payments>  
            </payer>  
        </reservation_extra_info>  
        <room>  
            <arrival_date>2024-03-30</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-03-31</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Lucy Taylor</guest_name>  
            <id>1176114203</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>1</numberofguests>  
            <price date="2024-03-30"  
             genius_rate="no"  
             rate_id="43470373"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.50%"  
                          text="Tax (Withheld Tax)" />  # Only applicable for properties located in a region where Booking.com is
                                                        # obligated to withhold and remit taxes on behalf of the property.
                                                        # Can contain as many withheld tax components as the local tax
                                                        # regulation stipulates.
                    <total>11.45</total>                # Indicates the amount that Booking.com collected from the guest during booking process
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.50%"  
                          text="Tax (Withheld Tax)" />  # Only applicable for properties located in a region where Booking.com is
                                                        # obligated to withhold and remit taxes on behalf of the property.
                                                        # Can contain as many withheld tax components as the local tax
                                                        # regulation stipulates.
                    <total>10.55</total>                # Indicates the total payout amount to the property
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4803678746</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <room>  
            <arrival_date>2024-03-30</arrival_date>  
            <commissionamount>0</commissionamount>  
            <currencycode>USD</currencycode>  
            <departure_date>2024-03-31</departure_date>  
            <extra_info></extra_info>  
            <facilities>Internet facilities, Bath, Air conditioning, Hairdryer, Balcony, Desk, Seating Area, Free toiletries, Microwave, Washing machine, Private bathroom, Flat-screen TV, Electric kettle, Kitchenware, Tumble dryer, Bidet, Children's high chair, Game console – PS4, Cots, Shampoo, Body soap</facilities>  
            <guest_name>Lucy Taylor</guest_name>  
            <id>1176114203</id>  
            <info>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </info>  
            <max_children>1</max_children>  
            <meal_plan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</meal_plan>  
            <name>Double Room</name>  
            <numberofguests>1</numberofguests>  
            <price date="2024-03-30"  
             genius_rate="no"  
             rate_id="43470373"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.50%"  
                          text="Tax (Withheld Tax)" />  # Only applicable for properties located in a region where Booking.com is
                                                        # obligated to withhold and remit taxes on behalf of the property.
                                                        # Can contain as many withheld tax components as the local tax
                                                        # regulation stipulates.
                    <total>11.45</total>                # Indicates the amount that Booking.com collected from the guest during booking process
                </guest>  
                <hotel>  
                    <extracomponent amount="0.55"  
                          currency="USD"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="5.5%"  
                          text="City tax" />  
                    <extracomponent amount="0.90"  
                          currency="USD"  
                          included="no"  
                          per_night="no"  
                          per_person="no"  
                          percentage="8.50%"  
                          text="Tax (Withheld Tax)" />  # Only applicable for properties located in a region where Booking.com is
                                                        # obligated to withhold and remit taxes on behalf of the property.
                                                        # Can contain as many withheld tax components as the local tax
                                                        # regulation stipulates.
                    <total>10.55</total>                # Indicates the total payout amount to the property
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4803678762</roomreservation_id>  
            <smoking>1</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <status>new</status>  
        <time>15:24:22</time>  
        <totalprice>20</totalprice>  
    </reservation>  
</reservations> 

B.XML response using existing PCP feature with no withheld tax component

For the following reservation response examples, the property has the following set up with the existing Payments Clarity Package (vcc_payment_v2) enabled:

  • Room Price is €10 per night
  • VAT of 18.00% is included
  • City tax of 3.50% isn't included
  • Bed linens fee of €5 per stay isn't included
Expand this section to view the B.XML response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<reservations>    
    <reservation>    
        <booked_at>2024-03-25T16:05:26+00:00</booked_at>    
        <commissionamount>0</commissionamount>    
        <currencycode>EUR</currencycode>    
        <customer>    
            <address>********</address>    
            <cc_activation_date>********</cc_activation_date>    
            <cc_current_balance>15.30</cc_current_balance>    
            <cc_cvc>********</cc_cvc>    
            <cc_expiration_date>********</cc_expiration_date>    
            <cc_name>Bookingcom Agent</cc_name>    
            <cc_number>****************</cc_number>    
            <cc_type>MasterCard (virtual credit card)</cc_type>    
            <city>********</city>    
            <company>********</company>    
            <countrycode>GB</countrycode>    
            <currencycode>EUR</currencycode>    
            <dc_issue_number></dc_issue_number>    
            <dc_start_date></dc_start_date>    
            <email>marcus@guest.booking.com</email>    
            <first_name>Marcus</first_name>    
            <last_name>Aurelius</last_name>    
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-28.    
</remarks>    
            <telephone></telephone>    
            <vcc_expiration_date>2025-03-01</vcc_expiration_date>    
            <zip></zip>    
        </customer>    
        <date>2024-03-25</date>    
        <guest_counts>    
            <guest_count count="2"    
                   type="adult" />    
        </guest_counts>    
        <hotel_id>10703075</hotel_id>    
        <hotel_name>Test Hotel</hotel_name>    
        <id>4609387145</id>    
        <modified_at>2024-03-25T16:05:27+00:00</modified_at>    
        <reservation_extra_info>    
            <flags>    
                <flag name="booker_is_genius" />    
            </flags>    
            <payer>    
                <payments>    
                    <payment amount="15.30"    
                   currency="EUR"    
                   payment_type="payment_on_Booking.com"    
                   payout_type="Virtual credit card" />    
                </payments>    
            </payer>    
        </reservation_extra_info>    
        <room>    
            <arrival_date>2024-03-27</arrival_date>    
            <cancel_penalties>    
                <cancel_penalty from="2024-03-25T16:05:26+00:00"    
                        policy_code="38"    
                        until="2024-03-25T23:00:00+00:00">    
                    <amount_percent amount="0"    
                          currency_code="EUR" />    
                </cancel_penalty>    
                <cancel_penalty from="2024-03-25T23:00:00+00:00"    
                        policy_code="38">    
                    <amount_percent amount="10"    
                          currency_code="EUR" />    
                </cancel_penalty>    
            </cancel_penalties>    
            <commissionamount>0</commissionamount>    
            <currencycode>EUR</currencycode>    
            <departure_date>2024-03-28</departure_date>    
            <extra_info></extra_info>    
            <facilities></facilities>    
            <guest_name>Marcus Aurelius</guest_name>    
            <id>1070307502</id>    
            <info>Breakfast costs EUR 14 per person per night.    
Dinner costs EUR 35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. You haven't added any cots. You haven't added any extra beds. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the total price of the reservation within 1 day before arrival.  Cancellation Policy: The guest can cancel free of charge until 1 day before arrival. The guest will be charged the total price of the reservation if they cancel within 1 day before arrival. </info>    
            <max_children>0</max_children>    
            <meal_plan>Breakfast costs EUR 14 per person per night.    
Dinner costs EUR 35 per person per night.</meal_plan>    
            <name>Deluxe Double Room with Mountain View</name>    
            <numberofguests>2</numberofguests>    
            <occupancy>2</occupancy>    
            <price date="2024-03-27"    
             genius_rate="no"    
             rate_id="38452247"    
             rewritten_from_id="0"    
             rewritten_from_name="">10</price>    
            <price_details>    
                <guest>    
                    <extracomponent amount="5"    
                          currency="EUR"    
                          included="yes"    
                          per_night="no"    
                          per_person="no"    
                          percentage="no"    
                          text="Bed linens fee" />    
                    <extracomponent amount="1.53"    
                          currency="EUR"    
                          included="yes"    
                          per_night="no"    
                          per_person="no"    
                          percentage="18%"    
                          text="VAT" />    
                    <extracomponent amount="0.30"    
                          currency="EUR"    
                          included="yes"    
                          per_night="no"    
                          per_person="no"    
                          percentage="3.5%"    
                          text="City tax" />    
                    <total>15.30</total>    
                </guest>    
                <hotel>    
                    <extracomponent amount="5"    
                          currency="EUR"    
                          included="no"    
                          per_night="no"    
                          per_person="no"    
                          percentage="no"    
                          text="Bed linens fee" />    
                    <extracomponent amount="1.53"    
                          currency="EUR"    
                          included="yes"    
                          per_night="no"    
                          per_person="no"    
                          percentage="18%"    
                          text="VAT" />    
                    <extracomponent amount="0.30"    
                          currency="EUR"    
                          included="no"    
                          per_night="no"    
                          per_person="no"    
                          percentage="3.5%"    
                          text="City tax" />    
                    <total>10</total>    
                </hotel>    
            </price_details>    
            <remarks></remarks>    
            <roomreservation_id>4798390515</roomreservation_id>    
            <smoking>0</smoking>    
            <totalprice>10</totalprice>    
        </room>    
        <status>new</status>    
        <time>17:05:26</time>    
        <totalprice>10</totalprice>    
    </reservation>    
</reservations>

B.XML response using the new PCP 2.0 feature with no withheld tax component

For the following response example, the property has the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled:

Expand this section to view the B.XML response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
<reservations>  
    <reservation>  
        <booked_at>2024-03-25T16:05:26+00:00</booked_at>  
        <commissionamount>0</commissionamount>  
        <currencycode>EUR</currencycode>  
        <customer>  
            <address></address>  
            <cc_activation_date>**********</cc_activation_date>  
            <cc_current_balance>15.30</cc_current_balance>  
            <cc_cvc>********</cc_cvc>  
            <cc_expiration_date>*******</cc_expiration_date>  
            <cc_name>Bookingcom Agent</cc_name>  
            <cc_number>****************</cc_number>  
            <cc_type>MasterCard (virtual credit card)</cc_type>  
            <city></city>  
            <company></company>  
            <countrycode>GB</countrycode>  
            <currencycode>EUR</currencycode>  
            <dc_issue_number></dc_issue_number>  
            <dc_start_date></dc_start_date>  
            <email>marcus@guest.booking.com</email>  
            <first_name>Marcus</first_name>  
            <last_name>Aurelius</last_name>  
            <remarks>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-28.  
</remarks>  
            <telephone></telephone>  
            <vcc_expiration_date>2025-03-01</vcc_expiration_date>  
            <zip></zip>  
        </customer>  
        <date>2024-03-25</date>  
        <guest_counts>  
            <guest_count count="2"  
                   type="adult" />  
        </guest_counts>  
        <hotel_id>10703075</hotel_id>  
        <hotel_name>Test Hotel</hotel_name>  
        <id>4609387145</id>  
        <modified_at>2024-03-25T16:05:27+00:00</modified_at>  
        <reservation_extra_info>  
            <flags>  
                <flag name="booker_is_genius" />  
            </flags>  
            <payer>  
                <payments>  
                    <payment amount="15.30"  
                   currency="EUR"  
                   payment_type="payment_on_Booking.com"  
                   payout_type="Virtual credit card" />  
                </payments>  
            </payer>  
        </reservation_extra_info>  
        <room>  
            <arrival_date>2024-03-27</arrival_date>  
            <cancel_penalties>  
                <cancel_penalty from="2024-03-25T16:05:26+00:00"  
                        policy_code="38"  
                        until="2024-03-25T23:00:00+00:00">  
                    <amount_percent amount="0"  
                          currency_code="EUR" />  
                </cancel_penalty>  
                <cancel_penalty from="2024-03-25T23:00:00+00:00"  
                        policy_code="38">  
                    <amount_percent amount="10"  
                          currency_code="EUR" />  
                </cancel_penalty>  
            </cancel_penalties>  
            <commissionamount>0</commissionamount>  
            <currencycode>EUR</currencycode>  
            <departure_date>2024-03-28</departure_date>  
            <extra_info></extra_info>  
            <facilities></facilities>  
            <guest_name>Marcus Aurelius</guest_name>  
            <id>1070307502</id>  
            <info>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. You haven't added any cots. You haven't added any extra beds. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the total price of the reservation within 1 day before arrival.  Cancellation Policy: The guest can cancel free of charge until 1 day before arrival. The guest will be charged the total price of the reservation if they cancel within 1 day before arrival. </info>  
            <max_children>0</max_children>  
            <meal_plan>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night.</meal_plan>  
            <name>Deluxe Double Room with Mountain View</name>  
            <numberofguests>2</numberofguests>  
            <occupancy>2</occupancy>  
            <price date="2024-03-27"  
             genius_rate="no"  
             rate_id="38452247"  
             rewritten_from_id="0"  
             rewritten_from_name="">10</price>  
            <price_details>  
                <guest>  
                    <extracomponent amount="5"  
                          currency="EUR"  
                          included="yes"         # Indicates fees/tax was collected from the guest during booking
                          per_night="no"  
                          per_person="no"  
                          percentage="no"  
                          text="Bed linens fee" />  
                    <extracomponent amount="1.53"  
                          currency="EUR"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="18%"  
                          text="VAT" />  
                    <extracomponent amount="0.30"  
                          currency="EUR"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="3.5%"  
                          text="City tax" />  
                    <total>15.30</total>            # Indicates the amount Booking.com collected from the guest during booking process
                </guest>  
                <hotel>  
                    <extracomponent amount="5"  
                          currency="EUR"  
                          included="yes"           # Indicates fees/tax is included in the payout to the property
                          per_night="no"  
                          per_person="no"  
                          percentage="no"  
                          text="Bed linens fee" />  
                    <extracomponent amount="1.53"  
                          currency="EUR"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="18%"  
                          text="VAT" />  
                    <extracomponent amount="0.30"  
                          currency="EUR"  
                          included="yes"  
                          per_night="no"  
                          per_person="no"  
                          percentage="3.5%"  
                          text="City tax" />  
                    <total>15.30</total>                # Indicates the total payout amount to the property
                </hotel>  
            </price_details>  
            <remarks></remarks>  
            <roomreservation_id>4798390515</roomreservation_id>  
            <smoking>0</smoking>  
            <totalprice>10</totalprice>  
        </room>  
        <status>new</status>  
        <time>17:05:26</time>  
        <totalprice>10</totalprice>  
    </reservation>  
</reservations> 

OTA response with the existing Payments Clarity Package

For the response examples in this section the following price configurations are set up for the property:

  • The price of the room is $10.
  • The price excludes:
    • Withheld tax of 2.00%
    • Withheld tax of 5.00%
    • Withheld tax of 1.50%
    • City tax of 5.50%

Also, either the Payments Clarity Package (vcc_payment_v2), or the Include Price Details (include_price_details) feature is turned on.

Expand this section to view the OTA response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-04-02T13:45:03+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="127">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1178389503">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-04-05" RatePlanCode="43584505">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 14:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 14:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="2"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2">  
                        <Taxes Amount="145" CurrencyCode="USD" DecimalPlaces="2">  
                            <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>City tax (5.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                            <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>Tax (8.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                        </Taxes>  
                    </Total>  
                    <BasicPropertyInfo HotelCode="11783895"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="1"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
                </RoomStay>  
            </RoomStays>  
            <ResGuests>  
                <ResGuest ResGuestRPH="1">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Dennis Stanford</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
            </ResGuests>  
            <TPA_Extensions>  
                <flags>  
                    <flag name="booker_is_genius"/>  
                </flags>  
            </TPA_Extensions>  
            <ResGlobalInfo>  
                <Comments>  
                    <Comment ParagraphNumber="1">  
                        <Text>You have received a virtual credit card for this reservation.You may charge it as of 2024-04-05.</Text>  
                    </Comment>  
                </Comments>  
                <Guarantee>  
                    <GuaranteesAccepted>  
                        <GuaranteeAccepted>  
                            <PaymentCard CardCode="MC" CardNumber="****************" SeriesCode="**********" ExpireDate="**********" EffectiveDate="**********" CurrentBalance="1145" DecimalPlaces="2" CurrencyCode="USD" VCCExpirationDate="**********">  
                                <CardHolderName>Bookingcom Agent</CardHolderName>  
                            </PaymentCard>  
                        </GuaranteeAccepted>  
                    </GuaranteesAccepted>  
                </Guarantee>  
                <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                <HotelReservationIDs>  
                    <HotelReservationID ResID_Value="4668177005" ResID_Date="2024-04-02T13:44:01"/>  
                </HotelReservationIDs>  
                <Profiles>  
                    <ProfileInfo>  
                        <Profile>  
                            <Customer>  
                                <PersonName>  
                                    <GivenName>Dennis</GivenName>  
                                    <Surname>Stanford</Surname>  
                                </PersonName>  
                                <Telephone PhoneNumber="+31 6 14901111"/>  
                                <Email>dennis@guest.booking.com</Email>  
                                <Address>  
                                    <AddressLine/>  
                                    <CityName/>  
                                    <PostalCode/>  
                                    <CountryName Code="NL"/>  
                                    <CompanyName/>  
                                </Address>  
                            </Customer>  
                        </Profile>  
                    </ProfileInfo>  
                </Profiles>  
                <DepositPayments>  
                    <GuaranteePayment GuaranteeType="PrePay">  
                        <Description>  
                            <Text>payment_on_Booking.com (Payout type: Virtual credit card)</Text>  
                        </Description>  
                        <AmountPercent Amount="1145" Currency="USD" DecimalPlaces="2"/>  
                    </GuaranteePayment>  
                </DepositPayments>  
            </ResGlobalInfo>  
        </HotelReservation>  
    </HotelReservations>  
</OTA_HotelResNotifRQ>            

OTA response with the new Payments Clarity Package V2

For the following example, the Payments Clarity Package V2 (payment_clarity_package_v2) is enabled.

Expand this section to view the OTA response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
The example shows multiple withheld tax components

The following example shows multiple withheld tax components. The number of withheld tax components depends on the local tax regulations and may vary for your implementation.

Note that the change in the response lines are marked as follows:

----------------------------Start of change------------------------------------------
----------------------------End of change------------------------------------------

<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-04-02T13:49:17+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="127">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1178389503">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-04-05" RatePlanCode="43584505">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 14:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 14:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="2"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                    <BasicPropertyInfo HotelCode="11783895"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="1"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
----------------------Start of change------------------------------------------                      
                    <PriceDetails>  
                        <GuestView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="21" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (2.00%)</Text>   # Only applicable for properties located in a region where Booking.com is  
                                                                                  # obligated to withhold and remit taxes on behalf of the property.
                                                                                  # Can contain as many withheld tax components as the local tax 
                                                                                  # regulation stipulates.
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="53" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (5.00%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="16" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (1.50%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1144675" DecimalPlaces="5"/>      # Indicates the amount that Booking.com collected from the guest during booking process      
                        </GuestView>  
                        <HotelView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="21" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (2.00%)</Text>  # Only applicable for properties located in a region where Booking.com is  
                                                                                 # obligated to withhold and remit taxes on behalf of the property.
                                                                                 # Can contain as many withheld tax components as the local tax 
                                                                                 # regulation stipulates.
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="53" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (5.00%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="16" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (1.50%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1055" DecimalPlaces="2"/>           # Indicates the total payout amount to the property
                        </HotelView>  
                    </PriceDetails>  
----------------------End of change------------------------------------------                    
                </RoomStay>  
            </RoomStays>  
            <ResGuests>  
                <ResGuest ResGuestRPH="1">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Dennis Stanford</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
            </ResGuests>  
            <TPA_Extensions>  
                <flags>  
                    <flag name="booker_is_genius"/>  
                </flags>  
            </TPA_Extensions>  
            <ResGlobalInfo>  
                <Comments>  
                    <Comment ParagraphNumber="1">  
                        <Text>You have received a virtual credit card for this reservation.You may charge it as of 2024-04-05.</Text>  
                    </Comment>  
                </Comments>  
                <Guarantee>  
                    <GuaranteesAccepted>  
                        <GuaranteeAccepted>  
                            <PaymentCard CardCode="MC" CardNumber="****************" SeriesCode="**********" ExpireDate="**********" EffectiveDate="**********" CurrentBalance="1055" DecimalPlaces="2" CurrencyCode="USD" VCCExpirationDate="**********">  
                                <CardHolderName>Bookingcom Agent</CardHolderName>  
                            </PaymentCard>  
                        </GuaranteeAccepted>  
                    </GuaranteesAccepted>  
                </Guarantee>  
                <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                <HotelReservationIDs>  
                    <HotelReservationID ResID_Value="4668177005" ResID_Date="2024-04-02T13:44:01"/>  
                </HotelReservationIDs>  
                <Profiles>  
                    <ProfileInfo>  
                        <Profile>  
                            <Customer>  
                                <PersonName>  
                                    <GivenName>Dennis</GivenName>  
                                    <Surname>Stanford</Surname>  
                                </PersonName>  
                                <Telephone PhoneNumber="+31 6 14901111"/>  
                                <Email>dennis@guest.booking.com</Email>  
                                <Address>  
                                    <AddressLine/>  
                                    <CityName/>  
                                    <PostalCode/>  
                                    <CountryName Code="NL"/>  
                                    <CompanyName/>  
                                </Address>  
                            </Customer>  
                        </Profile>  
                    </ProfileInfo>  
                </Profiles>  
                <DepositPayments>  
                    <GuaranteePayment GuaranteeType="PrePay">  
                        <Description>  
                            <Text>payment_on_Booking.com (Payout type: Virtual credit card)</Text>  
                        </Description>  
                        <AmountPercent Amount="1055" Currency="USD" DecimalPlaces="2"/>  
                    </GuaranteePayment>  
                </DepositPayments>  
            </ResGlobalInfo>  
        </HotelReservation>  
    </HotelReservations>  
</OTA_HotelResNotifRQ>

OTA response for multiroom property using existing PCP feature with Withheld tax component

For the following reservation response examples, the property has the following setup with the existing Payments Clarity Package (vcc_payment_v2) enabled:

  • The price of the room is $10.
  • The price excludes:
    • Withheld tax of 8.50%
    • City tax of 5.50%
Expand this section to view the B.XML response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-03-28T14:27:46+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="746">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1176114203">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-30" RatePlanCode="43470373">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="1"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2">  
                        <Taxes Amount="145" CurrencyCode="USD" DecimalPlaces="2">  
                            <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>City tax (5.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                            <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>Tax (8.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                        </Taxes>  
                    </Total>  
                    <BasicPropertyInfo HotelCode="11761142"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="1"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
                </RoomStay>  
                <RoomStay IndexNumber="762">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1176114203">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-30" RatePlanCode="43470373">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="1"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2">  
                        <Taxes Amount="145" CurrencyCode="USD" DecimalPlaces="2">  
                            <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>City tax (5.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                            <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>Tax (8.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                        </Taxes>  
                    </Total>  
                    <BasicPropertyInfo HotelCode="11761142"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="2"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
                </RoomStay>  
            </RoomStays>  
            <ResGuests>  
                <ResGuest ResGuestRPH="1">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Taylor</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
                <ResGuest ResGuestRPH="2">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Taylor</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
            </ResGuests>  
            <TPA_Extensions>  
                <flags>  
                    <flag name="booker_is_genius"/>  
                </flags>  
            </TPA_Extensions>  
            <ResGlobalInfo>  
                <Comments>  
                    <Comment ParagraphNumber="1">  
                        <Text>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-30.</Text>  
                    </Comment>  
                </Comments>  
                <Guarantee>  
                    <GuaranteesAccepted>  
                        <GuaranteeAccepted>  
                            <PaymentCard CardCode="MC" CardNumber="****************" SeriesCode="**********" ExpireDate="0325" EffectiveDate="**********" CurrentBalance="2290" DecimalPlaces="2" CurrencyCode="USD" VCCExpirationDate="**********">  
                                <CardHolderName>Bookingcom Agent</CardHolderName>  
                            </PaymentCard>  
                        </GuaranteeAccepted>  
                    </GuaranteesAccepted>  
                </Guarantee>  
                <Total AmountBeforeTax="2000" CurrencyCode="USD" DecimalPlaces="2"/>  
                <HotelReservationIDs>  
                    <HotelReservationID ResID_Value="4787168583" ResID_Date="2024-03-28T14:24:22"/>  
                </HotelReservationIDs>  
                <Profiles>  
                    <ProfileInfo>  
                        <Profile>  
                            <Customer>  
                                <PersonName>  
                                    <GivenName>Lucy</GivenName>  
                                    <Surname>Taylor</Surname>  
                                </PersonName>  
                                <Telephone PhoneNumber="+31 6 14901111"/>  
                                <Email>lucy@guest.booking.com</Email>  
                                <Address>  
                                    <AddressLine/>  
                                    <CityName/>  
                                    <PostalCode/>  
                                    <CountryName Code="NL"/>  
                                    <CompanyName/>  
                                </Address>  
                            </Customer>  
                        </Profile>  
                    </ProfileInfo>  
                </Profiles>  
                <DepositPayments>  
                    <GuaranteePayment GuaranteeType="PrePay">  
                        <Description>  
                            <Text>payment_on_Booking.com (Payout type: Virtual credit card)</Text>  
                        </Description>  
                        <AmountPercent Amount="2000" Currency="USD" DecimalPlaces="2"/>  
                    </GuaranteePayment>  
                </DepositPayments>  
            </ResGlobalInfo>  
        </HotelReservation>  
    </HotelReservations>  
</OTA_HotelResNotifRQ>

OTA response for multiroom property using the new PCP 2.0 feature with withheld tax component

For the following reservation response examples, the property has the following setup with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled:

  • The price of the room is $10.
  • The price excludes:
    • Withheld tax of 8.50%
    • City tax of 5.50%
Expand this section to view the OTA response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-03-28T14:28:12+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="746">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1176114203">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-30" RatePlanCode="43470373">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="1"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                    <BasicPropertyInfo HotelCode="11761142"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="1"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
                    <PriceDetails>  
                        <GuestView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">   
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (8.50%)</Text>       # Only applicable for properties located in a region where Booking.com is
                                                                                      # obligated to withhold and remit taxes on behalf of the property.
                                                                                      # Can contain as many withheld tax components as the local tax
                                                                                      # regulation stipulates.   
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1144675" DecimalPlaces="5"/>              # Indicates the amount Booking.com collected from the guest during booking process
                        </GuestView>  
                        <HotelView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (8.50%)</Text>     # Only applicable for properties located in a region where Booking.com is
                                                                                    # obligated to withhold and remit taxes on behalf of the property.
                                                                                    # Can contain as many withheld tax components as the local tax
                                                                                    # regulation stipulates. 
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1055" DecimalPlaces="2"/>            # Indicates the total payout amount to the property
                        </HotelView>  
                    </PriceDetails>  
                </RoomStay>  
                <RoomStay IndexNumber="762">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1176114203">  
                            <RoomDescription Name="Double Room - General">  
                                <Text/>  
                                <MealPlan>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night.</MealPlan>  
                                <MaxChildren>1</MaxChildren>  
                            </RoomDescription>  
                            <Amenities>  
                                <Amenity>Internet facilities</Amenity>  
                                <Amenity>Private bathroom</Amenity>  
                                <Amenity>Flat-screen TV</Amenity>  
                                <Amenity>Electric kettle</Amenity>  
                                <Amenity>Kitchenware</Amenity>  
                                <Amenity>Tumble dryer</Amenity>  
                                <Amenity>Bidet</Amenity>  
                                <Amenity>Children's high chair</Amenity>  
                                <Amenity>Game console – PS4</Amenity>  
                                <Amenity>Cots</Amenity>  
                                <Amenity>Shampoo</Amenity>  
                                <Amenity>Bath</Amenity>  
                                <Amenity>Body soap</Amenity>  
                                <Amenity>Air conditioning</Amenity>  
                                <Amenity>Hairdryer</Amenity>  
                                <Amenity>Balcony</Amenity>  
                                <Amenity>Desk</Amenity>  
                                <Amenity>Seating Area</Amenity>  
                                <Amenity>Free toiletries</Amenity>  
                                <Amenity>Microwave</Amenity>  
                                <Amenity>Washing machine</Amenity>  
                            </Amenities>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="USD"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-30" RatePlanCode="43470373">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs US$14 per person per night.  
Dinner costs US$35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. 1 child (up to and including 3 years old) stays for US$25 per child per stay when using available cots.	 1 person (4 years old and over) stays for US$60 per child per night when using available extra beds.	 The maximum number of extra beds is 1. The maximum number of cots is 1. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the cost of the first night after reservation.  Cancellation Policy: The guest can cancel free of charge until 18:00 on the day of arrival. The guest will be charged the cost of the first night if they cancel after 18:00 on the day of arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="1"/>  
                    </GuestCounts>  
                    <Total AmountBeforeTax="1000" CurrencyCode="USD" DecimalPlaces="2"/>  
                    <BasicPropertyInfo HotelCode="11761142"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="2"/>  
                    </ResGuestRPHs>  
                    <SpecialRequests>  
                        <SpecialRequest Name="smoking preference">  
                            <Text>Smoking</Text>  
                        </SpecialRequest>  
                    </SpecialRequests>  
                    <PriceDetails>  
                        <GuestView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (8.50%)</Text>   # Only applicable for properties located in a region where Booking.com is
                                                                                  # obligated to withhold and remit taxes on behalf of the property.
                                                                                  # Can contain as many withheld tax components as the local tax
                                                                                  # regulation stipulates. 
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1144675" DecimalPlaces="5"/>          # Indicates the amount Booking.com collected from the guest during booking process
                        </GuestView>  
                        <HotelView>  
                            <Taxes>  
                                <Tax Amount="55" ChargeFrequency="12" Code="3" CurrencyCode="USD" DecimalPlaces="2" Type="Inclusive">  
                                    <TaxDescription>  
                                        <Text>City tax (5.5%)</Text>  
                                    </TaxDescription>  
                                </Tax>  
                                <Tax Amount="90" ChargeFrequency="12" Code="17" CurrencyCode="USD" DecimalPlaces="2" Type="Exclusive">  
                                    <TaxDescription>  
                                        <Text>Tax (Withheld Tax) (8.50%)</Text>     # Only applicable for properties located in a region where Booking.com is
                                                                                    # obligated to withhold and remit taxes on behalf of the property.
                                                                                    # Can contain as many withheld tax components as the local tax
                                                                                    # regulation stipulates. 
                                    </TaxDescription>  
                                </Tax>  
                            </Taxes>  
                            <Total Amount="1055" DecimalPlaces="2"/>            # Indicates the total payout amount to the property
                        </HotelView>  
                    </PriceDetails>  
                </RoomStay>  
            </RoomStays>  
            <ResGuests>  
                <ResGuest ResGuestRPH="1">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Taylor</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
                <ResGuest ResGuestRPH="2">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <Surname>Taylor</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
            </ResGuests>  
            <TPA_Extensions>  
                <flags>  
                    <flag name="booker_is_genius"/>  
                </flags>  
            </TPA_Extensions>  
            <ResGlobalInfo>  
                <Comments>  
                    <Comment ParagraphNumber="1">  
                        <Text>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-30.</Text>  
                    </Comment>  
                </Comments>  
                <Guarantee>  
                    <GuaranteesAccepted>  
                        <GuaranteeAccepted>  
                            <PaymentCard CardCode="MC" CardNumber="****************" SeriesCode="**********" ExpireDate="**********" EffectiveDate="**********" CurrentBalance="2110" DecimalPlaces="2" CurrencyCode="USD" VCCExpirationDate="**********">  
                                <CardHolderName>Bookingcom Agent</CardHolderName>  
                            </PaymentCard>  
                        </GuaranteeAccepted>  
                    </GuaranteesAccepted>  
                </Guarantee>  
                <Total AmountBeforeTax="2000" CurrencyCode="USD" DecimalPlaces="2"/>  
                <HotelReservationIDs>  
                    <HotelReservationID ResID_Value="4787168583" ResID_Date="2024-03-28T14:24:22"/>  
                </HotelReservationIDs>  
                <Profiles>  
                    <ProfileInfo>  
                        <Profile>  
                            <Customer>  
                                <PersonName>  
                                    <GivenName>Lucy</GivenName>  
                                    <Surname>Taylor</Surname>  
                                </PersonName>  
                                <Telephone PhoneNumber="+31 6 14901111"/>  
                                <Email>lucy@guest.booking.com</Email>  
                                <Address>  
                                    <AddressLine/>  
                                    <CityName/>  
                                    <PostalCode/>  
                                    <CountryName Code="NL"/>  
                                    <CompanyName/>  
                                </Address>  
                            </Customer>  
                        </Profile>  
                    </ProfileInfo>  
                </Profiles>  
                <DepositPayments>  
                    <GuaranteePayment GuaranteeType="PrePay">  
                        <Description>  
                            <Text>payment_on_Booking.com (Payout type: Virtual credit card)</Text>  
                        </Description>  
                        <AmountPercent Amount="2110" Currency="USD" DecimalPlaces="2"/>  
                    </GuaranteePayment>  
                </DepositPayments>  
            </ResGlobalInfo>  
        </HotelReservation>  
    </HotelReservations>  
</OTA_HotelResNotifRQ>

OTA response using existing PCP feature with no withheld tax component

For the following reservation response examples, the property has the following setup with the existing Payments Clarity Package (vcc_payment_v2) enabled:

  • Room Price is €10 per night
  • VAT of 18.00% is included
  • City tax of 3.50% isn't included
  • Bed linens fee of €5 per stay isn't included
Expand this section to view the OTA response example with the existing Payments Clarity Package (vcc_payment_v2) enabled.
<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-03-25T16:07:38+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="515">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1070307502">  
                            <RoomDescription Name="Deluxe Double Room with Mountain View - Flexible - 24 hours">  
                                <Text/>  
                                <MealPlan>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night.</MealPlan>  
                                <MaxChildren>0</MaxChildren>  
                            </RoomDescription>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="EUR"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-27" RatePlanCode="38452247">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountAfterTax="1000" CurrencyCode="EUR" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. You haven't added any cots. You haven't added any extra beds. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the total price of the reservation within 1 day before arrival.  Cancellation Policy: The guest can cancel free of charge until 1 day before arrival. The guest will be charged the total price of the reservation if they cancel within 1 day before arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="2"/>  
                    </GuestCounts>  
                    <CancelPenalties>  
                        <CancelPenalty PolicyCode="38" From="2024-03-25T16:05:26+00:00" Until="2024-03-25T23:00:00+00:00">  
                            <AmountPercent Amount="0" DecimalPlaces="2" CurrencyCode="EUR"/>  
                        </CancelPenalty>  
                        <CancelPenalty PolicyCode="38" From="2024-03-25T23:00:00+00:00">  
                            <AmountPercent Amount="1000" DecimalPlaces="2" CurrencyCode="EUR"/>  
                        </CancelPenalty>  
                    </CancelPenalties>  
                    <Total AmountAfterTax="1000" CurrencyCode="EUR" DecimalPlaces="2">  
                        <Taxes Amount="683" CurrencyCode="EUR" DecimalPlaces="2">  
                            <Tax Amount="500" ChargeFrequency="12" Code="14" CurrencyCode="EUR" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>Bed linens fee</Text>  
                                </TaxDescription>  
                            </Tax>  
                            <Tax Amount="153" ChargeFrequency="12" Code="19" CurrencyCode="EUR" DecimalPlaces="2" Type="Inclusive">  
                                <TaxDescription>  
                                    <Text>VAT (18%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                            <Tax Amount="30" ChargeFrequency="12" Code="3" CurrencyCode="EUR" DecimalPlaces="2" Type="Exclusive">  
                                <TaxDescription>  
                                    <Text>City tax (3.5%)</Text>  
                                </TaxDescription>  
                            </Tax>  
                        </Taxes>  
                    </Total>  
                    <BasicPropertyInfo HotelCode="10703075"/>  
                    <ResGuestRPHs>  
                        <ResGuestRPH RPH="1"/>  
                    </ResGuestRPHs>  
                    <TPA_Extensions>  
                        <Occupancy>2</Occupancy>  
                    </TPA_Extensions>  
                </RoomStay>  
            </RoomStays>  
            <ResGuests>  
                <ResGuest ResGuestRPH="1">  
                    <Profiles>  
                        <ProfileInfo>  
                            <Profile>  
                                <Customer>  
                                    <PersonName>  
                                        <GivenName>Matthew</GivenName>  
                                        <Surname>Bradley</Surname>  
                                    </PersonName>  
                                </Customer>  
                            </Profile>  
                        </ProfileInfo>  
                    </Profiles>  
                </ResGuest>  
            </ResGuests>  
            <TPA_Extensions>  
                <flags>  
                    <flag name="booker_is_genius"/>  
                </flags>  
            </TPA_Extensions>  
            <ResGlobalInfo>  
                <Comments>  
                    <Comment ParagraphNumber="1">  
                        <Text>You have received a virtual credit card for this reservation.You may charge it as of 2024-03-28.</Text>  
                    </Comment>  
                </Comments>  
                <Guarantee>  
                    <GuaranteesAccepted>  
                        <GuaranteeAccepted>  
                            <PaymentCard CardCode="MC" CardNumber="****************" SeriesCode="********" ExpireDate="**********" EffectiveDate="**********" CurrentBalance="1530" DecimalPlaces="2" CurrencyCode="EUR" VCCExpirationDate="**********">  
                                <CardHolderName>Bookingcom Agent</CardHolderName>  
                            </PaymentCard>  
                        </GuaranteeAccepted>  
                    </GuaranteesAccepted>  
                </Guarantee>  
                <Total AmountAfterTax="1000" CurrencyCode="EUR" DecimalPlaces="2"/>  
                <HotelReservationIDs>  
                    <HotelReservationID ResID_Value="4609387145" ResID_Date="2024-03-25T16:05:26" ResID_Source="BOOKING.COM" ResID_Type="14" ResID_SourceContext="10703075"/>  
                </HotelReservationIDs>  
                <Profiles>  
                    <ProfileInfo>  
                        <Profile>  
                            <Customer>  
                                <PersonName>  
                                    <GivenName>Matthew</GivenName>  
                                    <Surname>Bradley</Surname>  
                                </PersonName>  
                                <Email>matthew@guest.booking.com</Email>  
                                <Address>  
                                    <AddressLine/>  
                                    <CityName/>  
                                    <PostalCode/>  
                                    <CountryName Code="GB"/>  
                                    <CompanyName/>  
                                </Address>  
                            </Customer>  
                        </Profile>  
                    </ProfileInfo>  
                </Profiles>  
                <GuestCounts>  
                    <GuestCount Count="2" AgeQualifyingCode="10"/>  
                </GuestCounts>  
                <DepositPayments>  
                    <GuaranteePayment GuaranteeType="PrePay">  
                        <Description>  
                            <Text>payment_on_Booking.com (Payout type: Virtual credit card)</Text>  
                        </Description>  
                        <AmountPercent Amount="1530" Currency="EUR" DecimalPlaces="2"/>  
                    </GuaranteePayment>  
                </DepositPayments>  
                <TotalCommissions>  
                    <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="EUR"/>  
                    <Comment>This is the total commission amount calculated by Booking.com</Comment>  
                </TotalCommissions>  
            </ResGlobalInfo>  
        </HotelReservation>  
    </HotelReservations>  
</OTA_HotelResNotifRQ>

OTA response using the new PCP 2.0 feature with no withheld tax component

For the following response example, the property has the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled:

Expand this section to view the OTA response example with the new Payments Clarity Package V2 (payment_clarity_package_v2) enabled.
<?xml version="1.0" encoding="UTF-8"?>  
<OTA_HotelResNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelResNotifRQ.xsd" TimeStamp="2024-03-25T16:10:43+00:00" Target="Production" Version="2.001">  
    <HotelReservations>  
        <HotelReservation>  
            <RoomStays>  
                <RoomStay IndexNumber="515">  
                    <RoomTypes>  
                        <RoomType RoomTypeCode="1070307502">  
                            <RoomDescription Name="Deluxe Double Room with Mountain View - Flexible - 24 hours">  
                                <Text/>  
                                <MealPlan>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night.</MealPlan>  
                                <MaxChildren>0</MaxChildren>  
                            </RoomDescription>  
                        </RoomType>  
                    </RoomTypes>  
                    <RatePlans>  
                        <RatePlan>  
                            <Commission>  
                                <CommissionPayableAmount Amount="0" DecimalPlaces="2" CurrencyCode="EUR"/>  
                            </Commission>  
                        </RatePlan>  
                    </RatePlans>  
                    <RoomRates>  
                        <RoomRate EffectiveDate="2024-03-27" RatePlanCode="38452247">  
                            <Rates>  
                                <Rate>  
                                    <Total AmountAfterTax="1000" CurrencyCode="EUR" DecimalPlaces="2"/>  
                                </Rate>  
                            </Rates>  
                        </RoomRate>  
                        <TPA_Extensions>  
                            <BookingCondition>Breakfast costs EUR 14 per person per night.  
Dinner costs EUR 35 per person per night. Children and Extra Bed Policy: Children of any age are allowed. You haven't added any cots. You haven't added any extra beds. The maximum number of guests is 2.  Deposit Policy: The guest will be charged a prepayment of the total price of the reservation within 1 day before arrival.  Cancellation Policy: The guest can cancel free of charge until 1 day before arrival. The guest will be charged the total price of the reservation if they cancel within 1 day before arrival. </BookingCondition>  
                        </TPA_Extensions>  
                    </RoomRates>  
                    <GuestCounts>  
                        <GuestCount Count="2"/>  
                    </GuestCounts>  
                    <CancelPenalties>  
                        <CancelPenalty PolicyCode="38" From="2024-03-25T16:05:26+00:00" Until="2024-03-25T23:00:00+00:00">  
                            <AmountPercent Amount="0" DecimalPlaces="2" CurrencyCode="EUR"/>  
                        </CancelPenalty>  
                        <CancelPenalty P