Agentinės mokėjimo paslaugos

Galite ieškoti viešbučio, pasirinkti kambarį ir užbaigti užsakymą per savo AI agentą. Prijunkite jį prie Wink ir mokėjimo piniginės, tada nurodykite, kur norite apsistoti. Wink naudoja Machine Payments Protocol (MPP), kad priimtų piniginės mokėjimą ir grąžintų jūsų užsakymo patvirtinimą.

1. Prijunkite MCP serverius

Pilnam užsakymo procesui jūsų agentui reikalingi Wink Booking Engine ir mokėjimo piniginė.

Ryšys	Ką jis daro	Kaip pridėti
Wink Booking Engine — privalomas	Randa kelionės tikslus, ieško viešbučių ir kambarių kainų, pateikia pasiūlymus ir patvirtina užsakymus, taip pat gauna jūsų užsakymus ir kvitus.	Pridėkite https://api.wink.travel/mcp/booking-engine kaip nuotolinį HTTP MCP serverį.
Mokėjimo piniginė — reikalinga mokėjimui	Pateikia mokėjimo duomenis po to, kai patvirtinate pirkimą.	Prijunkite piniginę, palaikančią Stripe Shared Payment Tokens. Žr. žemiau pateiktą Link pavyzdį.
Wink Reference — neprivalomas	Ieško šalių, valiutų ir kitų nuorodų duomenų.	https://api.wink.travel/mcp/reference
Wink Docs — neprivalomas	Padeda jūsų agentui skaityti dokumentaciją ir API sutartis.	https://docs.mcp.wink.travel/mcp

Booking Engine MCP jau apima įrankius, reikalingus keliautojo užsakymo procesui, kai agentinis užsakymas ir mokėjimas yra įjungti toje aplinkoje. Atskiras Wink Payment MCP skirtas finansinėms operacijoms, tokioms kaip apskaitos žurnalai ir pinigų išėmimai; jis nėra būtinas kambario mokėjimui.

Prisijunkite ir pasirinkite leidimus

1. Atidarykite savo agento MCP arba jungties nustatymus ir pridėkite aukščiau nurodytą Booking Engine URL. Pavadinkite jį, pavyzdžiui, Wink Booking.
2. Jūsų agentas atidaro Wink prisijungimo puslapį naršyklėje. Prisijunkite su Wink paskyra, kuria norite atlikti užsakymą.
3. Sutikimo ekrane pasirinkite leidimus, kurių reikia jūsų agentui, tada patvirtinkite ryšį.
4. Grįžkite į savo agentą. Jis įkelia prieinamus įrankius ir tvarko autentifikaciją tolimesniems MCP kvietimams.

Šiam procesui pasirinkite:

Leidimas	Kodėl jis reikalingas
AI agento prieiga (mcp.read)	Leidžia jūsų agentui prisijungti prie Wink MCP.
Marketingo skaitymas (marketing.read)	Leidžia agentui rasti jūsų paskyros užsakymo konfigūraciją, vadinamą pritaikymu. Jūsų paskyra taip pat turi turėti prieigą prie tos konfigūracijos.
Mokėjimo rašymas (payment.write)	Leidžia agentui sumokėti už pasiūlymą ir patvirtinti užsakymą.

Išsaugokite prisijungimo leidimus, kurių prašo ryšys. Jūsų MCP klientas tvarko prieigos žetonus; jums nereikia kopijuoti žetono į pokalbį ar nustatyti užklausų antraščių. Jei praleidote reikalingą leidimą, prisijunkite iš naujo per savo kliento prisijungimo procesą ir patvirtinkite jį.

Prijunkite mokėjimo piniginę

Stripe mokėjimams viena iš galimybių yra Link agento piniginė. Jei jūsų klientas palaiko vietinius MCP serverius ir įdiegta Node.js, pridėkite šį įrašą į jo MCP konfigūraciją:

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

Paprašykite savo agento prijungti jūsų Link paskyrą, tada sekite pateiktą patvirtinimo nuorodą ir patvirtinkite ryšį. Link pateikia Shared Payment Token, naudojamą užsakymo apmokėjimui. Link šiuo metu palaiko JAV paskyras; prieš užsakymą patikrinkite išlaidų limitus. Žr. Link diegimo vadovą ir MCP konfigūraciją.

Jei jūsų agentas jau turi prijungtą suderinamą piniginę, naudokite tą ryšį. Piniginės nustatymas ir mokėjimo patvirtinimas yra atskiri nuo prisijungimo prie Wink.

2. Paprašykite agento rasti kambarį

Pavyzdžiui:

Rask kambarį Bankoke dviem suaugusiems nuo 2027 m. sausio 15 iki 17 dienos. Parodyk man galimus variantus, bendrą kainą ir atšaukimo sąlygas prieš pasirenkant.

