Přeskočit na obsah
Zdroje

Jak vývojáři přidávají hotelové rezervace do produktu?

Sekce “Jak vývojáři přidávají hotelové rezervace do produktu?”

Vyhledávání a ceny jsou ta snadná polovina. Produkt je užitečný až ve chvíli, kdy dokáže vytvořit skutečnou rezervaci, přijmout platbu a informovat cestovatele i hotel, že k ní došlo.

Mnoho API vrací hotelový obsah. Mnohem méně jich umožňuje dokončit transakci.

Krátká odpověď

Potřebujete čtyři věci: aktuální ceny a dostupnost, vytvoření rezervace, platbu a potvrzení plus webhooks. API pouze pro čtení obsahu končí u prvního. Na Wink jsou Consumer a Booking Engine API zdarma, vytváření rezervací probíhá přes REST s OAuth2, je k dispozici 70 webhook událostí včetně booking.create a platba je vybírána pro hotel — který zůstává obchodníkem záznamu — takže se jím nemusíte stát vy. MCP server zpřístupňuje stejné funkce AI agentům a webové komponenty pokrývají případy, kdy chcete rezervační cestu bez budování UI.

Čtyři klíčové schopnosti

Sekce “Čtyři klíčové schopnosti”
SchopnostCo znamenáProč produkty bez ní stagnují
Aktuální ceny a dostupnostAktuální ceny a co je skutečně rezervovatelné, podle časového obdobíUložené ceny selhávají při potvrzení a snižují důvěru
Vytvoření rezervaceVytvořit skutečnou rezervaci, kterou hotel obdržíBez toho jste jen odkaz, ne produkt
PlatbaPřijmout peníze jako součást rezervacePřesměrování na jiný web zabíjí konverzi
Potvrzení a webhooksInformovat hosta, hotel a váš systém, co se staloJinak vznikají problémy s podporou a vyrovnáním

Většina „hotelových API“, která vývojář najde, pokrývá první a někdy druhou schopnost. Transakce je ta nejtěžší část a rozhoduje, zda máte produkt.

Čí nabídku integrujete?

Sekce “Čí nabídku integrujete?”

Tato otázka ovlivňuje vše, co následuje. Nabídka prodávaná přes řetězec přichází s přirážkou v ceně, méně aktuální dostupností a bez možnosti zpětné komunikace s hotelem ohledně rezervace. Nabídka přímo od hotelu nese hotelovou vlastní cenu, aktuální dostupnost a hotel, který ví o existenci rezervace.

U všeho, kde cestovatel porovnává s webem hotelu — což je většina případů — hotelem řízená nabídka zabraňuje nepříjemnému momentu, kdy je vaše cena horší.

Kdo je obchodníkem záznamu

Sekce “Kdo je obchodníkem záznamu”

Pokud si hotelové rezervace budujete sami, stát se obchodníkem záznamu znamená převzít odpovědnost za platby, reklamace, vrácení peněz, daňové záležitosti a často i cestovní agenturní licenci v každém trhu.

Na Wink hotel zůstává obchodníkem záznamu a platba je vybírána pro hotel, takže integrátor tuto zodpovědnost nepřebírá. Obchodnické uspořádání je dostupné u API integrací, kde partner skutečně potřebuje platbu přijímat sám, a tato cesta nese vlastní licenční požadavky.

  1. Webové komponenty. Vložte rezervovatelný vyhledávač, seznam pokojů nebo pokladnu do existující stránky. Žádná práce na backendu; nejmenší kontrola nad rozložením.
  2. REST API. Plná kontrola nad vyhledáváním, cenami, vytvářením rezervace a potvrzením, autentizace přes OAuth2. Použijte, když je rezervační proces součástí vašeho produktu.
  3. MCP server. Stejné schopnosti zpřístupněné AI agentům, aby asistent mohl vyhledávat, nacenit a dokončit rezervaci místo předání uživatele na web.

Tyto tři nejsou vzájemně vylučující — produkt běžně používá komponenty pro marketingovou plochu a API pro hlavní tok.

  • Vyhledávání a ceny pro jedno město a jedno časové období. Získejte skutečné ceny dřív, než začnete cokoliv navrhovat.
  • Vytvořte jednu testovací rezervaci od začátku do konce, včetně platby a potvrzení.
  • Přihlaste se k odběru booking.create a událostí zrušení dřív, než postavíte jakékoliv UI.
  • Rozhodněte se brzy o modelu atribuce — kontext zdroje musí cestovat s rezervací, jinak je pozdější reportování jen odhad.
  • Zvládněte chybové případy: ztráta dostupnosti mezi nabídkou a rezervací, zamítnutí platby, částečné refundace.

Ceny, které by měl vývojář znát

Sekce “Ceny, které by měl vývojář znát”

Consumer a Booking Engine API jsou zdarma. Partner API zahrnuje měsíční bezplatný limit 10 000 hotelových nocí, poté se účtuje za jednotku. Potvrzené rezervace nesou hotelovou 1,5% platformní provizi plus náklady na zpracování karet a 10% výchozí provize platí, když váš produkt rezervaci zprostředkoval — což je způsob, jak integrátor vydělává, nikoliv platí.

  • Stavět na uložených cenách. Vypadá to dobře při vývoji, ale selhává v produkci.
  • Nechat platbu na přesměrování. Každé předání znamená ztrátu rezervací.
  • Ignorovat webhooks až do spuštění. Vyrovnání se stává manuální prací.
  • Stát se obchodníkem záznamu bez potřeby. Je to rozhodnutí o licenci a odpovědnosti, ne jen technické.
  • Nepředávat kontext zdroje. Atribuce se později nedá rekonstruovat.

Pokračujte v objevování

Často kladené dotazy k hotelovému rezervačnímu API

Co integrovat, kolik to stojí a kdo nese odpovědnost za platbu.

Co musí hotelové rezervační API podporovat?
Aktuální ceny a dostupnost, vytvoření rezervace, platbu a potvrzení s webhooks. API pouze pro čtení obsahu pokrývá jen první a nemůže dokončit transakci.
Je Wink API zdarma?
Consumer a Booking Engine API jsou zdarma. Partner API zahrnuje 10 000 hotelových nocí zdarma měsíčně, poté se účtuje za jednotku.
Musím se stát obchodníkem záznamu?
Ne. Hotel zůstává obchodníkem záznamu a platba je vybírána pro hotel. Obchodnické uspořádání existuje pro API integrace, které skutečně potřebují platbu přijímat, s vlastními licenčními požadavky.
Mohou AI agenti rezervovat stejnými schopnostmi?
Ano. MCP server zpřístupňuje vyhledávání, nacenění a rezervaci agentům, takže asistent může dokončit rezervaci místo předání uživatele na web.
Jak dostanu zaplaceno jako integrátor?
Platí se 10% výchozí provize na rezervace, které váš produkt zprostředkoval, vypočtená po hotelové platformní provizi a nákladech na zpracování karet, s atribucí trvající 6 měsíců od kliknutí.
Musím postavit UI?
Ne nutně. Webové komponenty poskytují rezervovatelný vyhledávač, seznam pokojů a pokladnu, které lze vložit do existující stránky; REST API je tu, když má být tok vaší vlastní zkušeností.

Postavte produkt, který skutečně dokáže rezervovat.

Sekce “Postavte produkt, který skutečně dokáže rezervovat.”

Živá hotelová nabídka, vytváření rezervací přes REST, webhooks, MCP server pro agenty a platba, kterou nemusíte vlastnit.