De vier belangrijke mogelijkheden
Section titled “De vier belangrijke mogelijkheden”| Mogelijkheid | Wat het betekent | Waarom producten zonder dit vastlopen |
|---|---|---|
| Live tarieven en beschikbaarheid | Huidige prijzen en wat daadwerkelijk boekbaar is, per datumbereik | Gecachte tarieven falen bij bevestiging en ondermijnen vertrouwen |
| Reserveringscreatie | Een echte reservering maken die het hotel ontvangt | Zonder dit ben je een doorverwijzingslink, geen product |
| Betaling | Geld innen als onderdeel van de reservering | Een overdracht naar een andere site is waar conversie faalt |
| Bevestiging en webhooks | Vertel gast, hotel en jouw systeem wat er is gebeurd | Anders ontstaan er ondersteuningsdruk en reconciliatieproblemen |
De meeste “hotel-API’s” die een ontwikkelaar vindt, dekken het eerste en soms het tweede. De transactie is het lastige deel, en dat bepaalt of je een product hebt.
Van wie is de voorraad die je integreert?
Section titled “Van wie is de voorraad die je integreert?”Deze vraag bepaalt alles wat daarna komt. Voorraad die via een keten wordt doorverkocht, komt met een opslag in het tarief, verouderde beschikbaarheid en geen route terug naar het hotel voor een reserveringsvraag. Voorraad die rechtstreeks van het hotel komt, draagt het eigen tarief van het hotel, live beschikbaarheid en een hotel dat weet dat de reservering bestaat.
Voor alles waarbij de reiziger vergelijkt met de eigen website van het hotel — wat het meeste is — voorkomt hotelgestuurde voorraad het ongemakkelijke moment dat jouw prijs slechter is.
Wie is de merchant of record
Section titled “Wie is de merchant of record”Als je zelf hotelreserveringen bouwt, betekent merchant of record worden dat je betalingsverantwoordelijkheid, chargebacks, terugbetalingen, belastingafhandeling en vaak een reisbureaulicentie in elke markt op je neemt.
Bij Wink blijft het hotel de merchant of record en wordt betaling voor het hotel geïnd, zodat een integrator die verantwoordelijkheid niet overneemt. Merchant-of-record-regelingen zijn beschikbaar bij API-integraties waarbij een partner echt zelf betaling moet innen, en die route brengt eigen licentievereisten met zich mee.
Drie integratieniveaus
Section titled “Drie integratieniveaus”- Webcomponenten. Voeg een boekbare zoekfunctie, kamerlijst of checkout toe aan een bestaande pagina. Geen backend-werk; minste controle over layout.
- REST API. Volledige controle over zoeken, tarieven, reserveringscreatie en bevestiging, geauthenticeerd met OAuth2. Gebruik dit wanneer de reserveringsflow deel uitmaakt van de eigen ervaring van je product.
- MCP-server. Dezelfde mogelijkheden beschikbaar voor AI-agents, zodat een assistent kan zoeken, prijzen en een reservering kan afronden in plaats van de gebruiker naar een website te sturen.
De drie zijn niet exclusief — een product gebruikt vaak componenten voor een marketingoppervlak en de API voor de kernflow.
Wat eerst bouwen
Section titled “Wat eerst bouwen”- Zoek en prijs voor één stad en één datumbereik. Zorg dat echte tarieven binnenkomen voordat je iets ontwerpt.
- Maak één testreservering van begin tot eind, inclusief betaling en bevestiging.
- Abonneer je op
booking.createen de annulerings-events voordat je een UI bouwt. - Bepaal je attributiemodel vroeg — broncontext moet meereizen met de reservering, anders is je rapportage later giswerk.
- Behandel de faalgevallen: beschikbaarheid verloren tussen offerte en boeking, betaling geweigerd, gedeeltelijke terugbetalingen.
Prijzen die een ontwikkelaar moet kennen
Section titled “Prijzen die een ontwikkelaar moet kennen”De Consumer en Booking Engine API’s zijn gratis. De Partner API bevat een gratis maandelijkse limiet van 10.000 hotelnachten, daarna wordt per eenheid gefactureerd. Bevestigde reserveringen dragen de 1,5% platformfee van het hotel plus kosten voor kaartverwerking, en een standaard commissie van 10% geldt wanneer jouw product de reservering heeft gegenereerd — zo verdient een integrator in plaats van betaalt.
Veelvoorkomende fouten
Section titled “Veelvoorkomende fouten”- Bouwen op gecachte tarieven. Die lijken prima tijdens ontwikkeling maar falen in productie.
- Betaling overlaten aan een redirect. Elke overdracht kost reserveringen.
- Webhooks negeren tot de lancering. Reconciliatie wordt dan handwerk.
- Merchant of record worden zonder noodzaak. Het is een licentie- en aansprakelijkheidsbeslissing, niet alleen technisch.
- Broncontext niet doorgeven. Attributie kan later niet worden herbouwd.