Skip to main content

[Channel] “Booking.com” channel creation/synchronization specifications

J
Written by Joelly See Toh
Updated this week

Overview

This section describes the procedure for creating a channel from the [Admin Console] → [Channel] → [Add channel] button.

It also outlines the specifications and important notes regarding synchronization with Booking.com.


Details

[Pre-Setup Before Connecting to Booking.com]

Important Notes for Users Currently Using iCal Sync with Booking.com

Once you configure a Site Controller (Channel Manager) on Booking.com, the existing iCal import/export function on the Booking.com side will no longer be available.


Importing Confirmed Reservations Before Connecting to Booking.com

Future reservations that were confirmed before linking AirHost will be imported during the connection process.
Please note:

  • Only future reservations are eligible for import.

  • Past reservations will not be imported.

If there are confirmed reservations made prior to connection that cannot be imported via the Booking.com API, you will need to manually create them as manual reservations in AirHost for management purposes.


Important Notes on Payment Information

For reservations that were confirmed before connecting to Booking.com, AirHost cannot retrieve payment information from Booking.com.

As a result, even if those reservations have already been paid, they will appear as “Unpaid” in AirHost.


Steps to create a channel

As a prerequisite, integration with AirHost must be enabled in the "Connectivity Providers" menu on the Booking.com side. After setting AirHost as your provider, you will be automatically approved by AirHost.

Please make the settings in advance. Login to Booking.com extranet -> click on Account -> Connectivity Provider and change provider to AirHost

Please watch this video for operating instructions:

The Booking.com channel allows multiple properties to be added under a single channel.
If a Booking.com channel has already been created in AirHost, please proceed with adding the next property.

Please enter your email address as the username.
If the input is not in email address format, you will not be able to proceed to the next step.

Watch the video below to learn how to add a new Booking.com channel:

▼ Username – Relevant Field

Add Booking.com properties to the Booking.com channel. A hotel ID is required when adding a property. Please copy from the following location.

Please watch the video below for the steps to add a property:

※ If property information cannot be imported, the Booking.com status may fall under one of the following:

mceclip2.png
__.png

Please change the status below on Booking.com.

mceclip3.png


Notification Emails (e.g., “New Reservation”) After Connecting to Booking.com

Once Booking.com is connected to AirHost, the notification emails that were previously sent directly from Booking.com (such as “New Reservation” emails) will no longer be sent.

This is because AirHost provides its own notification emails instead.
Please review the relevant manuals to configure and confirm your notification settings.


About price synchronization

When synchronizing prices to Booking.com, only the base rate and the number of guests specified as the default on the Booking.com extranet (i.e. the number of guests for which rates can be edited on Booking.com) are synced from AirHost PMS.
For example, if the base rate on Booking.com is set for 2 guests, AirHost PMS will calculate and sync the rate for 2 guests per date to Booking.com.

Rates for guest numbers other than the base number will be adjusted on Booking.com based on the settings under "Rates per Occupancy."
Therefore, any rate multipliers or discounts set in AirHost will only apply to the synced base rate.

Cleaning fees are not synchronized, so please either configure them directly in Booking.com or adjust your pricing in AirHost using rate multipliers.

Additionally, cancellation policies will follow the settings on the Booking.com side, while minimum stay requirements will follow the settings on the AirHost side.

Example of the Pricing Calendar on the Booking.com Extranet:

For this property, the base occupancy is set to 4 guests.


Specifications and Notes Regarding Message Synchronization

From March 15, 2022, Booking.com transitioned to the message API they provide.

As a result, the message specifications have become similar to those of Airbnb.

To send URLs within messages, the domain of the URL must be registered in Booking.com's whitelist.
The relevant domain (for example, for the AirHost pre-check-in URL, www.onestayapp.com) needs to be registered at the property level in the whitelist. This can be configured in Booking.com's extranet.

Note: There is an option to apply the setting to “All properties” to manage and apply it to all your accommodations.

If you have any questions about the settings, please contact Booking.com’s support team.

Below is the settings screen.


Self-Service Requests Not Reflected in AirHost Messages

Self-service requests are predefined requests that guests can submit via Booking.com after their reservation is confirmed.

  • These requests may appear on Booking.com’s message board.

  • However, they will not be reflected in AirHost’s messaging system.

⚠️ As a result, you cannot receive or check these requests in AirHost.


Sending Messages to Booking.com When Using Other Channel Manager or PMS

In the Booking.com portal, under “Security Settings” → “Email Address Settings”, you can specify which sender email addresses are allowed to send emails to Booking.com’s masked email addresses, as a security measure. Any email sent from an unregistered address will not reach the guest.

  • If nothing is set in “Email Address Settings”, all email addresses are allowed.

  • If you register any email addresses, you must also include @client.airhost.co to allow messages sent from AirHost.

For more details, please refer to the help page below:


Important Notes on Message Synchronization for Agoda Reservations

Agoda is part of the Booking Holdings Group and functions as one of Booking.com’s affiliate (partner) sites. Therefore, even if a guest thinks they booked through Agoda, the reservation may actually be processed via Booking.com. Currently, there is no option to disable cross-selling between these platforms.

