Snel aan de slag
Deze gids brengt je in ongeveer 30 minuten van niets naar een werkende integratie. Aan het einde heb je:
- live prijzen voor hotels in een stad, via de Partner API,
- een boekingslink die boekingen aan jouw account toekent,
- een testboeking en een webhook die je vertelt dat deze heeft plaatsgevonden.
Alles gebeurt in staging, onze testomgeving. Je hoeft ons niet om toegang te vragen en overstappen naar productie later vereist ook geen goedkeuring.
Is deze gids geschikt voor jou?
Section titled “Is deze gids geschikt voor jou?”| Je wilt… | Begin hier |
|---|---|
| Hotels tonen in je app, site of AI-product en reizigers doorsturen om te boeken, waarbij je commissie verdient | Deze gids |
| Boeken namens je klanten als een erkend reisbureau | Deze gids tot Stap 5, daarna Boeken als reisbureau |
| Boekbare hotels insluiten zonder een integratie te schrijven | Web Components |
| Een AI-agent laten zoeken en boeken | MCP Servers en Agentic Payments |
| Een channel manager of PMS koppelen | Voeg je channel manager toe |
Hoe het werkt
Section titled “Hoe het werkt”Je gebruikt de Partner API om hotels en hun live prijzen te vinden. Elk hotel heeft een stabiele urlName. Je maakt hiervan een link naar de Wink Booking Engine, book.wink.travel, met jouw ID’s erin. De reiziger boekt en betaalt daar, en de boeking wordt aan jouw account toegekend.
Voordat je begint
Section titled “Voordat je begint”Je hebt nodig:
grpcurl, of Postman of Insomnia. De Partner API is gRPC, geen REST.curl.
Stap 1: Maak een staging-account aan
Section titled “Stap 1: Maak een staging-account aan”Staging is volledig gescheiden van productie, met eigen inloggegevens en accounts.
-
Ga naar staging-app.wink.travel, klik op
Sign-In / Registeren registreer je. -
Klik in de linkerzijbalk op
Accounts, daarna opCreateen kies I am an Affiliate. Boekingen die je doorstuurt worden aan dit account toegekend. Zie Account aanmaken.
Stap 2: Maak een applicatie aan
Section titled “Stap 2: Maak een applicatie aan”De applicatie geeft je code zijn referenties.
-
Klik op je accountkaart op
Actions>Manage account, daarna op het tabbladApplications. -
Klik op
Create new application, geef het een naam en kies Machine-to-machine als clienttype. -
Selecteer onder scopes Inventory & rates (lezen). De Partner API controleert op
inventory.read. -
Klik op
Create applicationen kopieer de Client ID en Client secret. Het secret wordt één keer getoond en kan later niet meer worden opgevraagd.
Zie Applicaties voor de andere clienttypes en scopes.
Stap 3: Verkrijg een access token
Section titled “Stap 3: Verkrijg een access token”curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"Bewaar de access_token uit de respons:
export WINK_TOKEN=<access_token>Tokens verlopen. Laat in je eigen code een OAuth2-bibliotheek ze ophalen en vernieuwen. Zie Authenticatie.
Als het tokenverzoek wordt afgewezen, is de respons een JSON-body met een error-code:
error | HTTP-status | Gebruikelijke oorzaak |
|---|---|---|
invalid_client | 401 | Verkeerde client ID of secret, of productiereferenties gebruikt op staging-iam |
invalid_scope | 400 | Het verzoek vraagt om een scope waarvoor de applicatie niet geregistreerd is |
unauthorized_client | 400 | De applicatie mag de client_credentials-grant niet gebruiken |
invalid_request | 400 | Een verplicht parameter ontbreekt, bijvoorbeeld als de body JSON is in plaats van een formulier |
Stap 4: Vind je account-ID
Section titled “Stap 4: Vind je account-ID”Elke Partner API-aanroep noemt het account waarvoor je handelt in een managing-entity-id header. Lijst de accounts op waarvoor je token mag handelen:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsKopieer de accountId van het affiliate-account uit Stap 1:
export WINK_ACCOUNT_ID=<accountId>Stap 5: Zoek hotels in een stad
Section titled “Stap 5: Zoek hotels in een stad”Staging heeft testhotels met beschikbaarheid in Bangkok, dus deze zoekopdracht gebruikt de slug bangkok-thailand:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityGebruik een incheckdatum in de toekomst; een datum in het verleden wordt afgewezen. Elk resultaat bevat:
name,starRatingenheroImageUrl, genoeg om een resultaatrij te tonen,roomTypes, de live aanbiedingen, goedkoopste kamer eerst,urlName, de slug die je nodig hebt voor de boekingslink.
Prijzen zijn gehele getallen in kleine eenheden: deel door 10 tot de macht van currencyExponent uit de respons (2 voor USD, dus 12500 is $125,00).
Weet je de slug van een stad niet? Zoek die op met wink.partner.v1.Lookup/Search. Voor de volledige inhoud van een accommodatie gebruik je de Content service. De Partner API referentie documenteert elke oproep.
Stap 6: Bouw de boekingslink
Section titled “Stap 6: Bouw de boekingslink”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>is deurlNamevan het hotel uit Stap 5.client-idis de Client ID van je applicatie uit Stap 2.configuration-idis je customization ID:Manage account>Customizations. Een customization stelt ook je branding, standaardtaal en valuta in op de boekingspagina.
Geef de zoekopdracht van de reiziger mee
Section titled “Geef de zoekopdracht van de reiziger mee”Voeg de data, gasten, taal en valuta van de reiziger toe aan dezelfde link zodat de hotelpagina hiermee wordt geopend:
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| Parameter | Betekenis | Voorbeeld |
|---|---|---|
sd | Incheckdatum | sd=2027-03-14 |
n of ed | Aantal nachten, of uitcheckdatum | n=2 of ed=2027-03-16 |
rc | Gasten per kamer | rc=a2 (2 volwassenen) |
l | Weergavetaal | l=en |
c | Weergavevaluta | c=USD |
p | Promotiecode | p=ABC123 |
Deze parameters overschrijven de standaardwaarden uit je customization. De Handleiding Book Now-knop behandelt het volledige rc-formaat, inclusief kinderen en meerdere kamers.
De link opent de hotelpagina; deze kan geen kamer of tarief vooraf selecteren. De reiziger kiest de kamer op de hotelpagina, tegen de live prijs.
Zie Direct linken voor linken naar de startpagina van de boekingsengine in plaats van een enkel hotel.
Stap 7: Maak een testboeking
Section titled “Stap 7: Maak een testboeking”Open je link, kies data en een kamer, en betaal met een Stripe testkaart, bijvoorbeeld 4242 4242 4242 4242 met een willekeurige toekomstige vervaldatum en CVC. Er wordt geen echt bedrag afgeschreven in staging. Noteer de boekingscode op de bevestigingspagina; deze begint met WNK.
Stap 8: Ontvang meldingen over boekingen
Section titled “Stap 8: Ontvang meldingen over boekingen”-
Ga in Portal naar
Applications > Webhooksen voeg een endpoint toe datPOST-verzoeken accepteert. -
Abonneer je op
booking.create, of laat de lijst met events leeg om alles te ontvangen tijdens ontwikkeling. -
Stuur jezelf een testevent, maak daarna een nieuwe testboeking en kijk of deze binnenkomt.
Verifieer elke handtekening van een levering voordat je deze vertrouwt. Zie Webhook-integratie en de Webhook Events Catalog.
Stap 9: Ga naar productie
Section titled “Stap 9: Ga naar productie”Er is geen goedkeuringsstap voor ontwikkelaars. (Reisbureau-accounts worden eerst gecertificeerd; zie hieronder.) Als je integratie werkt in staging:
-
Maak een account en een applicatie aan op app.wink.travel, zoals in Stap 1 en 2. Referenties worden niet overgedragen tussen omgevingen.
-
Verwijder
staging-uit elke host:Staging Productie https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Zoek opnieuw je productie-account-ID (Stap 4) en customization-ID (Stap 6). Deze verschillen van staging.
Partner API-gebruik wordt gemeten in hotelnachten, met een gratis maandelijkse limiet. Zie Partner API voor prijzen en limieten.
Boeken als reisbureau
Section titled “Boeken als reisbureau”Als je account een erkend reisbureau is, hoef je reizigers niet naar book.wink.travel te sturen: je kunt boekingen direct aanmaken met wink.partner.v1.Booking/CreateBooking en beheren met de andere Booking-oproepen. Andere accounts sturen reizigers naar de boekingslink.
Reisbureau-accounts worden gecertificeerd: Wink controleert elke registratie voordat er geboekt kan worden. Bureaus die zelf betalingen van hun klanten willen innen als merchant of record, moeten via de Partner API boeken en schriftelijke goedkeuring van Wink krijgen. Zie Aan de slag als reisbureau en de Partner API referentie.
Volgende stappen
Section titled “Volgende stappen”- Genereer een getypeerde client vanuit het
.proto-schema in plaats vangrpcurlhandmatig te gebruiken. - Koppel de MCP-server en gebruik de AI Skills om je programmeerassistent de integratie tegen de live API te laten schrijven.
- Lees de volledige lijst van omgevingen en hosts.
