Agentiskie maksājumi
Jūs varat meklēt viesnīcu, izvēlēties numuru un pabeigt rezervāciju caur savu AI aģentu. Pieslēdziet to Wink un maksājumu maku, pēc tam norādiet, kur vēlaties uzturēties. Wink izmanto Machine Payments Protocol (MPP), lai pieņemtu maksājumu no maka un atgrieztu jūsu rezervācijas apstiprinājumu.
1. Pieslēdziet MCP serverus
Section titled “1. Pieslēdziet MCP serverus”Pilnam rezervācijas procesam jūsu aģentam nepieciešams Wink Booking Engine un maksājumu maks.
| Savienojums | Ko tas dara | Kā to pievienot |
|---|---|---|
| Wink Booking Engine — obligāts | Atrod galamērķus, meklē viesnīcas un numuru cenas, sniedz piedāvājumus un apstiprina rezervācijas, kā arī izgūst jūsu rezervācijas un kvītis. | Pievienojiet https://api.wink.travel/mcp/booking-engine kā attālo HTTP MCP serveri. |
| Maksājumu maks — nepieciešams maksāšanai | Nodrošina maksājuma akreditācijas datus pēc jūsu pirkuma apstiprināšanas. | Pieslēdziet maku, kas atbalsta Stripe Shared Payment Tokens. Skatiet zemāk esošo Link piemēru. |
| Wink Reference — izvēles | Meklē valstis, valūtas un citus atsauces datus. | https://api.wink.travel/mcp/reference |
| Wink Docs — izvēles | Palīdz jūsu aģentam lasīt dokumentāciju un API līgumus. | https://docs.mcp.wink.travel/mcp |
Booking Engine MCP jau ietver rīkus ceļotāja rezervācijas plūsmai, kad šajā vidē ir iespējota agentiskā rezervācija un maksājums. Wink atsevišķais Payment MCP ir paredzēts finanšu operācijām, piemēram, grāmatvedībai un izņemšanai; tas nav nepieciešams, lai samaksātu par numuru.
Piesakieties un izvēlieties atļaujas
Section titled “Piesakieties un izvēlieties atļaujas”- Atveriet sava aģenta MCP vai savienotāja iestatījumus un pievienojiet Booking Engine URL, kas norādīts augstāk. Dodiet tam nosaukumu, piemēram, Wink Booking.
- Jūsu aģents atver Wink pieslēgšanās lapu jūsu pārlūkprogrammā. Piesakieties ar to Wink kontu, ar kuru vēlaties veikt rezervāciju.
- Piešķiršanas ekrānā izvēlieties atļaujas, kas nepieciešamas jūsu aģentam, un apstipriniet savienojumu.
- Atgriezieties pie sava aģenta. Tas ielādē pieejamos rīkus un pārvalda autentifikāciju turpmākajiem MCP zvaniem.
Šai plūsmai izvēlieties:
| Atļauja | Kāpēc tā ir nepieciešama |
|---|---|
AI aģenta piekļuve (mcp.read) | Ļauj jūsu aģentam pieslēgties Wink MCP. |
Mārketinga lasīšana (marketing.read) | Ļauj aģentam atrast jūsu konta rezervācijas konfigurāciju, ko sauc par pielāgojumu. Jūsu kontam arī jābūt piekļuvei šai konfigurācijai. |
Maksājumu rakstīšana (payment.write) | Ļauj aģentam samaksāt par piedāvājumu un apstiprināt rezervāciju. |
Saglabājiet pieslēgšanās pieprasītās atļaujas. Jūsu MCP klients automātiski pārvalda piekļuves tokenus; jums nav jāielīmē tokens čatā vai jāiestata pieprasījuma galvenes. Ja izlaidāt nepieciešamo atļauju, pieslēdzieties atkārtoti caur sava klienta pieslēgšanās plūsmu un apstipriniet to.
Pieslēdziet maksājumu maku
Section titled “Pieslēdziet maksājumu maku”Stripe maksājumiem viena no iespējām ir Link aģenta maks. Ja jūsu klients atbalsta lokālos MCP serverus un Node.js ir instalēts, pievienojiet šo ierakstu tā MCP konfigurācijā:
{ "mcpServers": { "link": { "command": "npx", "args": ["@stripe/link-cli", "--mcp"] } }}Lūdziet savam aģentam pieslēgt jūsu Link kontu, pēc tam sekojiet tam sniegtajai verifikācijas saitei un apstipriniet savienojumu. Link nodrošina Shared Payment Token, kas tiek izmantots maksājumam par rezervāciju. Pašlaik Link atbalsta ASV kontus; pirms rezervēšanas pārbaudiet tā izdevumu limitus. Skatiet Link iestatīšanas rokasgrāmatu un MCP konfigurāciju.
Ja jūsu aģentam jau ir pieslēgts saderīgs maksājumu maks, izmantojiet šo savienojumu. Maka iestatīšana un maksājuma apstiprināšana ir atsevišķi no pieslēgšanās Wink.
2. Lūdziet aģentam atrast numuru
Section titled “2. Lūdziet aģentam atrast numuru”Piemēram:
Atrodi numuru Bangkokā diviem pieaugušajiem no 2027. gada 15. līdz 17. janvārim. Parādi man pieejamās iespējas, kopējo cenu un atcelšanas noteikumus pirms izvēlos.
Jūsu aģents var atrast jūsu pieejamos Wink kontus un to rezervācijas konfigurācijas. Ja jums ir vairāki, norādiet, kuru izmantot. Ja rezervējat caur piegādātu rezervācijas saiti vai konfigurāciju, dodiet to aģentam.
Pēc tam aģents noskaidro jūsu galamērķi, pārbauda pieejamās viesnīcas un ielādē numuru cenas jūsu datumiem. Izvēlieties numuru un lūdziet piedāvājumu.
Šī maksājumu plūsma pašlaik atbalsta vienu numuru, cenu USD, tikai pieaugušajiem. Piedāvājumam ir derīguma termiņš. Pieprasot to, jums netiek iekasēta maksa un rezervācija netiek apstiprināta.
3. Pārskatiet un apstipriniet maksājumu
Section titled “3. Pārskatiet un apstipriniet maksājumu”Pārbaudiet viesnīcu, numuru, datumus, viesus, atcelšanas noteikumus un piedāvāto kopējo summu. Kad esat gatavs, lūdziet aģentam veikt rezervāciju un pabeigt jebkuru maka pieprasīto apstiprinājumu.
Maksājumu maks nodrošina Stripe Shared Payment Token, lai samaksātu par piedāvājumu.
Tempo stablecoin maksājumi drīzumā būs pieejami.
Pēc veiksmīgas maksājuma apstrādes jūsu aģents sniedz jums rezervācijas apstiprinājuma kodu. Tas var arī izgūt rezervācijas detaļas un kvīti caur Booking Engine MCP.
Ja maksājums joprojām tiek apstrādāts vai atbilde ir pazudusi, ļaujiet aģentam pārbaudīt to pašu maksājuma mēģinājumu. Tam jāizmanto atkārtoti piedāvājums un maksājuma akreditācijas dati, nevis jāuzsāk otrais maksājums. Ja maksājums tiek noraidīts, lūdziet jaunu piedāvājumu un pārskatiet to pirms mēģināt vēlreiz.
Rīku atsauce aģentiem un izstrādātājiem
Section titled “Rīku atsauce aģentiem un izstrādātājiem”Visi zemāk esošie Wink rīki ir pieejami caur Booking Engine MCP. MCP klients automātiski nosūta autentifikāciju, izmantojot pieslēgšanās laikā apstiprinātās atļaujas.
| Solis | Rīki un darbības |
|---|---|
| Izvēlieties rezervācijas kontekstu | managing_entity_list, pēc tam customization_get_primary vai customization_search izvēlētajam kontam. Izmantojiet piegādātu pielāgojumu, ja tas jau ir zināms. |
| Atrodiet galamērķi | destination_lookup_search_suggestions un destination_lookup_get. |
| Meklējiet viesnīcas un numurus | inventory_search_city vai inventory_search_geo, pēc tam property_inventory_get cenu un pieejamības pārbaudei. |
| Piedāvājiet izvēlēto numuru | agentic_booking_quote. Nododiet numura datus tā request argumentā. |
| Maksājiet un apstipriniet | Iegūstiet Shared Payment Token no pieslēgtā maka, pēc tam izsauciet agentic_booking_pay ar request.quoteId un request.spt. Izmantojiet to pašu pieslēgušos Wink lietotāju piedāvājumam un maksājumam. |
| Izgūstiet rezervāciju un kvīti | Izmantojiet booking_search vai booking_search_list, lai atrastu apstiprināto rezervāciju, pēc tam booking_get un booking_receipt_get ar rezervācijas identifikatoru. |
Piedāvājuma pieprasījumam nepieciešams hotelIdentifier, roomRateIdentifier, checkIn, checkOut, adults, children un customizationIdentifier. Datumi jānorāda formātā YYYY-MM-DD; checkOut jābūt pēc checkIn. Iestatiet adults vismaz uz 1 un children uz 0.
Piedāvājums atgriež quoteId, amountUsdCents, currency, expiresAt un mppChallenges. Rādiet USD centus kā dolārus: 10000 nozīmē $100.00.
| Maksājuma rezultāts | Nākamais solis |
|---|---|
PAYMENT_SUCCEEDED | Saglabājiet bookingConfirmationCode un chargeReference. |
IN_PROGRESS | Nedaudz pagaidiet un mēģiniet atkārtoti ar to pašu piedāvājumu un akreditāciju. |
DECLINED | Pieprasiet jaunu piedāvājumu un pārskatiet to pirms nākamā maksājuma. |
Veiksmīga atkārtota mēģinājuma gadījumā tiek atgriezta esošā rezervācija bez atkārtotas iekasēšanas. Laika pārsniegšanu uzskatiet par nezināmu iznākumu un mēģiniet atkārtoti ar to pašu maksājumu. Ja tas paliek neatrisināts, sazinieties ar atbalstu, norādot piedāvājuma ID.
Maksājumu atbalstoši MCP klienti
Section titled “Maksājumu atbalstoši MCP klienti”Maksājumu atbalstoši MCP klienti var izmantot agentic_booking_book ar numura laukiem tieši arguments. Pirmais zvans atgriež kļūdu -32042 ar maksājuma izaicinājumiem. Mēģiniet atkārtoti ar to pašu zvanu, iekļaujot maka akreditāciju params._meta["org.paymentauth/credential"]; veiksmīgs zvans satur result._meta["org.paymentauth/receipt"]. Kļūda -32043 satur maksājuma neveiksmi un izaicinājumu: galīga noraidīšana prasa jaunu piedāvājumu, bet nepilnīgs maksājuma saturs var mēģināt atkārtoti ar to pašu izaicinājumu. Kļūdas -32603 gadījumā data.failure.reason ar vērtību payment-in-progress vai already-consumed nozīmē atkārtotu mēģinājumu ar to pašu akreditāciju; tikai kļūdas kods nav pietiekams.
Rezervācija caur REST
Section titled “Rezervācija caur REST”Izmantojiet REST, veidojot integrāciju, kas tieši zvana Wink pa HTTP. Gan piedāvājums, gan maksājums izmanto POST https://api.wink.travel/api/mpp/booking.
Jūsu lietotnei nepieciešams Wink lietotāja piekļuves tokens ar payment.write atļauju maksāšanai. Izmantojiet to pašu lietotāju abiem zvaniem. Sūtiet tokenu galvenē Wink-Authorization, atstājot Authorization maka maksājuma akreditācijai. Šie galvenes attiecas uz REST; MCP klients pārvalda savu autentifikāciju.
1. Pieprasiet piedāvājumu
Section titled “1. Pieprasiet piedāvājumu”Saglabājiet izvēlēto numuru kā booking.json, aizstājot piemēra identifikatorus un datumus ar jūsu izvēli. Numura lauki jāievieto tieši JSON ķermenī, bez request ietvara.
{ "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"}Iestatiet WINK_ACCESS_TOKEN uz lietotāja piekļuves tokenu un nosūtiet pieprasījumu:
curl -i https://api.wink.travel/api/mpp/booking \ -H "Wink-Authorization: Bearer $WINK_ACCESS_TOKEN" \ -H 'Content-Type: application/json' \ --data-binary @booking.jsonWink atgriež 402 Payment Required ar WWW-Authenticate: Payment ... izaicinājumu katrai piedāvātajai metodei. JSON ķermenī ir quoteId, amount, currency, expiresAt un methods. Šeit amount ir virkne USD centos: "10000" nozīmē $100.00. Pārskatiet piedāvājumu pirms tā derīguma termiņa; maksājums vēl nav veikts.
2. Maksājiet un apstipriniet
Section titled “2. Maksājiet un apstipriniet”Ļaujiet makam izpildīt atgriezto Stripe izaicinājumu, nodrošinot Shared Payment Token payload.spt. Izmantojiet maksājuma datus no šī izaicinājuma.
Iestatiet MPP_CREDENTIAL uz maka kodēto MPP akreditāciju, kas satur izaicinājumu un maksājuma saturu. Mēģiniet atkārtoti ar to pašu pieprasījuma ķermeni, saglabājot identitātes galveni:
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.jsonVeiksmīgas atbildes gadījumā Wink atgriež 200 OK, JSON ķermeni ar bookingConfirmationCode un galveni Payment-Receipt. Saglabājiet apstiprinājumu un kvīti. Veiksmīga atkārtota mēģinājuma gadījumā tiek atgriezta esošā rezervācija bez atkārtotas iekasēšanas.
Apstrādājiet atbildes un atkārtotus mēģinājumus
Section titled “Apstrādājiet atbildes un atkārtotus mēģinājumus”| Atbilde | Ko darīt |
|---|---|
400 | Labojiet nederīgus numura datus vai nepareizu akreditāciju. |
401 / 403 | Pārbaudiet lietotāja autentifikāciju un maksājumu atļauju. |
402 | Pārskatiet atgriezto problēmu un izaicinājumu. Galīga maksājuma noraidīšana prasa jaunu piedāvājumu; nepilnīgs maksājuma saturs atkārtoti izmanto sākotnējo izaicinājumu. Pārskatiet cenu pirms maksāšanas. |
409 | Maksājuma iznākums nav atrisināts. Nedaudz pagaidiet, pēc tam mēģiniet atkārtoti ar to pašu ķermeni un akreditāciju rezervācijas galapunktā. |
429 | Pagaidiet tik sekundes, cik norādīts Retry-After, pēc tam mēģiniet atkārtoti. |
409 atbilde satur application/problem+json ķermeni. Salīdziniet tā type ar šīm precīzajām URL:
| Problēmas veids | Nozīme |
|---|---|
| https://api.wink.travel/problems/payment-in-progress | Maksājuma mēģinājums joprojām notiek vai norēķins vēl nav apstiprināts. |
| https://api.wink.travel/problems/already-consumed | Izaicinājums vai maksājuma pierādījums jau tika izmantots iespējami veiksmīgā mēģinājumā. Tas vien neapstiprina rezervāciju. |
Abi nozīmē atkārtoti mēģiniet to pašu maksājumu; nemaksājiet jaunu piedāvājumu. URL identificē un dokumentē problēmu; tie nav maksājumu vai aptaujas galapunkti. Mēģiniet atkārtoti POST /api/mpp/booking un izmantojiet problēmas type, nevis brīvteksta detail, lai izlemtu, ko darīt. Skatiet problēmu veidu atsauci visām Wink maksājumu problēmām.
Laika pārsniegšana, atbildes zudums vai servera kļūda pēc maksājuma iesniegšanas var arī atstāt iznākumu nezināmu. Mēģiniet atkārtoti to pašu maksājuma pieprasījumu. Ja iznākums paliek neatrisināts, sazinieties ar atbalstu, norādot piedāvājuma ID, pirms sākat citu maksājumu.