Channel Manager Setup

The channel manager connects Veridien to online travel agencies (OTAs) so that your availability and rates stay in sync and OTA bookings flow straight into your reservation list. Veridien distributes through a single aggregator, so you connect each OTA once and manage everything from one screen.

The Channel Manager page (under Channel Manager in the sidebar) is laid out as a top-to-bottom setup flow. You work through it in order: link your property, confirm the webhook, connect a channel, then map your rooms and rates. Sections stay locked or hidden until the step before them is complete.

Before you start

You need a few things in place before the connection will work:

• Room types with rooms. A room type can only be mapped once it has at least one room assigned to it. Set these up on the Rooms page first.
• Rate plans. Each room type you want to sell on an OTA needs at least one rate plan. See Rate plans.
• An OTA account. For Booking.com you need an active property on the Booking.com extranet and its Hotel ID. For Airbnb you need a host account you can sign in to.
• A publicly reachable Veridien URL. OTA bookings arrive through a webhook, which the OTA can only reach over the public internet. On a local or test install the webhook section will warn you that a public URL is required.

Step 1: Link your property

The first section is Link Property. It shows your current property's name, address, base currency, and timezone, taken from your property settings.

1. Confirm the details shown are correct. If the currency or timezone is wrong, fix it in Property settings before continuing, because these values are sent to the aggregator.
2. Click Link Property.

Veridien creates a matching property on the aggregator and links it to your Veridien property. Once linked, the section changes to Property Connected with a Linked badge, the aggregator Property ID, and the date it was connected. The rest of the page (channels, mappings, rate adjustments, and monitoring) only appears after this step succeeds.

Step 2: Confirm the webhook

Directly below the linked-property section is the Webhook status row. The webhook is how OTA bookings and sync events reach Veridien in real time.

You normally do not have to do anything here. As soon as your property is linked, Veridien registers the webhook automatically and the row shows an Active badge. If the webhook is missing or pointing at the wrong address, Veridien re-registers it on its own.

Two cases need your attention:

• "Webhook requires a public URL." Your install is running on localhost. OTA bookings will not arrive until Veridien is reachable at a public address. This only affects local or test environments.
• "Webhook setup failed" / "Not configured." Click Configure (or Retry) to register it manually. If it keeps failing, contact your administrator.

Step 3: Connect a channel

The Channels section lists the OTAs you can connect. Currently supported are Booking.com and Airbnb. Connected channels appear at the top with an Active or Pending badge; channels you have not connected yet appear below with a dashed border. Click a channel to open its connection wizard.

Booking.com

Booking.com uses a four-step wizard: Hotel ID → Rooms → Rates → Confirm.

1. Hotel ID. Enter your Booking.com Hotel ID and click Test Connection. Veridien verifies the credentials and loads the rooms and rates configured on the Booking.com side. On success you see a confirmation showing how many rooms were found and the currency. You cannot continue until the test passes.
2. Rooms. Each Booking.com room is listed with its number of rates. Match every Booking.com room to one of your Veridien room types. All rooms must be mapped before you can move on.
3. Rates. For each Booking.com room, match its rates to your Veridien rate plans. Only rate plans belonging to the room type you mapped are offered. Rates tagged Read-only are managed by Booking.com and are optional to map; all other rates must be mapped.
4. Confirm. Review the connection details, room mappings, and rate plan mappings. You can edit the Channel Title and tick Activate immediately. If you leave activation off, the channel is saved as Pending and you can activate it later by editing it. Click Connect to finish.

Airbnb

Airbnb connects through a sign-in (OAuth) flow rather than credentials, so there is no Hotel ID to enter. Follow the on-screen wizard to authorize Veridien with your Airbnb host account and link your listings. Once connected, Airbnb appears in the channel list like any other channel and participates in the same availability and rate sync.

For day-to-day handling of Airbnb reservation requests and alterations, see Managing availability.

Editing or disconnecting a channel

Each connected channel has a pencil icon to re-open its wizard and a trash icon to disconnect it. Disconnecting removes the channel connection but preserves your room type and rate plan mappings, so you can reconnect later without redoing them.

Step 4: Map room types and rate plans

For Booking.com the room and rate mapping is done inside the connection wizard (steps 2 and 3 above). The standalone Map Room Types and Map Rate Plans tables let you review and adjust those mappings afterward, and are also where mapping happens for the aggregator directly:

• Map Room Types. Lists every Veridien room type. For each one, pick the matching channel room type from the dropdown, or choose + Create New to create a fresh room type on the aggregator. A room type with no rooms cannot be mapped (it shows "Add rooms to this type before mapping"). Mapped rows show a green Mapped badge; you can Unmap to release the link or delete the channel room type entirely.
• Map Rate Plans. Lists every rate plan grouped by room type. A rate plan can only be mapped after its room type is mapped. Pick the matching channel rate plan or + Create New. As with room types, you can Unmap or delete.

Step 5: Rate adjustments (optional)

The Rate Adjustments section lets you push a price that differs from your base rate plan without changing the base rate plan itself. This section unlocks once at least one rate plan is mapped.

Click Add Adjustment and choose a Channel, Room Type, Rate Plan, then an adjustment Type (Increase or Decrease), Mode (Percentage or Fixed Amount), and Value. For example, a +10% increase on Booking.com offsets that channel's commission. Adjustments are applied automatically whenever rates are synced; the base rate is used wherever no adjustment exists. Adjustments are grouped by channel and can be edited or removed at any time.

See Managing availability for how adjusted rates and availability are pushed.

How OTA reservations arrive

Once a channel is active and the webhook is healthy, OTA bookings flow in automatically:

1. The guest books on the OTA. The OTA notifies Veridien through the webhook.
2. Veridien imports the booking as a reservation, using your room type and rate plan mappings to decide which room type and rate to apply.
3. Guest details (name, email, phone, occupancy, dates, amount, and any notes) are attached to the reservation.
4. Availability is recalculated and pushed back out so the booked night is no longer sold twice.

The reservation then behaves like any other in Veridien. It appears in your reservation list and on the Front desk dashboard for its arrival date, tagged with the OTA as its booking source (see Booking sources). If the webhook ever misses a booking, Veridien also polls the aggregator for unacknowledged bookings as a fallback, so imports are not lost.

Monitoring after go-live

The top of the Channel Manager page shows two monitoring panels once your property is linked:

• Connection Health reports whether the aggregator is Connected, the time of the Last Sync, and Error and Success counts over the last 24 hours, with a health bar reading Healthy, Degraded, or Issues Detected. If errors appear, it points you to the sync activity log.
• Sync Activity is a paginated log of every sync event (availability pushes, rate pushes, booking imports, modifications, cancellations, full syncs, and webhook events). You can filter by status (Success, Error, Partial) and by event type, and refresh on demand. It auto-refreshes every 30 seconds.

Check these the first day after activating a channel, and place a test booking on the OTA if it supports one, to confirm it imports with the correct room type, rate, dates, and guest details before you rely on the connection.

For ongoing availability work, rate adjustments, and full re-syncs, continue to Managing availability.