Agentgreiðslur

Þú getur leitað að hóteli, valið herbergi og lokið bókun í gegnum AI-umboðið þitt. Tengdu það við Wink og greiðsluvösu, og segðu því hvar þú vilt dvelja. Wink notar Machine Payments Protocol (MPP) til að samþykkja greiðslu úr veskinu og skila bókunarstaðfestingu.

1. Tengdu MCP-þjónana

Fyrir fulla bókunarferlið þarf umboðið þitt Wink Booking Engine og greiðsluvösu.

Tenging	Hvað hún gerir	Hvernig á að bæta við
Wink Booking Engine — nauðsynlegt	Finnur áfangastaði, leitar að hótelum og herbergjaverðum, gefur tilboð og staðfestir bókanir, og sækir bókanir og kvittanir.	Bættu við `https://api.wink.travel/mcp/booking-engine` sem fjar-MCP-þjón.
Greiðsluvösu — nauðsynlegt til að greiða	Veitir greiðslugögn eftir að þú samþykkir kaupin.	Tengdu veski sem styður Stripe Shared Payment Tokens. Sjá dæmi um Link hér að neðan.
Wink Reference — valfrjálst	Leitast við lönd, gjaldmiðla og aðrar tilvísanir.	`https://api.wink.travel/mcp/reference`
Wink Docs — valfrjálst	Hjálpar umboðinu að lesa skjöl og API-samninga.	`https://docs.mcp.wink.travel/mcp`

Booking Engine MCP inniheldur þegar verkfærin sem þarf fyrir ferðamannabókun þegar agentgreiðslur og bókanir eru virkjaðar í því umhverfi. Sérstakur Payment MCP frá Wink er fyrir fjármálastarfsemi eins og bókhald og úttektir; hann er ekki nauðsynlegur til að greiða fyrir herbergi.

Skráðu þig inn og veldu heimildir

Opnaðu MCP eða tengingarstillingar umboðsins og bættu við Booking Engine slóðinni hér að ofan. Gefðu henni nafn eins og Wink Booking.
Umboðið opnar innskráningarsíðu Wink í vafranum þínum. Skráðu þig inn með Wink-reikningnum sem þú vilt bóka undir.
Á samþykkisskjánum velurðu heimildir sem umboðið þarf og samþykkir tenginguna.
Farðu aftur í umboðið. Það hleður tiltækum verkfærum og sér um auðkenningu fyrir næstu MCP-köll.

Fyrir þetta ferli veldu:

Heimild	Af hverju hún er nauðsynleg
Aðgangur AI-umboðs (`mcp.read`)	Leyfir umboðinu að tengjast Wink MCP.
Lesa markaðssetningu (`marketing.read`)	Leyfir umboðinu að finna bókunarstillingu reikningsins þíns, sem kallast customization. Reikningurinn þinn þarf einnig að hafa aðgang að þeirri stillingu.
Skrifa greiðslu (`payment.write`)	Leyfir umboðinu að greiða fyrir tilboðið og staðfesta bókunina.

Haltu þeim heimildum sem tengingin biður um við innskráningu. MCP viðskiptavinurinn þinn sér um að meðhöndla aðgangstákn; þú þarft ekki að afrita tákn í spjall eða stilla beiðnishöfuð. Ef þú slepptir nauðsynlegri heimild, tengdu aftur í gegnum innskráningarferli viðskiptavinarins og samþykktu hana.

Tengdu greiðsluvösu

Fyrir Stripe-greiðslur er einn kostur Link agentaveskið. Ef viðskiptavinurinn þinn styður staðbundna MCP-þjóna og Node.js er uppsett, bættu þessari færslu við MCP-stillingar hans:

{
  "mcpServers": {
    "link": {
      "command": "npx",
      "args": ["@stripe/link-cli", "--mcp"]
    }
  }
}

Biddu umboðið þitt að tengja Link-reikninginn þinn, fylgdu síðan staðfestingartenglinum sem það gefur og samþykktu tenginguna. Link veitir Shared Payment Token sem notað er til að greiða fyrir bókunina. Link styður núverandi bandaríska reikninga; athugaðu útgjaldamörk áður en þú bókar. Sjáðu uppsetningarleiðbeiningar Link og MCP-stillingar.

Ef umboðið þitt hefur þegar tengt samhæft veski, notaðu þá tengingu. Uppsetning veska og samþykki greiðslu eru aðskilin frá innskráningu í Wink.

2. Biddu umboðið þitt að finna herbergi

Til dæmis:

Finndu herbergi í Bangkok fyrir tvo fullorðna frá 15. til 17. janúar 2027. Sýndu mér tiltækar valmöguleika, heildarverð og afbókunarskilmála áður en ég vel.

