Built by owners, for owners.

Getting Started

Recommended Reading

Overview

Bookings & Quotes

Properties

Guests

Quotes

My Account

Messaging

Email Template Library

Door Locks

Property Management

Reviews

Listing Site Integration

Widgets

Hosted Websites

Technical Stuff

Privacy & Security

Insurance and Damage Protection

Data Management

QuickBooks Integration

Rates

Rules

SMS Messaging

Security Deposits

Taxes

Payments

Dynamic Pricing Integrations

OwnerRez API

Other Integrations

Channel Management

Page-Specific Help

Testing

Change Log

API Integrations - Booking.com Common Issues & Questions

How do I select which credit cards I accept via the Booking.com API?

Booking.com can display several different option selection screens to different users.  You may see any of these, which give you the ability to select which credit cards you accept.

Whatever selections you make, be sure that the credit card payment processor you've configured in OwnerRez is configured to accept those credit card types!

  • Under the Policies tab of the property, in the "Other Policies" section:

  • Under Guest Payment Options:

Why are my guests seeing so many "Invalid Card" errors?

This is most likely caused because, by default, when Booking.com is passing the guest credit card information to OwnerRez for processing, it does not include the CVV - the three-digit code on the back of the card. Most credit card processors do not allow online transactions to proceed without the CVV, so all charges will be rejected as invalid.

To resolve this problem, you need to contact Booking.com support and make sure that their system is set to require and transmit the CVV. You need to specifically check that this setting is correct for all your properties - we've seen examples where it was correct for one property, and incorrect for another.  It is not possible for you to check these settings yourself - they're internal to the Booking.com system, and are only visible to their support team.

I'm supposed to get guest credit card info but it's not coming through.

If your account is newish (you don't have dozens of booking.com bookings under your belt), you're probably hitting a new policy where they don't send credit card info until just before arrival. Booking.com recently started this new security routine that affects newer accounts and they haven't given out too many details about it.

There are two ways to fix this:

a) Our recommendation is to switch to booking.com payments where they process the money. It's nice to get the card info so secdeps etc. can be scheduled, but if booking.com isn't sending it, it's a lot easier to let them do the processing for the time being. Do that for awhile until they have vetted the account and will send over the card info. Then switch back.

OR

a) Go to the booking.com channel settings in OwnerRez and set it to not require a credit card. That way it won't send the notice. Then later, when they do send the card info, run the card.

I want to discontinue my listing on Booking.com, but I don't want to abandon the bookings I've already received.

Call Booking.com support, and ask them to turn off the property from being bookable, but not to disable the listing entirely.  They are able to do this, and you won't get any more bookings, but you'll still be able to fulfill the bookings you have already received.  Some users have found a setting in the Booking.com UI allowing them to do this themselves.

Do not make any changes to your property or API connection in OwnerRez.

Once your last Booking.com booking has come and gone, then you can cancel your Booking.com listing entirely and disconnect the API connection for that property, or disable the entire API connection if you don't have any active listings still.

There's another way to accomplish the same thing and maybe make some money too - change the settings in your OwnerRez Booking.com API to increase your rates by 300%.  Most likely nobody will pay those super-high rates - but if someone does, hey, what's not to like!

Why did Booking.com automatically refund my guest when they cancelled their booking?

If Booking.com has configured their system to send your guests' credit card information to OwnerRez, so you can do your own payment processing, they also automatically trigger refunds according to their own refund policies.

We're working on an option where you can set it to take the payment automatically but not refund automatically.

In the meantime, you can convert an existing Bookings to manual mode by going to the Channel tab of the Booking and converting to Manual Payments.  This will prevent refunds from being issued automatically.

If you want to do this going forward, you can also go to the settings of the Booking.com API connection and switch that to manual as well.  Doing this will mean you'll have to run the first payment manually, so this is not recommended.

How do I get historical data for my past Booking.com bookings into OwnerRez?

Unfortunately, the Booking.com API connection does not bring in any historical data for past bookings.

What's the difference between a Hotel, a Room, and a Rate?

Booking.com's model is a bit more complex than other channels and there are several ways that the connection can be configured in OwnerRez.

On the booking.com side, you can have one or more Hotels (or Properties), each Hotel can have one or more Rooms, and each Room can have one or more Rates.

On the OwnerRez side during the mapping process, you'll first enter the 7 digit booking.com Hotel Id for each OwnerRez property. Once you enter the Hotel Id, a dropdown will populate with all available Room/Rate combinations in that hotel. You will pick one Room/Rate combination for each OwnerRez property. The room may have other rate plans, but OwnerRez will sync to just one.

Usually you'll have just one rate for any given room. But if you do have other rate plans, like a non-refundable rate for example, the additional plans should be configured in booking.com to be derived with an appropriate discount from the master OwnerRez connected rate plan for each room. That way OwnerRez will sync rates to that one rate plan it is connected to, and then the derived plans in booking.com will update from the master plan.

If you've got multiple properties in OwnerRez, there are two ways they can be set up on booking.com:

  1. One Property with a Room for each individual property. In this case, when mapping in OwnerRez you'll enter the same hotel id for many OwnerRez properties and then select the correct room in the dropdown.
  2. Many Hotels (one for each individual property), each with a single room. In this case, when mapping in OwnerRez each property will have a different hotel id and there will be only one room in the dropdown.

Notes:

  • You can mix and match models 1 and 2 in your account. Maybe you have one hotel in booking.com with 5 rooms that matches to 5 properties in OwnerRez. And then 4 other hotels in booking.com, each with a single room that matches directly to one property in OwnerRez. That's fine -- you can separately map both of those concepts to the correct OwnerRez properties.
  • Each property in OwnerRez can only be mapped once, to one booking.com hotel/room/rate -- multiple mappings from booking.com to the same OwnerRez property are not supported.
  • Booking.com also has an inventory based model where you have a single type of room, say a Queen Bedroom, and an inventory amount that is available, so a single room can be rented multiple times. OwnerRez doesn't support this -- any given room can only be rented once.