De fire viktige funksjonene
Section titled “De fire viktige funksjonene”| Funksjon | Hva det betyr | Hvorfor produkter stopper opp uten det |
|---|---|---|
| Live priser og tilgjengelighet | Gjeldende priser og hva som faktisk kan bookes, per datoperiode | Bufrede priser feiler ved bekreftelse og svekker tillit |
| Bookingopprettelse | Opprette en ekte reservasjon som hotellet mottar | Uten dette er du bare en henvisningslenke, ikke et produkt |
| Betaling | Ta imot penger som del av bookingen | En overføring til en annen side er der konverteringen dør |
| Bekreftelse og webhooks | Informere gjest, hotell og ditt system om hva som skjedde | Støtter belastning og luker ut avstemmingsgap |
De fleste “hotell-API-er” en utvikler finner dekker det første og noen ganger det andre. Transaksjonen er den vanskelige delen, og det er den som avgjør om du har et produkt.
Hvem sin leveranse integrerer du?
Section titled “Hvem sin leveranse integrerer du?”Dette spørsmålet former alt som kommer etterpå. Leveranse videresolgt gjennom en kjede kommer med påslag i prisen, eldre tilgjengelighet, og ingen vei tilbake til hotellet for spørsmål om booking. Leveranse som kommer direkte fra hotellet har hotellets egen pris, live tilgjengelighet, og et hotell som vet at bookingen finnes.
For alt der reisende vil sammenligne med hotellets egen nettside — som er det meste — unngår hotellkontrollert leveranse det pinlige øyeblikket når prisen din er dårligere.
Hvem er merchant of record
Section titled “Hvem er merchant of record”Hvis du bygger hotellbooking selv, betyr det å bli merchant of record at du tar på deg betalingsansvar, chargebacks, refusjoner, skattehåndtering og ofte en reisebyrålisens i hvert marked.
På Wink forblir hotellet merchant of record og betaling samles inn for hotellet, så en integrator arver ikke dette ansvaret. Merchant-of-record-avtaler finnes for API-integrasjoner der en partner virkelig må ta betaling selv, og den veien har egne lisenskrav.
Tre nivåer av integrasjon
Section titled “Tre nivåer av integrasjon”- Webkomponenter. Legg inn et bookbart søk, romliste eller utsjekk på en eksisterende side. Ingen backend-arbeid; minst kontroll over layout.
- REST API. Full kontroll over søk, priser, bookingopprettelse og bekreftelse, autentisert med OAuth2. Bruk det når bookingflyten er en del av ditt produkts egen opplevelse.
- MCP-server. De samme mulighetene eksponert for AI-agenter, slik at en assistent kan søke, prise og fullføre en booking i stedet for å sende brukeren til en nettside.
De tre er ikke gjensidig utelukkende — et produkt bruker ofte komponenter for en markedsføringsflate og API-et for kjernen i flyten.
Hva du bør bygge først
Section titled “Hva du bør bygge først”- Søk og pris for én by og én datoperiode. Få ekte priser til å flyte før du designer noe.
- Opprett én testbooking fra start til slutt, inkludert betaling og bekreftelse.
- Abonner på
booking.createog avbestillingshendelser før du bygger noe UI oppå. - Bestem din attribusjonsmodell tidlig — kildekontekst må følge med bookingen, ellers blir rapporteringen gjetting senere.
- Håndter feilsituasjoner: tilgjengelighet tapt mellom tilbud og booking, betaling avvist, delvise refusjoner.
Prising en utvikler bør kjenne til
Section titled “Prising en utvikler bør kjenne til”Consumer- og Booking Engine-API-ene er gratis. Partner-API-et inkluderer en gratis månedlig kvote på 10 000 hotellnetter, deretter faktureres per enhet. Bekreftede bookinger belastes hotellets 1,5 % plattformavgift pluss kortbehandling til kostpris, og en standard provisjon på 10 % gjelder når ditt produkt drev bookingen — slik tjener en integrator i stedet for å betale.
Vanlige feil
Section titled “Vanlige feil”- Bygge på bufrede priser. De ser fine ut i utvikling, men feiler i produksjon.
- Overlate betaling til en omdirigering. Hver overføring mister bookinger.
- Ignorere webhooks til lansering. Avstemming blir et manuelt arbeid.
- Bli merchant of record uten behov. Det er en lisens- og ansvarsbeslutning, ikke bare teknisk.
- Ikke sende kildekontekst. Attribusjon kan ikke rekonstrueres i etterkant.