Umboðið þitt getur fundið aðgengilega Wink-reikninga þína og bókunarstillingar þeirra. Ef þú átt fleiri en einn, segðu því hvaða á að nota. Ef þú bókar í gegnum gefinn bókunartengil eða stillingu, gefðu það í staðinn.

Umboðið leysir síðan áfangastaðinn, athugar tiltæk hótel og hleður herbergjaverðum fyrir dagsetningar þínar. Veldu herbergi og biððu um tilboð.

Þetta greiðsluferli styður nú eitt herbergi, verðlagt í USD, aðeins fyrir fullorðna. Tilboð hefur gildistíma. Að biðja um tilboð rukkar þig ekki og staðfestir ekki bókun.

3. Skoðaðu og samþykktu greiðslu

Skoðaðu hótelið, herbergið, dagsetningar, gesti, afbókunarskilmála og tilboðið í heild. Þegar þú ert tilbúinn, biððu umboðið að bóka og ljúka öllum samþykktum sem veskið krefst.

Veskið veitir Stripe Shared Payment Token til að greiða fyrir tilboðið.

Tempo stablecoin greiðslur koma fljótlega.

Eftir að greiðsla hefur tekist færðu frá umboðinu bókunarstaðfestingarkóða. Það getur einnig sótt bókunarupplýsingar og kvittun í gegnum Booking Engine MCP.

Ef greiðsla er enn í vinnslu eða svar tapast, láttu umboðið athuga sama greiðslutilraunina. Það á að endurnýta tilboðið og greiðslugögnin í stað þess að hefja aðra greiðslu. Ef greiðsla er hafnað, biððu um nýtt tilboð og skoðaðu það áður en þú reynir aftur.

Verkfærayfirlit fyrir umboð og verktaka

Öll Wink-verkfæri hér að neðan eru aðgengileg í gegnum Booking Engine MCP. MCP viðskiptavinurinn sendir auðkenningu sjálfkrafa með heimildum sem samþykktar voru við innskráningu.

Skref	Verkfæri og hegðun
Velja bókunarumhverfi	`managing_entity_list`, síðan `customization_get_primary` eða `customization_search` fyrir valinn reikning. Notaðu gefna stillingu ef hún er þekkt.
Finna áfangastað	`destination_lookup_search_suggestions` og `destination_lookup_get`.
Leita að hótelum og herbergjum	`inventory_search_city` eða `inventory_search_geo`, síðan `property_inventory_get` fyrir verð og framboð.
Gefa tilboð fyrir valið herbergi	`agentic_booking_quote`. Sendu herbergisupplýsingar í `request` færibreytunni.
Greiða og staðfesta	Fáðu Shared Payment Token úr tengdu veski, síðan kallaðu á `agentic_booking_pay` með `request.quoteId` og `request.spt`. Haltu sama innskráða Wink-notanda fyrir tilboð og greiðslu.
Sækja bókun og kvittun	Notaðu `booking_search` eða `booking_search_list` til að finna staðfesta bókun, síðan `booking_get` og `booking_receipt_get` með bókunarnúmeri.

Tilboðsbeiðni þarf hotelIdentifier, roomRateIdentifier, checkIn, checkOut, adults, children og customizationIdentifier. Dagsetningar eru í YYYY-MM-DD; checkOut þarf að vera eftir checkIn. Stilltu adults að minnsta kosti 1 og children í 0.

Tilboðið skilar quoteId, amountUsdCents, currency, expiresAt og mppChallenges. Sýndu USD-cent sem dollara: 10000 þýðir $100.00.

Niðurstaða greiðslu	Næsta skref
`PAYMENT_SUCCEEDED`	Vistaðu `bookingConfirmationCode` og `chargeReference`.
`IN_PROGRESS`	Bíddu stutt og reyndu sama tilboð og gögn aftur.
`DECLINED`	Biððu um nýtt tilboð og skoðaðu það áður en þú reynir greiðslu aftur.

Vel heppnuð endurtekning skilar núverandi bókun án þess að rukka aftur. Meðhöndlaðu tímamörk sem óþekktan útkomu og reyndu sömu greiðslu aftur. Ef hún leysist ekki, hafðu samband við stuðning með tilboðsauðkennið.

MCP viðskiptavinir með greiðsluvitund

Greiðsluvitandi MCP viðskiptavinir geta notað agentic_booking_book með herbergjagildum beint í arguments. Fyrsta kallið skilar villu -32042 með greiðsluáskorunum. Reyndu sama kall með veski-gögnum í params._meta["org.paymentauth/credential"]; árangur inniheldur result._meta["org.paymentauth/receipt"]. Villa -32043 ber með sér greiðsluvillu og áskorun: endanleg höfnun þarf nýtt tilboð, en ófullkomin greiðslugögn geta reynt aftur með sömu áskorun. Fyrir -32603 þýðir data.failure.reason sem er payment-in-progress eða already-consumed að reyna sama gögn aftur; villukóði einn og sér nægir ekki.