Jūsų agentas gali rasti jūsų prieinamas Wink paskyras ir jų užsakymo konfigūracijas. Jei jų yra kelios, nurodykite, kurią naudoti. Jei užsakote per pateiktą užsakymo nuorodą ar konfigūraciją, vietoje to duokite ją agentui.

Agentas tada nustato jūsų kelionės tikslą, tikrina prieinamus viešbučius ir įkelia kambarių kainas jūsų datoms. Pasirinkite kambarį ir paprašykite pasiūlymo.

Šis mokėjimo procesas šiuo metu palaiko vieną kambarį, kainuojantį USD, tik suaugusiems. Pasiūlymas turi galiojimo laiką. Jo užklausa neapmokestina ir nepatvirtina užsakymo.

3. Peržiūrėkite ir patvirtinkite mokėjimą

Patikrinkite viešbutį, kambarį, datas, svečius, atšaukimo sąlygas ir pasiūlytą bendrą sumą. Kai būsite pasiruošę, paprašykite agento užsakyti ir atlikti bet kokį jūsų piniginės reikalaujamą patvirtinimą.

Piniginė pateikia Stripe Shared Payment Token mokėjimui už pasiūlymą.

Tempo stablecoin mokėjimai netrukus bus prieinami.

Po sėkmingo mokėjimo jūsų agentas pateiks užsakymo patvirtinimo kodą. Jis taip pat gali gauti užsakymo duomenis ir kvitą per Booking Engine MCP.

Jei mokėjimas vis dar apdorojamas arba atsakymas prarastas, leiskite agentui patikrinti tą patį mokėjimo bandymą. Jis turėtų pakartotinai naudoti pasiūlymą ir mokėjimo duomenis, o ne pradėti antrą mokėjimą. Jei mokėjimas atmestas, paprašykite naujo pasiūlymo ir peržiūrėkite jį prieš bandydami dar kartą.

Įrankių nuoroda agentams ir kūrėjams

Visi žemiau pateikti Wink įrankiai yra prieinami per Booking Engine MCP. MCP klientas automatiškai siunčia autentifikaciją naudodamas prisijungimo metu patvirtintus leidimus.

Žingsnis	Įrankiai ir elgsena
Pasirinkite užsakymo kontekstą	managing_entity_list, tada customization_get_primary arba customization_search pasirinktoje paskyroje. Naudokite pateiktą pritaikymą, jei jis jau žinomas.
Raskite kelionės tikslą	destination_lookup_search_suggestions ir destination_lookup_get.
Ieškokite viešbučių ir kambarių	inventory_search_city arba inventory_search_geo, tada property_inventory_get kainoms ir prieinamumui.
Pasiūlykite pasirinktą kambarį	agentic_booking_quote. Pateikite kambario duomenis request argumente.
Mokėkite ir patvirtinkite	Gaukite Shared Payment Token iš prijungtos piniginės, tada kvieskite agentic_booking_pay su request.quoteId ir request.spt. Naudokite tą patį prisijungusį Wink vartotoją pasiūlymui ir mokėjimui.
Gaukite užsakymą ir kvitą	Naudokite booking_search arba booking_search_list, kad rastumėte patvirtintą užsakymą, tada booking_get ir booking_receipt_get su užsakymo identifikatoriumi.

Pasiūlymo užklausa reikalauja hotelIdentifier, roomRateIdentifier, checkIn, checkOut, adults, children ir customizationIdentifier. Datos turi būti formatu YYYY-MM-DD; checkOut turi būti vėlesnė už checkIn. Nustatykite adults bent 1 ir children 0.

Pasiūlymas grąžina quoteId, amountUsdCents, currency, expiresAt ir mppChallenges. Rodykite USD centus kaip dolerius: 10000 reiškia $100.00.

Mokėjimo rezultatas	Kitas žingsnis
PAYMENT_SUCCEEDED	Išsaugokite bookingConfirmationCode ir chargeReference.
IN_PROGRESS	Šiek tiek palaukite ir bandykite tą patį pasiūlymą ir duomenis dar kartą.
DECLINED	Paprašykite naujo pasiūlymo ir peržiūrėkite jį prieš dar vieną mokėjimą.

Sėkmingas pakartotinis bandymas grąžina esamą užsakymą be papildomo apmokestinimo. Laiko limitas laikomas nežinomu rezultatu ir leidžia pakartoti tą patį mokėjimą. Jei problema išlieka, susisiekite su palaikymu su pasiūlymo ID.

MCP klientai, palaikantys mokėjimus

Mokėjimus palaikantys MCP klientai gali naudoti agentic_booking_book su kambario laukais tiesiogiai arguments. Pirmas kvietimas grąžina klaidą -32042 su mokėjimo iššūkiais. Pakartokite tą patį kvietimą su piniginės duomenimis params._meta["org.paymentauth/credential"]; sėkmė apima result._meta["org.paymentauth/receipt"]. Klaida -32043 rodo mokėjimo nesėkmę ir iššūkį: galutinis atmetimas reikalauja naujo pasiūlymo, o nebaigtas mokėjimas gali būti pakartotas su tuo pačiu iššūkiu. Klaida -32603 su data.failure.reason payment-in-progress arba already-consumed reiškia pakartoti tą patį duomenų rinkinį; klaidos kodas vienas negana.

