De fyra viktiga funktionerna
Section titled “De fyra viktiga funktionerna”| Funktion | Vad det betyder | Varför produkter stannar utan det |
|---|---|---|
| Livepriser och tillgänglighet | Aktuella priser och vad som faktiskt går att boka, per datumintervall | Cachade priser misslyckas vid bekräftelse och undergräver förtroendet |
| Skapande av bokning | Skapa en riktig reservation som hotellet tar emot | Utan det är du en hänvisningslänk, inte en produkt |
| Betalning | Ta emot pengar som en del av bokningen | En överlämning till en annan webbplats dödar konverteringen |
| Bekräftelse och webhooks | Meddela gästen, hotellet och ditt system vad som hänt | Annars uppstår belastning och avstämningsluckor |
De flesta “hotell-API:er” som en utvecklare hittar täcker det första och ibland det andra. Transaktionen är den svåra delen, och det är den som avgör om du har en produkt.
Vems utbud integrerar du?
Section titled “Vems utbud integrerar du?”Denna fråga formar allt som kommer efteråt. Utbud som säljs vidare genom en kedja kommer med en påslag i priset, äldre tillgänglighet och ingen väg tillbaka till hotellet för bokningsfrågor. Utbud som kommer direkt från hotellet har hotellets egna pris, live-tillgänglighet och ett hotell som vet att bokningen finns.
För allt där resenären kommer att jämföra med hotellets egen webbplats — vilket är det mesta — undviker hotellkontrollerat utbud det pinsamma ögonblicket när ditt pris är sämre.
Vem är merchant of record
Section titled “Vem är merchant of record”Om du bygger hotellbokning själv innebär att bli merchant of record att ta på sig betalningsansvar, chargebacks, återbetalningar, skattehantering och ofta en resebyrålicens i varje marknad.
På Wink förblir hotellet merchant of record och betalning samlas in för hotellet, så en integratör ärver inte det ansvaret. Merchant-of-record-arrangemang finns för API-integrationer där en partner verkligen behöver ta emot betalning själv, och den vägen har sina egna licenskrav.
Tre integrationsnivåer
Section titled “Tre integrationsnivåer”- Webbkomponenter. Lägg in en bokningsbar sökning, rumslista eller kassa på en befintlig sida. Ingen backend-arbete; minst kontroll över layout.
- REST API. Full kontroll över sökning, priser, skapande av bokning och bekräftelse, autentiserat med OAuth2. Använd när bokningsflödet är en del av din produkts egen upplevelse.
- MCP-server. Samma funktioner exponerade för AI-agenter, så en assistent kan söka, prissätta och slutföra en bokning istället för att skicka användaren till en webbplats.
De tre är inte exklusiva — en produkt använder ofta komponenter för en marknadsföringsyta och API:et för sitt kärnflöde.
Vad man ska bygga först
Section titled “Vad man ska bygga först”- Sök och prissätt för en stad och ett datumintervall. Få riktiga priser att flöda innan du designar något.
- Skapa en testbokning från början till slut, inklusive betalning och bekräftelse.
- Prenumerera på
booking.createdoch avbokningshändelserna innan du bygger något UI ovanpå. - Bestäm din attribueringsmodell tidigt — källkontext måste följa med bokningen, annars blir din rapportering gissningar senare.
- Hantera felfallen: tillgänglighet förlorad mellan offert och bokning, betalning nekad, delåterbetalningar.
Prissättning en utvecklare bör känna till
Section titled “Prissättning en utvecklare bör känna till”Consumer- och Booking Engine-API:erna är gratis. Partner-API:et inkluderar en gratis månadsgräns på 10 000 hotellnätter, därefter debiteras per enhet. Bekräftade bokningar bär hotellets 1,5 % plattformsavgift plus kortavgift till självkostnad, och en standardprovision på 10 % gäller när din produkt drev bokningen — vilket är hur en integratör tjänar snarare än betalar.
Vanliga misstag
Section titled “Vanliga misstag”- Bygga på cachade priser. De ser bra ut i utveckling men misslyckas i produktion.
- Lämna betalning till en omdirigering. Varje överlämning förlorar bokningar.
- Ignorera webhooks tills lansering. Avstämning blir ett manuellt jobb.
- Bli merchant of record utan att behöva. Det är ett licens- och ansvarbeslut, inte bara tekniskt.
- Inte skicka källkontext. Attribuering kan inte rekonstrueras i efterhand.