Czego potrzebuje API do rezerwacji hotelu?

Aktualnych cen i dostępności, tworzenia rezerwacji, płatności oraz potwierdzenia z webhookami. API tylko do odczytu obejmują tylko pierwszą funkcję i nie mogą zakończyć transakcji.

Czy API Wink jest darmowe?

API Consumer i Booking Engine są darmowe. Partner API zawiera 10 000 noclegów hotelowych miesięcznie za darmo, potem nalicza opłaty za jednostkę.

Czy muszę zostać sprzedawcą (merchant of record)?

Nie. Hotel pozostaje sprzedawcą, a płatność jest pobierana dla hotelu. Umowy merchant-of-record są dostępne dla integracji API, które naprawdę muszą same przyjmować płatności, z własnymi wymogami licencyjnymi.

Czy agenci AI mogą rezerwować przez te same funkcje?

Tak. Serwer MCP udostępnia wyszukiwanie, wycenę i rezerwację agentom, aby asystent mógł zakończyć rezerwację zamiast przekierowywać użytkownika na stronę.

Jak otrzymuję zapłatę jako integrator?

Domyślna prowizja 10% obowiązuje na rezerwacje wygenerowane przez twój produkt, liczona po opłacie platformowej hotelu i kosztach przetwarzania kart, z atrybucją trwającą 6 miesięcy od kliknięcia.

Czy muszę budować UI?

Niekoniecznie. Komponenty webowe oferują wyszukiwanie, listy pokoi i checkout z możliwością rezerwacji, które można wstawić na istniejącą stronę; REST API jest dostępne, gdy ścieżka powinna być twoja.

Hotel Booking API — Jak dodać rezerwację hotelu do produktu

Cztery kluczowe funkcje

Funkcja	Co oznacza	Dlaczego produkty bez niej utkną
Aktualne ceny i dostępność	Aktualne ceny i to, co faktycznie można zarezerwować, dla danego zakresu dat	Buforowane ceny zawodzą przy potwierdzeniu i podważają zaufanie
Tworzenie rezerwacji	Utworzenie prawdziwej rezerwacji, którą otrzymuje hotel	Bez tego jesteś tylko linkiem polecającym, a nie produktem
Płatność	Przyjęcie pieniędzy w ramach rezerwacji	Przekierowanie na inną stronę zabija konwersję
Potwierdzenie i webhooki	Powiadomienie gościa, hotelu i systemu o dokonaniu rezerwacji	W przeciwnym razie pojawiają się problemy z obsługą i rozliczeniami

Większość “hotelowych API”, które znajdzie deweloper, obejmuje pierwszą i czasem drugą funkcję. Transakcja to trudna część i to ona decyduje, czy masz produkt.

Czyją ofertę integrujesz?

To pytanie kształtuje wszystko dalej. Oferta odsprzedawana przez łańcuch ma narzut w cenie, mniej aktualną dostępność i brak możliwości kontaktu z hotelem w sprawie rezerwacji. Oferta bezpośrednio od hotelu ma własną cenę hotelu, aktualną dostępność i hotel, który wie o rezerwacji.

We wszystkim, gdzie podróżny porówna ofertę z oficjalną stroną hotelu — czyli w większości przypadków — oferta kontrolowana przez hotel unika niezręcznej sytuacji, gdy twoja cena jest gorsza.

Kto jest sprzedawcą (merchant of record)

Jeśli sam budujesz rezerwacje hotelowe, zostanie sprzedawcą oznacza przejęcie odpowiedzialności za płatności, chargebacki, zwroty, obsługę podatków i często licencję agencyjną w każdym rynku.

Na Wink hotele pozostają sprzedawcami i płatność jest pobierana dla hotelu, więc integrator nie przejmuje tej odpowiedzialności. Umowy merchant-of-record są dostępne przy integracjach API, gdy partner naprawdę musi sam przyjmować płatności, a ta droga wiąże się z własnymi wymogami licencyjnymi.

Trzy poziomy integracji

Komponenty webowe. Wstaw wyszukiwanie, listę pokoi lub checkout z możliwością rezerwacji na istniejącą stronę. Bez pracy backendowej; najmniejsza kontrola nad układem.
REST API. Pełna kontrola nad wyszukiwaniem, cenami, tworzeniem rezerwacji i potwierdzeniem, uwierzytelnianie przez OAuth2. Używaj, gdy ścieżka rezerwacji jest częścią doświadczenia twojego produktu.
Serwer MCP. Te same funkcje udostępnione agentom AI, aby asystent mógł wyszukiwać, wyceniać i finalizować rezerwację zamiast przekierowywać użytkownika na stronę.

Te trzy nie wykluczają się — produkt często używa komponentów do powierzchni marketingowej, a API do głównego procesu.

Co budować najpierw

Wyszukiwanie i wycena dla jednego miasta i jednego zakresu dat. Najpierw uzyskaj prawdziwe ceny.
Utwórz jedną testową rezerwację od początku do końca, włącznie z płatnością i potwierdzeniem.
Zasubskrybuj booking.create i zdarzenia anulowania zanim zbudujesz jakiekolwiek UI.
Wcześnie zdecyduj o modelu atrybucji — kontekst źródła musi podróżować z rezerwacją, inaczej raportowanie to zgadywanka.
Obsłuż przypadki błędów: utrata dostępności między wyceną a rezerwacją, odrzucenie płatności, częściowe zwroty.

Cennik, który deweloper powinien znać

API Consumer i Booking Engine są darmowe. Partner API zawiera darmowy miesięczny limit 10 000 noclegów hotelowych, potem nalicza opłaty za jednostkę. Potwierdzone rezerwacje niosą ze sobą 1,5% opłaty platformowej hotelu plus koszt przetwarzania kart, a domyślna prowizja 10% obowiązuje, gdy to twój produkt wygenerował rezerwację — tak integrator zarabia, a nie płaci.

Częste błędy

Budowanie na bazie buforowanych cen. Wyglądają dobrze w dewelopmencie, zawodzą w produkcji.
Pozostawianie płatności przekierowaniu. Każde przekierowanie traci rezerwacje.
Ignorowanie webhooków do momentu uruchomienia. Rozliczenia stają się pracą ręczną.
Zostanie sprzedawcą bez potrzeby. To decyzja licencyjna i odpowiedzialności, nie tylko techniczna.
Nieprzekazywanie kontekstu źródła. Atrybucji nie da się odtworzyć później.

Jak deweloperzy dodają rezerwację hotelu do produktu?