Reservations where the address appears as:
“30 08 Prudential Tower, 19 Cecil St Bangkok N/A”
are considered affiliate bookings via Agoda.

Messages sent from AirHost are sent via Booking.com's Message API and are reflected on Booking.com's message board, but we have received reports that the messages may not reach the guest. This is a problem with the connection between Booking.com and Agoda, and AirHost cannot fix it.


Regarding Credit Card Information / Security Code (CVC/CVV) Integration

Credit card information for reservations made before connecting with AirHost is not provided by Booking.com and therefore cannot be viewed in AirHost. Additionally, please note that even for reservations made after the connection, there are limits on how many times the card information can be viewed.

For confirmed reservations made after connecting with AirHost, if the card information is integrated but the security code (CVC/CVV) is not, please check in the Booking.com management page under “Payment Reminder Advice” that the option “Remove security code input to increase bookings” is not enabled.

If for confirmed reservations made after the AirHost connection the entire card information such as card number or expiration date is not integrated, please contact your Booking.com representative.

[ Booking.com Help ]


Regarding Cases Where Reservations Are Canceled Immediately After Booking (Within a Few Seconds, etc.)

If a reservation is canceled immediately after booking (within a few seconds), the booking confirmation notification will not be received from the Booking.com API side, and only the cancellation notification will be received by AirHost PMS. Since this cancellation notification does not include details such as the booked room type or check-in/check-out dates, only cancellations with a non-zero cancellation fee will be processed by AirHost PMS as follows:

  • Check-in date: Set to the reservation date

  • Check-out date: Set to the day after the reservation date

  • Room type: Set to the first defined room type of the property (since it is canceled, it does not affect inventory)

  • Reservation name: Guest name (Reservation number) - Cancelled-Right-Away (append “- Cancelled-Right-Away” to the normal reservation name)


Support for Smart Flex Reservations (Risk-Free Bookings)

Conclusion: Using risk-free bookings is difficult with the current system.

How risk-free bookings work:
On Booking.com, if a risk-free booking is canceled, their system increases the availability on Booking.com without notifying the site controller (AirHost PMS), so that the canceled dates can be offered to other guests. This ensures that the “risk-free” guarantee is maintained, and Booking.com may automatically adjust display order or inventory to manage this.

On the AirHost PMS side:

  • AirHost PMS synchronizes availability to other connected OTAs immediately after a confirmed booking.

  • Additionally, it performs a daily full inventory resync to ensure that inventory counts in PMS match the OTAs.

  • However, because Booking.com does not send a cancellation notification for risk-free bookings, AirHost PMS continues to see the canceled date as booked (inventory = 0), which may result in double-booking risks when syncing inventory back to other OTAs.

Even if Booking.com eventually updates availability, AirHost cannot control this process, so full support for risk-free bookings cannot be guaranteed.

We apologize for the inconvenience and will continue discussions with Booking.com to explore possible support solutions.


Regarding Executable Booking.com Command Operations

From the AirHost reservation details page, you can execute several Booking.com commands. Without logging into the Booking.com management page, you can perform the following actions within the “Booking.com Actions” section.


Booking.com Actions

Reference Help

Report No Show

Report Stay Change

Report Invalid Credit Card

Reporting cancellation due to Invalid credit card

Report Guest Misconduct


What is the difference between the "minimum length of stay" on the Booking.com pricing calendar and the "minimum length of stay" on the air host settings?

For details, please refer to the help page below.

Display of Minimum Stay on Booking.com

  • If the minimum stay is set to 1 night, there is no restriction, so it does not appear on the Booking.com calendar.

  • If the minimum stay is set to 2 nights or more, it will be displayed on the calendar.

※ The display rules follow Booking.com’s system specifications.


Promotion Settings

You can create, edit, and delete promotions on Booking.com directly from AirHost.

Steps:

  1. Go to Admin Console ≫ Channels ≫ Select the Booking.com account ≫ Click [Add New Promotion]

  2. Select the property (choose from the list of properties synced from Booking.com), then select the type of promotion (Basic / Last-Minute/ Early Booker / Business Booker/ Geo Rate/ Mobile Rate ), and click [Next Step] to proceed.

  3. Set the promotion details and then click [Next Step] to proceed.

Promotion Name

Text Input

Target Channel

Choose one from public / subscribers / china

  • public: Visible to all guests

  • subscribers: Only visible to guests subscribed to Booking.com newsletters

  • china: Not available due to Booking.com policy (since December 7, 2022)

Minimum stay through

Select from 0–7 nights

Room

Choose from room types created on Booking.com

Rates

Select one or multiple plans created on Booking.com

Discount(%)

Select from 1 to 99

Non Refundable

Switch ON or OFF

Book Date (Start & End)

Select start/end dates from the calendar

Book Time (Start & End)

Select start/end time from 0 to 24

Stay Date (Start & End)

Select start/end dates from the calendar

Active Weekdays

Select one or multiple days (Sunday–Saturday)

Edit/delete a promotion you created

To edit a promotion: Click [・・・][Edit Promotion]

To delete a promotion: Click [・・・][Delete]


Did this answer your question?