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ékoztatni a vendéget, a szállodát és a rendszeredet, 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éses árral, elavultabb elérhetőséggel é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égét é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 partner valóban fizetést akar fogadni, é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. Helyezz be egy foglalható keresőt, szobalistát vagy fizetési felületet egy meglévő oldalba. Nincs backend munka; legkevesebb irányítás a megjelenés felett.
- REST API. Teljes irányítás a keresés, árak, foglalás létrehozása és megerősítés felett, OAuth2 hitelesítéssel. 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öknek, í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ő folyamathoz.
Mit építs először
Szekció neve “Mit építs először”- Keresés és árképzés egy városra és egy dátumtartományra. Szerezz valódi á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.createdé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 ajánlat és a foglalás között, fizetés elutasítása, 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 kerettel rendelkezik, 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.
Gyakori hibák
Szekció neve “Gyakori hibák”- Gyorsítótárazott árakra építeni. Fejlesztéskor jól néznek ki, de élesben hibáznak.
- Fizetés átirányításra hagyása. Minden átirányításnál veszteség van a foglalásokban.
- Webhookok figyelmen kívül hagyása a bevezetésig. Az egyeztetés kézi munkává válik.
- Kereskedővé válni, ha nem szükséges. Ez engedélyezési és felelősségi döntés, nem csak technikai.
- Nem továbbítani a forrás kontextust. Az attribúció később nem állítható vissza.