Cztery kluczowe funkcje
Dział zatytułowany „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, 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 twojego systemu o zdarzeniu | Inaczej pojawiają się problemy z obciążeniem 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?
Dział zatytułowany „Czyją ofertę integrujesz?”To pytanie kształtuje wszystko dalej. Oferta odsprzedawana przez łańcuch ma w cenie marżę, starszą 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.
Dla wszystkiego, gdzie podróżny porówna z oficjalną stroną hotelu — czyli większości przypadków — oferta kontrolowana przez hotel unika niezręcznej sytuacji, gdy twoja cena jest gorsza.
Kto jest sprzedawcą (merchant of record)
Dział zatytułowany „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
Dział zatytułowany „Trzy poziomy integracji”- Komponenty webowe. Wstaw wyszukiwanie, listę pokoi lub checkout do istniejącej strony. 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ą 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
Dział zatytułowany „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.
- Subskrybuj
booking.createdi zdarzenia anulowania zanim zbudujesz 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ć
Dział zatytułowany „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 rozlicza za jednostkę. Potwierdzone rezerwacje niosą 1,5% opłaty platformowej hotelu plus koszt przetwarzania kart, a 10% domyślnej prowizji obowiązuje, gdy to twój produkt wygenerował rezerwację — tak integrator zarabia, a nie płaci.
Częste błędy
Dział zatytułowany „Częste błędy”- Budowanie na buforowanych cenach. Działają w dewelopmencie, zawodzą w produkcji.
- Pozostawianie płatności przekierowaniu. Każde przekierowanie traci rezerwacje.
- Ignorowanie webhooków do momentu uruchomienia. Rozliczenia stają się ręczną pracą.
- 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.