Четыре ключевые возможности
Заголовок раздела «Четыре ключевые возможности»| Возможность | Что это значит | Почему продукты без этого не развиваются |
|---|---|---|
| Актуальные тарифы и доступность | Текущие цены и что реально доступно для бронирования по датам | Кэшированные тарифы не проходят подтверждение и подрывают доверие |
| Создание бронирования | Создать реальное бронирование, которое получает отель | Без этого вы — просто реферальная ссылка, а не продукт |
| Оплата | Принять деньги в рамках бронирования | Передача на другой сайт убивает конверсию |
| Подтверждение и вебхуки | Сообщить гостю, отелю и вашей системе, что произошло | Иначе возникают проблемы с нагрузкой и сверкой |
Большинство «отельных API», которые находит разработчик, покрывают первое и иногда второе. Транзакция — самая сложная часть, и именно она определяет, есть ли у вас продукт.
Чей инвентарь вы интегрируете?
Заголовок раздела «Чей инвентарь вы интегрируете?»Этот вопрос определяет всё последующее. Инвентарь, перепродаваемый через цепочку, приходит с наценкой в тарифе, устаревшей доступностью и отсутствием обратной связи с отелем по вопросам бронирования. Инвентарь, поступающий напрямую от отеля, содержит собственный тариф отеля, актуальную доступность и отель, который знает о бронировании.
Для всего, где путешественник будет сравнивать с сайтом самого отеля — а это почти всё — инвентарь под контролем отеля избегает неловкого момента, когда ваша цена хуже.
Кто является мерчантом
Заголовок раздела «Кто является мерчантом»Если вы строите бронирование отелей самостоятельно, становление мерчантом означает принятие на себя ответственности за оплату, возвраты, обработку налогов и часто получение лицензии турагентства в каждом регионе.
В Wink отель остаётся мерчантом, и оплата собирается для отеля, так что интегратор не наследует эту ответственность. Мерчантские схемы доступны для API-интеграций, где партнёр действительно должен принимать оплату самостоятельно, и этот путь требует собственных лицензий.
Три уровня интеграции
Заголовок раздела «Три уровня интеграции»- Веб-компоненты. Вставьте доступный для бронирования поиск, список номеров или оформление заказа на существующую страницу. Без работы на бэкенде; минимальный контроль над оформлением.
- REST API. Полный контроль над поиском, тарифами, созданием бронирования и подтверждением, аутентификация через OAuth2. Используйте, когда поток бронирования — часть опыта вашего продукта.
- MCP сервер. Те же возможности для AI-агентов, чтобы ассистент мог искать, считать цену и завершать бронирование, а не перенаправлять пользователя на сайт.
Эти три варианта не исключают друг друга — продукт часто использует компоненты для маркетинга и API для основного потока.
С чего начать
Заголовок раздела «С чего начать»- Поиск и ценообразование для одного города и одного диапазона дат. Получите реальные тарифы до проектирования.
- Создайте одно тестовое бронирование от начала до конца, включая оплату и подтверждение.
- Подпишитесь на
booking.createи события отмены до создания UI. - Раннее решение по модели атрибуции — контекст источника должен идти с бронированием, иначе отчёты будут догадками.
- Обрабатывайте ошибки: потеря доступности между запросом и бронированием, отказ оплаты, частичные возвраты.
Цены, которые должен знать разработчик
Заголовок раздела «Цены, которые должен знать разработчик»API Consumer и Booking Engine бесплатны. Partner API включает бесплатный месячный лимит 10 000 ночей в отелях, затем тарифицируется за единицу. Подтверждённые бронирования несут платформенный сбор отеля 1,5% плюс стоимость обработки карт, а дефолтная комиссия 10% применяется, когда бронирование сделано через ваш продукт — так интегратор зарабатывает, а не платит.
Бесплатный лимит действует на интегратора. Создание нескольких аккаунтов для обхода — злоупотребление и ведёт к немедленному пожизненному бану. Подробнее см. Partner API usage and limits.
Распространённые ошибки
Заголовок раздела «Распространённые ошибки»- Использование кэшированных тарифов. Они выглядят нормально в разработке, но ломаются в продакшене.
- Передача оплаты через редирект. Каждая передача теряет бронирования.
- Игнорирование вебхуков до запуска. Сверка становится ручной работой.
- Становление мерчантом без необходимости. Это решение лицензирования и ответственности, а не только техническое.
- Не передавать контекст источника. Атрибуцию нельзя восстановить позже.