Bókaðu yfir REST

Notaðu REST þegar þú byggir samþættingu sem kallar beint á Wink yfir HTTP. Bæði tilboð og greiðsla nota POST https://api.wink.travel/api/mpp/booking.

Forritið þitt þarf Wink notendaaðgangstákn með heimildinni payment.write til að greiða. Haltu sama notanda fyrir báða kalla. Sendu táknið í Wink-Authorization, og skildu Authorization eftir fyrir greiðslugögn vesksins. Þessir hausar gilda fyrir REST; MCP viðskiptavinur sér um sína eigin auðkenningu.

1. Biðja um tilboð

Vistaðu valið herbergi sem booking.json, með því að skipta út dæmisauðkennum og dagsetningum fyrir þínar. Herbergisgildin fara beint í JSON-innri hlutann, án request umbúða.

{
  "hotelIdentifier": "YOUR_HOTEL_ID",
  "roomRateIdentifier": "YOUR_ROOM_RATE_ID",
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-17",
  "adults": 2,
  "children": 0,
  "customizationIdentifier": "YOUR_CUSTOMIZATION_ID"
}

Stilltu WINK_ACCESS_TOKEN á aðgangstáknið og sendu beiðnina:

curl -i https://api.wink.travel/api/mpp/booking \
  -H "Wink-Authorization: Bearer $WINK_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data-binary @booking.json

Wink skilar 402 Payment Required með WWW-Authenticate: Payment ... áskorun fyrir hverja boðna aðferð. JSON-innri hlutinn inniheldur quoteId, amount, currency, expiresAt og methods. Hér er amount strengur í USD-centum: "10000" þýðir $100.00. Skoðaðu tilboðið áður en það rennur út; engin greiðsla hefur verið tekin.

2. Greiða og staðfesta

Láttu veskið uppfylla skilaða Stripe áskorun með því að veita Shared Payment Token í payload.spt. Notaðu greiðsluupplýsingar úr áskoruninni.

Stilltu MPP_CREDENTIAL á dulritaða MPP-gögn vesksins, sem inniheldur áskorun og greiðslugögn. Reyndu sama beiðnina aftur, haltu auðkenningarhaus:

curl -i https://api.wink.travel/api/mpp/booking \
  -H "Wink-Authorization: Bearer $WINK_ACCESS_TOKEN" \
  -H "Authorization: Payment $MPP_CREDENTIAL" \
  -H 'Content-Type: application/json' \
  --data-binary @booking.json

Við árangur skilar Wink 200 OK, JSON-innri hlut með bookingConfirmationCode og haus Payment-Receipt. Vistaðu staðfestingu og kvittun. Vel heppnuð endurtekning skilar núverandi bókun án þess að rukka aftur.

Meðhöndla svör og endurtekningar

Svar	Hvað á að gera
`400`	Lagfæra ógildar herbergisupplýsingar eða röng gögn í auðkenni.
`401` / `403`	Athuga auðkenningu notanda og greiðsluheimild.
`402`	Skoða vandamálið og áskorunina. Endanleg höfnun greiðslu krefst nýs tilboðs; ófullkomin greiðslugögn endurnýta upprunalegu áskorunina. Skoðaðu verðið áður en þú greiðir.
`409`	Útkoma greiðslu er óákveðin. Bíddu stutt og reyndu sama beiðni og gögn aftur á bókunarendapunkti.
`429`	Bíddu þann tíma sem stendur í `Retry-After` og reyndu aftur.

Svar 409 hefur application/problem+json líkama. Berðu type saman við þessar nákvæmu slóðir:

Tegund vandamáls	Merking
https://api.wink.travel/problems/payment-in-progress	Greiðslutilraun er enn í gangi eða uppgjör hefur ekki verið staðfest.
https://api.wink.travel/problems/already-consumed	Áskorun eða greiðslusönnun hefur þegar verið notuð í mögulega árangursríka tilraun. Þetta staðfestir ekki bókunina ein og sér.

Bæði þýða reyna sömu greiðslu aftur; ekki greiða nýtt tilboð. Slóðirnar auðkenna og skjalfesta vandamálið; þær eru ekki greiðslu- eða eftirlitsendapunktar. Reyndu POST /api/mpp/booking aftur og notaðu type vandamálsins frekar en frjálsa texta detail til að ákveða næsta skref. Sjáðu yfirlit yfir vandamálategundir fyrir öll Wink greiðsluvandamál.

Tímamörk, tap á svari eða þjónustuvilla eftir að greiðsla hefur verið send getur einnig skilið útkomu óvissa. Reyndu sömu greiðslu aftur. Ef útkoman leysist ekki, hafðu samband við stuðning með tilboðsauðkennið áður en þú byrjar aðra greiðslu.