Hoppa till innehåll
Wink

Kom igång snabbt

Denna guide tar dig från ingenting till en fungerande integration på cirka 30 minuter. I slutet kommer du att ha:

  • live priser för hotell i en stad, från Partner API,
  • en bokningslänk som krediterar bokningar till ditt konto,
  • en testbokning och en webhook som berättar att den har skett.

Allt sker i staging, vår testmiljö. Du behöver inte be oss om tillgång, och att gå till produktion senare kräver heller inget godkännande.

Är detta rätt guide för dig?

Section titled “Är detta rätt guide för dig?”
Du vill…Börja här
Visa hotell i din app, webbplats eller AI-produkt och skicka resenärer för att boka, och tjäna provisionDenna guide
Boka åt dina kunder som en licensierad resebyråDenna guide upp till Steg 5, sedan Boka som resebyrå
Bädda in bokningsbara hotell utan att skriva en integrationWeb Components
Låta en AI-agent söka och bokaMCP Servers och Agentic Payments
Koppla en channel manager eller PMSLägg till din channel manager

Hur det fungerar

Section titled “Hur det fungerar”

Du använder Partner API för att hitta hotell och deras livepriser. Varje hotell har ett stabilt urlName. Du gör det till en länk till Wink Booking Engine, book.wink.travel, som bär dina ID:n. Resenären bokar och betalar där, och bokningen krediteras ditt konto.

Innan du börjar

Section titled “Innan du börjar”

Du behöver:

  • grpcurl, eller Postman eller Insomnia. Partner API är gRPC, inte REST.
  • curl.

Steg 1: Skapa ett stagingkonto

Section titled “Steg 1: Skapa ett stagingkonto”

Staging är helt separat från produktion, med egna inloggningar och konton.

  1. Gå till staging-app.wink.travel, klicka på Sign-In / Register och registrera dig.

  2. Klicka på Accounts i vänstra sidofältet, sedan Create, och välj I am an Affiliate. Bokningar du skickar krediteras detta konto. Se Skapa konto.

Steg 2: Skapa en applikation

Section titled “Steg 2: Skapa en applikation”

Applikationen ger din kod dess inloggningsuppgifter.

  1. På ditt kontokort, klicka Actions > Manage account, sedan fliken Applications.

  2. Klicka Create new application, ge den ett namn och välj Machine-to-machine som klienttyp.

  3. Under scopes, välj Inventory & rates (read). Partner API kontrollerar för inventory.read.

  4. Klicka Create application och kopiera Client ID och Client secret. Hemligheten visas en gång och kan inte hämtas senare.

Se Applications för andra klienttyper och scopes.

Steg 3: Skaffa en access token

Section titled “Steg 3: Skaffa en 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"

Spara access_token från svaret:

Terminal window
export WINK_TOKEN=<access_token>

Tokens går ut. I din egen kod, låt ett OAuth2-bibliotek hämta och uppdatera dem. Se Authentication.

Steg 4: Hitta ditt konto-ID

Section titled “Steg 4: Hitta ditt konto-ID”

Varje Partner API-anrop anger kontot du agerar för i en managing-entity-id header. Lista de konton din token kan agera för:

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

Kopiera accountId för affiliate-kontot från Steg 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Steg 5: Sök hotell i en stad

Section titled “Steg 5: Sök hotell i en 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

Använd ett incheckningsdatum i framtiden; ett tidigare datum avvisas. Varje resultat innehåller:

  • name, starRating och heroImageUrl, tillräckligt för att visa en resultatrad,
  • roomTypes, de live erbjudandena, billigaste rum först,
  • urlName, sluggen du behöver för bokningslänken.

Priser är heltal i mindre enheter: dela med 10 upphöjt till currencyExponent från svaret (2 för USD, så 12500 är $125.00).

Känner du inte till en stads slug? Hämta den med wink.partner.v1.Lookup/Search. För en fastighets fullständiga innehåll, använd Content-tjänsten. Partner API-referensen dokumenterar varje anrop.

Steg 6: Bygg bokningslänken

Section titled “Steg 6: Bygg bokningslänken”
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> är hotellets urlName från Steg 5.
  • client-id är din applikations Client ID från Steg 2.
  • configuration-id är din anpassnings-ID: Manage account > Customizations. En anpassning sätter också din branding, standardspråk och valuta på bokningssidan.

Se Länka direkt för att länka till bokningsmotorns startsida istället för ett enskilt hotell.

Steg 7: Gör en testbokning

Section titled “Steg 7: Gör en testbokning”

Öppna din länk, välj datum och rum, och betala med ett Stripe testkort, till exempel 4242 4242 4242 4242 med vilket framtida utgångsdatum och CVC som helst. Inget riktigt kort debiteras i staging. Notera bokningskoden på bekräftelsesidan; den börjar med WNK.

Steg 8: Få notiser om bokningar

Section titled “Steg 8: Få notiser om bokningar”

  1. I Portal, gå till Applications > Webhooks och lägg till en endpoint som accepterar POST-förfrågningar.

  2. Prenumerera på booking.create, eller lämna händelselistan tom för att ta emot allt medan du utvecklar.

  3. Skicka en testhändelse till dig själv, gör sedan en ny testbokning och se att den kommer fram.

Verifiera varje leverans signatur innan du litar på den. Se Webhook Integration och Webhook Events Catalog.

Steg 9: Gå till produktion

Section titled “Steg 9: Gå till produktion”

Det finns inget godkännandesteg för utvecklare. (Resebyråkonto certifieras först; se nedan.) När din integration fungerar i staging:

  1. Skapa ett konto och en applikation på app.wink.travel, som i Steg 1 och 2. Inloggningsuppgifter överförs inte mellan miljöer.

  2. Ta bort staging- från varje host:

    StagingProduktion
    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. Hämta ditt produktionskonto-ID (Steg 4) och anpassnings-ID (Steg 6) igen. De skiljer sig från staging.

Partner API-användning mäts i hotellnätter, med en gratis månadsgräns. Se Partner API för priser och begränsningar.

Boka som resebyrå

Section titled “Boka som resebyrå”

Om ditt konto är en licensierad resebyrå behöver du inte skicka resenärer till book.wink.travel: du kan skapa bokningar direkt med wink.partner.v1.Booking/CreateBooking och hantera dem med de andra Booking-anropen. Andra konton skickar resenärer till bokningslänken istället.

Resebyråkonto certifieras: Wink granskar varje byrås registrering innan den kan boka. Byråer som vill ta betalt direkt från sina kunder, som merchant of record, måste boka via Partner API och få Winks skriftliga godkännande. Se Kom igång som resebyrå och Partner API-referensen.

Nästa steg

Section titled “Nästa steg”