Integrointi TripPayn kanssa
Tämä artikkeli sisältää kokonaisvaltaisen esimerkin TripPayn integroinnista.
On suositeltavaa, että olet jo lukenut:
- Maksu > Yhdistämistiedot.
- Maksu > Integraatio.
- Maksuverkkokomponentti.
- Maksu-API.Lue osio aiheesta
Create payable contracts
Tässä ovat vaiheet TripPayn käyttämiseen varauksen maksamiseen:
- Varmista, että varaussopimuksessa mainitsemasi edunsaajat on kartoitettu.
- Anna matkustajan valita varattavat palvelut ja valmistautua maksamaan.
- Luo
payable contract
TripPaylla, joka sisältää varattavat tuotteet. - Anna matkustajan maksaa TripPay-verkkokomponentin avulla.
Oletamme, että olet jo suorittanutStep 1
jaStep 2
ja ovat valmiita ilmoittamaan TripPaylle varauksesta.
Luo maksullinen sopimus
Section titled “Luo maksullinen sopimus”Pyytää
Section titled “Pyytää”Tässä on JSON-näytepyyntö, joka sisältää kaiken tarvittavan ensimmäisen maksullisen sopimuksesi luomiseen.
{ "user": { "userIdentifier": "191d5729-0b90-4000-85df-1bea7a6e9a01", "firstName": "John", "lastName": "Smith", }, "affiliateAccountIdentifier": "291d5729-0b91-4001-95df-2bec7a6e9a01", "affiliateAccountIdentifierType": "INTERNAL", "displayCurrency": "USD", "traceId": "trace-1", "redirectUrl": "/thank-you", "sourceUrl": "https://www.travel.com", "contractList": [ { "identifier": "191d5729-0b90-4000-8298-72431beb1701", "supplierIdentifier": "191d5729-0b90-4000-8b72-58186a642401", "supplierIdentifierType": "EXTERNAL", "contractItemList": [ { "user": { "userIdentifier": "191d5729-0b90-4000-8596-ed18f9876801", "firstName": "John", "lastName": "Smith", "telephone": "+1 212 555 1212", }, "nameInEnglish": "Deluxe King", "descriptionInEnglish": "This is the best deluxe king that money can buy.", "price": { "amount": 100, "currency": "USD" }, "itinerary": { "startDate": "2024-12-24T00:00:00.000Z", "endDate": "2024-12-25T00:00:00.000Z", "adults": 2 }, "pricingType": "PER_STAY", "type": "LODGING", "payable": "PREPAY", "policy": { "refundable": true }, "externalIdentifier": "room-type-1", "dailyRateList": [ { "date": "2024-12-24", "price": { "amount": 100, "currency": "USD" } } ], "beneficiaryList": [ { "identifier": "account-0", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.015 }, "type": "PLATFORM_FEE" }, { "identifier": "account-1", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.0985 }, "type": "COMMISSION" }, { "identifier": "account-2", "identifierType": "INTERNAL", "amountDue": { "type": "PERCENTAGE", "percent": 0.8865 }, "type": "SALE" } ] } ] } ]}
Selitys:
Emme selitä tässä kaikkia datapisteitä, koska ne on jo käsitelty API-dokumentaatiossa.
- Rivit:2–7on varauksesta vastaava käyttäjä. Varauksen tekijöitä on kahdenlaisia:
- Matkustaja.
- Matkatoimisto.
- Rivit:8–9on TripPay-tili, joka mahdollistaa varauksen tekemisen. Se voi olla:
- TripPay-integraattoritilisi.
- Jos ylläpidät kumppanuusverkostoa, se voi olla sinun kumppanuutesi.
- Käytä
traceId
ryhmitellä useita varauksia useille eri toimittajille. Tällä tavoin voit peruuttaa ryhmävarauksen. redirectUrl
kertoo TripPaylle, mille sivulle maksun suorittamisen jälkeen ohjataan.sourceUrl
on sivusto/sovellus, jolla varaus tehtiin.
ThecontractList
taulukko sisältää tuotteet, jotka matkustaja haluaa ostaa useilta toimittajilta. Jokainen tuote sisältää:
- The
identifier
on luomasi kelvollinen UUID. - Toimittaja, jolta haluat varata varaston.
- Varasto, jonka haluat varata kyseiseltä toimittajalta. Nämä kaikki on määritelty sisäkkäisessä taulukossa.
contractItemList
. - Jokainen merkintä alla
contractItemList
sisältää:- VieraskäyttäjäTämä on käyttäjä, joka saapuu tiloihin.
- Nimi englanniksiVaraston nimi englanniksi.
- Kuvaus englanniksiPidempi kuvaus varastosta englanniksi.
- HintaTuotteen hinta.
- MatkasuunnitelmaMilloin tämä kohde tulisi varata.
- HinnoittelutyyppiMiten hinta laskettiin.
- VarastotyyppiMinkä tyyppinen varasto tämä on?
- MaksettavaMilloin matkustajalta pitäisi periä maksu.Tuemme tällä hetkellä vain välittömiä maksuvaihtoehtoja.
- KäytäntöSisällytä peruutusehdot.
- PäivähintalistaJos varattava kohde on huone, voit valita, kuinka paljon kyseinen huone maksaa kultakin vieraan yöpymiseltä.
- EdunsaajatSisällytä kenttään, mille TripPay-tilille/-tileille tuotteen hinta tulisi kohdistaa.Kiinteitä/prosenttisesti määrät ovat tuettuja.
Yllä olevassa JSON-esimerkissä meillä on kolme edunsaajaa:
- 1,5 % kohdennettiin alustalle, joka mahdollisti varauksen.esim. Wink
- 9,85 % kohdennettiin tytäryhtiölle provisioina.esim. Kim Kardashian
- Huoneen varauksesta toimittajalle osoitettiin 88,65 %.esim. Hilton
Kun TripPay vastaa maksusopimuksella, huomaat, että se on lisännyt oman edunsaajansa 4,0 %.
Vastaus
Section titled “Vastaus”Kun TripPay vastaa pyyntöösi, se näyttää suunnilleen tältä:
[ { "id": "contract-1", "traceId": "trace-1", "supplierContractIdentifier": "191d5729-0b90-4000-8298-72431beb1701", "supplierIdentifier": "191d5729-0b90-4000-8b72-58186a642401", "supplierName": "Hilton", "totalPrice": { "amount": 100, "currency": "USD" }, "totalDisplayPrice": { "amount": 100, "currency": "USD" }, "totalSupplierPrice": { "amount": 100, "currency": "USD" }, "totalInternalPrice": { "amount": 100, "currency": "USD" }, "totalCapturePrice": { "amount": 100, "currency": "USD" } }]
Tallennaid
rivillä 3. Käytät tätä syöttääksesi sen TripPay-verkkokomponenttiin.
Upota TripPay
Section titled “Upota TripPay”Tässä vaiheessa olet valmis upottamaanPayment Web Component
verkkosivustollesi ja näytä se käyttäjälle.
<trip-pay id="contract-1"></trip-pay>
Integraation osalta se on kaikki mitä sinun tarvitsee tehdä. TripPay tekee kaiken raskaan työn tästä eteenpäin.