Що має підтримувати API бронювання готелів?

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

Чи безкоштовний Wink API?

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% стандартної комісії застосовується, коли бронювання зроблено через ваш продукт — так інтегратор заробляє, а не платить.

Поширені помилки

Робота на кешованих тарифах. Вони виглядають добре під час розробки, але провалюються в продакшені.
Передача оплати через редирект. Кожне перенаправлення втрачає бронювання.
Ігнорування вебхуків до запуску. Звірка стає ручною роботою.
Ставати продавцем у записах без потреби. Це рішення про ліцензування і відповідальність, а не лише технічне.
Не передавати контекст джерела. Атрибуцію неможливо відновити пізніше.

Як розробники додають бронювання готелів до продукту?