Что должен поддерживать API бронирования отелей?

Актуальные тарифы и доступность, создание бронирования, оплата и подтверждение с вебхуками. API только для чтения контента покрывают только первый пункт и не могут завершить транзакцию.

API Wink бесплатен?

API Consumer и Booking Engine бесплатны. Partner API включает 10 000 ночей в отелях бесплатно в месяц, затем тарифицируется за единицу.

Могут ли AI-агенты бронировать через те же возможности?

Да. MCP сервер предоставляет поиск, ценообразование и бронирование агентам, чтобы ассистент мог завершить бронирование вместо перенаправления пользователя на сайт.

Как интегратор получает оплату?

Применяется дефолтная комиссия 10% на бронирования, сделанные через ваш продукт, рассчитываемая после платформенного сбора отеля и обработки карт, с атрибуцией, сохраняющейся 6 месяцев с момента клика.

Нужно ли создавать UI?

Не обязательно. Веб-компоненты предоставляют доступный для бронирования поиск, списки номеров и оформление, которые вставляются в существующую страницу; REST API используется, когда поток должен быть вашим.

API бронирования отелей — как добавить бронирование отеля в продукт

Q: Нужно ли становиться мерчантом?

Нет. Отель остаётся мерчантом, и оплата собирается для отеля. Соглашения мерчанта доступны для API-интеграций, где партнёр действительно должен принимать оплату, с собственными требованиями к лицензированию.

Четыре ключевые возможности

Возможность	Что это значит	Почему без этого продукт не развивается
Актуальные тарифы и доступность	Текущие цены и что реально доступно для бронирования по датам	Кэшированные тарифы не проходят подтверждение и подрывают доверие
Создание бронирования	Создание реального бронирования, которое получает отель	Без этого вы — просто реферальная ссылка, а не продукт
Оплата	Приём денег в рамках бронирования	Перенаправление на другой сайт убивает конверсию
Подтверждение и вебхуки	Сообщить гостю, отелю и вашей системе о результате	Иначе возникают проблемы с нагрузкой и сверкой данных

Большинство «отельных API», которые находит разработчик, покрывают первый и иногда второй пункт. Транзакция — самая сложная часть, и именно она определяет, есть ли у вас продукт.

Чей инвентарь вы интегрируете?

Этот вопрос определяет всё, что идёт дальше. Инвентарь, перепроданный через цепочку, приходит с наценкой в тарифе, устаревшей доступностью и отсутствием прямой связи с отелем для вопросов по бронированию. Инвентарь, поступающий напрямую от отеля, содержит собственный тариф отеля, актуальную доступность и отель, который знает о бронировании.

Для всего, где путешественник будет сравнивать с сайтом самого отеля — а это почти всё — инвентарь под контролем отеля избегает неловкого момента, когда ваша цена хуже.

Кто является мерчантом

Если вы строите бронирование отеля самостоятельно, становиться мерчантом значит брать на себя ответственность за оплату, возвраты, обработку налогов и часто лицензию турагентства в каждом регионе.

В Wink отель остаётся мерчантом, и оплата собирается для отеля, так что интегратор не наследует эту ответственность. Соглашения мерчанта доступны для API-интеграций, где партнёр действительно должен принимать оплату, и этот путь требует собственных лицензий.

Три уровня интеграции

Веб-компоненты. Вставьте доступный для бронирования поиск, список номеров или оформление в существующую страницу. Без работы на бэкенде; минимальный контроль над оформлением.
REST API. Полный контроль над поиском, тарифами, созданием бронирования и подтверждением, аутентификация через OAuth2. Используйте, когда поток бронирования — часть опыта вашего продукта.
MCP сервер. Те же возможности для AI-агентов, чтобы ассистент мог искать, считать цену и завершать бронирование, а не перенаправлять пользователя на сайт.

Эти три варианта не исключают друг друга — продукт часто использует компоненты для маркетинга и API для основного потока.

С чего начать

Поиск и ценообразование для одного города и одного диапазона дат. Получите реальные тарифы до проектирования.
Создайте одно тестовое бронирование от начала до конца, включая оплату и подтверждение.
Подпишитесь на booking.created и события отмены до создания UI.
Раннее решение по модели атрибуции — контекст источника должен идти с бронированием, иначе отчёты будут догадками.
Обрабатывайте ошибки: потеря доступности между запросом и бронированием, отказ оплаты, частичные возвраты.

Цены, которые должен знать разработчик

API Consumer и Booking Engine бесплатны. Partner API включает бесплатный месячный лимит 10 000 ночей в отелях, затем тарифицируется за единицу. Подтверждённые бронирования несут платформенный сбор отеля 1,5% плюс стоимость обработки карт, а дефолтная комиссия 10% применяется, когда бронирование сделано через ваш продукт — так интегратор зарабатывает, а не платит.

Распространённые ошибки

Использование кэшированных тарифов. Они выглядят хорошо в разработке, но не работают в продакшене.
Оставлять оплату через редирект. Каждая передача теряет бронирования.
Игнорировать вебхуки до запуска. Сверка становится ручной работой.
Становиться мерчантом без необходимости. Это решение по лицензированию и ответственности, а не только техническое.
Не передавать контекст источника. Атрибуцию нельзя восстановить позже.

Как разработчики добавляют бронирование отеля в продукт?