A négy fontos képesség
Szekció neve “A négy fontos képesség”| Képesség | Mit jelent | Miért akad el nélküle a termék |
|---|---|---|
| Élő árak és elérhetőség | Aktuális árak és mi foglalható ténylegesen, dátumtartományonként | A gyorsítótárazott árak megerősítéskor hibáznak és aláássák a bizalmat |
| Foglalás létrehozása | Valódi foglalás létrehozása, amit a szálloda megkap | Nélküle csak egy ajánló link vagy, nem termék |
| Fizetés | Pénz fogadása a foglalás részeként | Egy másik oldalra irányításnál elvész a konverzió |
| Megerősítés és webhookok | Tájékoztatás a vendégnek, szállodának és a rendszerednek, hogy mi történt | Egyébként támogatási terhelés és egyeztetési hiányosságok lesznek |
A legtöbb “szállodai API”, amit egy fejlesztő talál, az elsőt, néha a másodikat fedi le. A tranzakció a nehéz rész, és ez dönti el, hogy van-e terméked.
Kinek a kínálatát integrálod?
Szekció neve “Kinek a kínálatát integrálod?”Ez a kérdés alakítja az egész további folyamatot. A láncon keresztül újraértékesített kínálat árrést tartalmaz az árban, elavultabb elérhetőséget, és nincs visszacsatolási út a szállodához foglalási kérdés esetén. A közvetlenül a szállodától származó kínálat a szálloda saját árát, élő elérhetőséget és egy olyan szállodát hordoz, amely tud a foglalásról.
Bármi esetén, amikor az utazó összehasonlítja a szálloda saját weboldalával — ami a legtöbb eset — a szálloda által kontrollált kínálat elkerüli azt a kínos pillanatot, amikor az árad rosszabb.
Ki a kereskedő?
Szekció neve “Ki a kereskedő?”Ha magad építed a szállodai foglalást, a kereskedővé válás azt jelenti, hogy vállalod a fizetési felelősséget, visszatérítéseket, adókezelést és gyakran utazási ügynöki engedélyt minden piacon.
A Wink-nál a szálloda marad a kereskedő, és a fizetés a szálloda számára történik, így az integrátor nem örökli ezt a felelősséget. Kereskedői megállapodások elérhetők API integrációknál, ahol a partnernek valóban szüksége van a fizetés fogadására, és ez az út saját engedélyezési követelményeket von maga után.
Három integrációs szint
Szekció neve “Három integrációs szint”- Webkomponensek. Egy foglalható kereső, szobalisták vagy fizetési folyamat beillesztése egy meglévő oldalba. Nincs backend munka; legkevesebb kontroll a megjelenés felett.
- REST API. Teljes kontroll a keresés, árak, foglalás létrehozása és megerősítés felett, OAuth2 hitelesítéssel. Akkor használd, ha a foglalási folyamat a termék saját élményének része.
- MCP szerver. Ugyanazokat a képességeket teszi elérhetővé AI ügynökök számára, így egy asszisztens kereshet, árazhat és befejezhet egy foglalást anélkül, hogy a felhasználót weboldalra irányítaná.
A három nem kizárólagos — egy termék gyakran használ komponenseket marketing felülethez és az API-t a fő folyamatához.
Mit építs először?
Szekció neve “Mit építs először?”- Keresés és ár egy városra és egy dátumtartományra. Szerezd meg az élő árakat, mielőtt bármit terveznél.
- Hozz létre egy tesztfoglalást végig, beleértve a fizetést és a megerősítést.
- Iratkozz fel a
booking.createés a lemondási eseményekre mielőtt bármilyen UI-t építenél rá. - Döntsd el korán az attribúciós modellt — a forrás kontextusának utaznia kell a foglalással, különben később csak találgatás lesz a jelentés.
- Kezeld a hibás eseteket: elérhetőség elvesztése az árajánlat és a foglalás között, elutasított fizetés, részleges visszatérítések.
Árazás, amit a fejlesztőnek tudnia kell
Szekció neve “Árazás, amit a fejlesztőnek tudnia kell”A Consumer és Booking Engine API-k ingyenesek. A Partner API havi 10 000 szállodai éjszaka ingyenes keretet tartalmaz, utána egységenként számláz. A megerősített foglalások a szálloda 1,5%-os platformdíját és a kártyakezelési költséget tartalmazzák, és 10% alap jutalék vonatkozik, ha a terméked vezette a foglalást — így az integrátor keres, nem fizet.
Az ingyenes keret integrátoronként értendő. Több fiók nyitása a megkerüléshez visszaélésnek számít és azonnali, végleges tiltást von maga után. Lásd Partner API használat és korlátok.
Gyakori hibák
Szekció neve “Gyakori hibák”- Gyorsítótárazott árakra építeni. Fejlesztés alatt jól néznek ki, de élesben hibáznak.
- Fizetés átirányításra hagyása. Minden átadásnál veszteség van a foglalásokból.
- Webhookok figyelmen kívül hagyása a bevezetésig. Az egyeztetés kézi munkává válik.
- Kereskedővé válás szükségtelenül. Ez engedélyezési és felelősségvállalási döntés, nem csak technikai.
- Forrás kontextus át nem adása. Az attribúció később nem állítható vissza.