Skip to content

Mabilisang Pagsisimula

Ang gabay na ito ay magdadala sa iyo mula wala hanggang sa gumaganang integrasyon sa loob ng mga 30 minuto. Sa katapusan ay magkakaroon ka ng:

  • mga live na presyo para sa mga hotel sa isang lungsod, mula sa Partner API,
  • isang link ng booking na nagbibigay ng kredito sa iyong account,
  • isang test booking, at isang webhook na nagsasabi sa iyo na ito ay nangyari.

Lahat ng ito ay nangyayari sa staging, ang aming testing environment. Hindi mo kailangang humingi ng access sa amin, at ang paglipat sa production mamaya ay hindi rin nangangailangan ng pag-apruba.

Gusto mong…Magsimula dito
Ipakita ang mga hotel sa iyong app, site o AI na produkto at ipadala ang mga biyahero upang mag-book, kumita ng komisyonAng gabay na ito
Mag-book para sa iyong mga kliyente bilang isang lisensyadong travel agencyAng gabay na ito hanggang Step 5, pagkatapos ay Booking bilang isang travel agency
I-embed ang mga hotel na maaaring i-book nang hindi nagsusulat ng integrasyonWeb Components
Hayaan ang isang AI agent na maghanap at mag-bookMCP Servers at Agentic Payments
Ikonekta ang isang channel manager o PMSIdagdag ang Iyong Channel Manager

Ginagamit mo ang Partner API upang hanapin ang mga hotel at ang kanilang mga live na presyo. Bawat hotel ay may matatag na urlName. Ginagawa mo itong link papunta sa Wink Booking Engine, book.wink.travel, na may dala mong mga ID. Ang biyahero ay magbu-book at magbabayad doon, at ang booking ay makikilala sa iyong account.

Kakailanganin mo:

  • grpcurl, o Postman o Insomnia. Ang Partner API ay gRPC, hindi REST.
  • curl.

Ang staging ay ganap na hiwalay sa production, na may sarili nitong mga login at account.

  1. Pumunta sa staging-app.wink.travel, i-click ang Sign-In / Register at magrehistro.

  2. I-click ang Accounts sa kaliwang sidebar, pagkatapos ay Create, at piliin ang I am an Affiliate. Ang mga booking na iyong ipadala ay kikilalanin sa account na ito. Tingnan ang Create Account.

Ang application ang nagbibigay ng kredensyal sa iyong code.

  1. Sa iyong account card, i-click ang Actions > Manage account, pagkatapos ay ang tab na Applications.

  2. I-click ang Create new application, bigyan ito ng pangalan at piliin ang Machine-to-machine bilang client type.

  3. Sa ilalim ng scopes, piliin ang Inventory & rates (read). Tinitingnan ng Partner API ang inventory.read.

  4. I-click ang Create application at kopyahin ang Client ID at Client secret. Ang secret ay ipinapakita lamang isang beses at hindi na maaaring makuha muli.

Tingnan ang Applications para sa iba pang client types at scopes.

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"

I-save ang access_token mula sa tugon:

Terminal window
export WINK_TOKEN=<access_token>

Ang mga token ay may expiration. Sa iyong sariling code, hayaang kumuha at mag-refresh ang isang OAuth2 library ng mga ito. Tingnan ang Authentication.

Kung tinanggihan ang kahilingan ng token, ang tugon ay isang JSON body na may error code:

errorHTTP statusKaraniwang sanhi
invalid_client401Mali ang client ID o secret, o ginamit ang production credentials sa staging-iam
invalid_scope400Humiling ng scope na hindi rehistrado sa application
unauthorized_client400Hindi pinapayagan ang application na gamitin ang client_credentials grant
invalid_request400May nawawalang kinakailangang parameter, halimbawa kapag JSON ang body sa halip na form

Bawat tawag sa Partner API ay nagsasaad ng account na iyong kinakatawan sa managing-entity-id header. Ilan ang mga account na maaaring gamitin ng iyong token:

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

Kopyahin ang accountId ng affiliate account mula sa Step 1:

Terminal window
export WINK_ACCOUNT_ID=<accountId>

Step 5: Maghanap ng mga hotel sa isang lungsod

Section titled “Step 5: Maghanap ng mga hotel sa isang lungsod”

May mga test hotel ang staging na may availability sa Bangkok, kaya ang paghahanap na ito ay gumagamit ng slug nito, bangkok-thailand:

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

Gumamit ng petsa ng check-in sa hinaharap; tinatanggihan ang mga nakaraang petsa. Bawat resulta ay may:

  • name, starRating at heroImageUrl, sapat upang ipakita ang isang resulta sa listahan,
  • roomTypes, ang mga live na alok, pinakamurang kuwarto muna,
  • urlName, ang slug na kailangan mo para sa booking link.

