Ga naar inhoud
Wink

Snel aan de slag

Deze gids neemt je in ongeveer 30 minuten mee 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 het is gebeurd.

Alles gebeurt in staging, onze testomgeving. Je hoeft ons niet om toegang te vragen en overstappen naar productie later vereist ook geen goedkeuring.

Is dit de juiste gids voor jou?

Section titled “Is dit de juiste gids voor jou?”
Je wilt…Begin hier
Hotels tonen in je app, site of AI-product en reizigers doorsturen om te boeken, waarbij je commissie verdientDeze gids
Boeken namens je klanten als een erkend reisbureauDeze gids tot Stap 5, daarna Boeken als reisbureau
Boekbare hotels insluiten zonder een integratie te schrijvenWeb Components
Een AI-agent laten zoeken en boekenMCP Servers en Agentic Payments
Een channel manager of PMS koppelenVoeg 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 er een link van naar de Wink Booking Engine, book.wink.travel, met jouw ID’s. 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.

  1. Ga naar staging-app.wink.travel, klik op Sign-In / Register en registreer je.

  2. Klik in de linkerzijbalk op Accounts, daarna op Create en 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.

  1. Klik op je accountkaart op Actions > Manage account, daarna op het tabblad Applications.

  2. Klik op Create new application, geef het een naam en kies Machine-to-machine als clienttype.

  3. Selecteer onder scopes Inventory & rates (lezen). De Partner API controleert op inventory.read.

  4. Klik op Create application en kopieer de Client ID en Client secret. Het secret wordt één keer getoond en kan later niet worden opgevraagd.

Zie Applicaties voor de andere clienttypes en scopes.

Stap 3: Verkrijg een access token

Section titled “Stap 3: Verkrijg een access token”
Terminal window
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:

Terminal window
export WINK_TOKEN=<access_token>

Tokens verlopen. Laat in je eigen code een OAuth2-bibliotheek ze ophalen en vernieuwen. Zie Authenticatie.

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:

Terminal window
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  -d '{}' \
  staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Kopieer de accountId van het affiliate account uit Stap 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Stap 5: Zoek hotels in een stad

Section titled “Stap 5: Zoek hotels in een stad”
Terminal window
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/SearchByCity

Gebruik een incheckdatum in de toekomst; een datum in het verleden wordt geweigerd. Elk resultaat bevat:

  • name, starRating en heroImageUrl, genoeg om een resultaatregel 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.

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 de urlName van het hotel uit Stap 5.
  • client-id is de Client ID van je applicatie uit Stap 2.
  • configuration-id is je customization ID: Manage account > Customizations. Een customization stelt ook je branding, standaardtaal en valuta in op de boekingspagina.

Zie Direct linken voor linken naar de startpagina van de booking engine 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; die begint met WNK.

Stap 8: Ontvang meldingen over boekingen

Section titled “Stap 8: Ontvang meldingen over boekingen”

  1. Ga in Portal naar Applications > Webhooks en voeg een endpoint toe dat POST-verzoeken accepteert.

  2. Abonneer je op booking.create, of laat de lijst met events leeg om alles te ontvangen tijdens het ontwikkelen.

  3. Stuur jezelf een testevent, maak daarna een nieuwe testboeking en zie het binnenkomen.

Verifieer de handtekening van elke 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:

  1. Maak een account en een applicatie aan op app.wink.travel, zoals in Stap 1 en 2. Referenties worden niet overgedragen tussen omgevingen.

  2. Verwijder staging- uit elke host:

    StagingProductie
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel

  3. 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 beoordeelt 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”