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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чьё предложение вы интегрируете?

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

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

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

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

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

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

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

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

Что строить в первую очередь

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

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

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

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

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

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