Ang mga presyo ay mga integer sa minor units: hatiin sa 10 na may kapangyarihan ng currencyExponent mula sa tugon (2 para sa USD, kaya ang 12500 ay $125.00).

Hindi mo alam ang slug ng isang lungsod? I-resolve ito gamit ang wink.partner.v1.Lookup/Search. Para sa buong nilalaman ng isang property, gamitin ang Content service. Ang Partner API reference ay nagdodokumento ng bawat tawag.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • Ang <urlName> ay ang urlName ng hotel mula sa Step 5.
  • Ang client-id ay ang Client ID ng iyong application mula sa Step 2.
  • Ang configuration-id ay ang iyong customization ID: Manage account > Customizations. Ang isang customization ay nagse-set din ng iyong branding, default na wika at pera sa pahina ng booking.

Idagdag ang mga petsa, bisita, wika at pera ng biyahero sa parehong link upang magbukas ang pahina ng hotel na may mga ito nang naka-fill in:

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
ParameterKahuluganHalimbawa
sdPetsa ng check-insd=2027-03-14
n o edBilang ng gabi, o petsa ng check-outn=2 o ed=2027-03-16
rcMga bisita bawat kuwartorc=a2 (2 matatanda)
lWika ng pagpapakital=en
cPera ng pagpapakitac=USD
pPromotion codep=ABC123

Pinapalitan ng mga parameter na ito ang mga default na itinakda sa iyong customization. Ang Book Now button guide ay sumasaklaw sa buong format ng rc, kabilang ang mga bata at ilang kuwarto.

Binubuksan ng link ang pahina ng hotel; hindi nito maaaring i-pre-select ang kuwarto o rate. Pinipili ng biyahero ang kuwarto sa pahina ng hotel, sa live na presyo.

Tingnan ang Linking directly para sa pag-link direkta sa home page ng booking engine sa halip na isang hotel lang.

Buksan ang iyong link, pumili ng mga petsa at kuwarto, at mag-check out gamit ang isang Stripe test card, halimbawa 4242 4242 4242 4242 na may anumang hinaharap na expiry date at anumang CVC. Walang totoong card na sisingilin sa staging. Tandaan ang booking code sa pahina ng kumpirmasyon; nagsisimula ito sa WNK.

Step 8: Makakuha ng abiso tungkol sa mga booking

Section titled “Step 8: Makakuha ng abiso tungkol sa mga booking”
  1. Sa Portal, pumunta sa Applications > Webhooks at magdagdag ng endpoint na tumatanggap ng mga POST request.

  2. Mag-subscribe sa booking.create, o iwanang walang laman ang listahan ng event upang makatanggap ng lahat habang ikaw ay nagde-develop.

  3. Magpadala ng test event sa iyong sarili, pagkatapos ay gumawa ng isa pang test booking at panoorin itong dumating.

Suriin ang lagda ng bawat delivery bago ito pagkatiwalaan. Tingnan ang Webhook Integration at ang Webhook Events Catalog.

Walang hakbang ng pag-apruba para sa mga developer. (Ang mga account ng travel agency ay sertipikado muna; tingnan ang ibaba.) Kapag gumagana na ang iyong integrasyon sa staging:

  1. Gumawa ng account at application sa app.wink.travel, tulad ng sa Steps 1 at 2. Hindi naililipat ang mga kredensyal sa pagitan ng mga environment.

  2. Alisin ang staging- mula sa bawat host:

    StagingProduction
    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. Hanapin muli ang iyong production account ID (Step 4) at customization ID (Step 6). Iba ito sa staging.

Ang paggamit ng Partner API ay sinusukat sa hotel-nights, na may libreng buwanang allowance. Tingnan ang Partner API para sa pagpepresyo at mga limitasyon.

Kung ang iyong account ay isang lisensyadong travel agency, hindi mo kailangang ipadala ang mga biyahero sa book.wink.travel: maaari kang gumawa ng mga booking nang direkta gamit ang wink.partner.v1.Booking/CreateBooking, at pamahalaan ang mga ito gamit ang iba pang tawag sa Booking. Ang ibang mga account ay nagpapadala ng mga biyahero sa booking link sa halip.

Ang mga account ng travel agency ay sertipikado: nire-review ng Wink ang bawat rehistrasyon ng ahensya bago ito makapag-book. Ang mga ahensya na nais kolektahin ang bayad mula sa kanilang mga kliyente bilang merchant of record ay dapat mag-book sa pamamagitan ng Partner API at makakuha ng nakasulat na pag-apruba mula sa Wink. Tingnan ang Getting Started as a Travel Agency at ang Partner API reference.