Užsakymas per REST

Naudokite REST, kai kuriate integraciją, kuri tiesiogiai kviečia Wink per HTTP. Tiek pasiūlymas, tiek mokėjimas naudoja POST https://api.wink.travel/api/mpp/booking.

Jūsų programai reikalingas Wink vartotojo prieigos žetonas su payment.write leidimu mokėjimui. Naudokite tą patį vartotoją abiem kvietimams. Siųskite žetoną Wink-Authorization antraštėje, palikdami Authorization piniginės mokėjimo duomenims. Šios antraštės taikomos REST; MCP klientas tvarko savo autentifikaciją.

1. Paprašykite pasiūlymo

Išsaugokite pasirinktą kambarį kaip booking.json, pakeisdami pavyzdinius identifikatorius ir datas savo pasirinkimu. Kambario laukai eina tiesiai į JSON kūną, be request apvalkalo.

{
  "hotelIdentifier": "JŪSŲ_VIEŠBUČIO_ID",
  "roomRateIdentifier": "JŪSŲ_KAMBARIO_KAINOS_ID",
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-17",
  "adults": 2,
  "children": 0,
  "customizationIdentifier": "JŪSŲ_PRITAIKYMO_ID"
}

Nustatykite WINK_ACCESS_TOKEN kaip vartotojo prieigos žetoną ir siųskite užklausą:

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 grąžina 402 Payment Required su WWW-Authenticate: Payment ... iššūkiu kiekvienam siūlomam metodui. JSON kūnas apima quoteId, amount, currency, expiresAt ir methods. Čia amount yra eilutė USD centais: "10000" reiškia $100.00. Peržiūrėkite pasiūlymą prieš jo galiojimo pabaigą; mokėjimas dar nebuvo atliktas.

2. Mokėkite ir patvirtinkite

Leiskite piniginei įvykdyti grąžintą Stripe iššūkį pateikdama Shared Payment Token payload.spt. Naudokite mokėjimo duomenis iš to iššūkio.

Nustatykite MPP_CREDENTIAL kaip piniginės užkoduotą MPP duomenų rinkinį, kuriame yra iššūkis ir mokėjimo duomenys. Pakartokite tą patį užklausos kūną, išlaikydami tapatybės antraštę:

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

Sėkmės atveju Wink grąžina 200 OK, JSON kūną su bookingConfirmationCode ir Payment-Receipt antraštę. Išsaugokite patvirtinimą ir kvitą. Sėkmingas pakartotinis bandymas grąžina esamą užsakymą be papildomo apmokestinimo.

Tvarkykite atsakymus ir pakartotinius bandymus

Atsakymas	Ką daryti
400	Pataisykite neteisingus kambario duomenis arba netinkamą duomenų rinkinį.
401 / 403	Patikrinkite vartotojo autentifikaciją ir mokėjimo leidimą.
402	Patikrinkite grąžintą problemą ir iššūkį. Galutinis mokėjimo atmetimas reikalauja naujo pasiūlymo; nebaigtas mokėjimo duomenų rinkinys naudoja originalų iššūkį. Peržiūrėkite kainą prieš mokėdami.
409	Mokėjimo rezultatas neaiškus. Šiek tiek palaukite, tada pakartokite tą patį kūną ir duomenis užsakymo pabaigoje.
429	Palaukite nurodytą sekundžių skaičių Retry-After, tada bandykite dar kartą.

409 atsakyme yra application/problem+json kūnas. Palyginkite jo type su šiomis tiksliomis nuorodomis:

Problemų tipas	Reikšmė
https://api.wink.travel/problems/payment-in-progress	Mokėjimo bandymas vis dar vyksta arba atsiskaitymas dar negali būti patvirtintas.
https://api.wink.travel/problems/already-consumed	Iššūkis arba mokėjimo įrodymas jau buvo panaudotas galimai sėkmingam bandymui. Tai savaime nepatvirtina užsakymo.

Abu reiškia pakartokite tą patį mokėjimą; nemokėkite už naują pasiūlymą. Nuorodos identifikuoja ir dokumentuoja problemą; jos nėra mokėjimo ar užklausų pabaigos taškai. Pakartokite POST /api/mpp/booking ir naudokite problemos type, o ne laisvą tekstą detail, kad nuspręstumėte, ką daryti. Žr. problemų tipų nuorodą visoms Wink mokėjimo problemoms.

Laiko limitas, prarastas atsakymas ar serverio klaida po mokėjimo pateikimo taip pat gali palikti rezultatą nežinomą. Pakartokite tą patį mokėjimo užklausą. Jei rezultatas lieka neaiškus, susisiekite su palaikymu su pasiūlymo ID prieš pradėdami kitą mokėjimą.