Samþætting við TripPay
Þessi grein inniheldur ítarlegt dæmi um hvernig á að samþætta við TripPay.
Það er mælt með því að þú hafir þegar lesið:
- Greiðsla > Kortlagning.
- Greiðsla > Samþætting.
- Greiðsluvefþáttur.
- Greiðslu-API.Lestu kaflann um
Create payable contracts
Hér eru skrefin til að nota TripPay til að greiða fyrir bókun:
- Gakktu úr skugga um að rétthafarnir sem þú nefnir í bókunarsamningnum hafi verið kortlagðir.
- Leyfðu ferðalangnum að velja þá geymslu sem hann vill bóka og láttu hann undirbúa greiðslu.
- Búa til
payable contract
með TripPay sem inniheldur vörurnar sem á að bóka. - Láttu ferðalanginn greiða með TripPay vefþáttinum.
Við gerum ráð fyrir að þú hafir þegar lokiðStep 1
ogStep 2
og eru tilbúin að láta TripPay vita af bókuninni.
Stofna greiðslusamning
Section titled “Stofna greiðslusamning”:::athugið Farið í greiðsluforritaskilið til að fá frekari upplýsingar um kröfur til að búa til greiðslusamning. :::
Beiðni
Section titled “Beiðni”Hér er dæmi um JSON-beiðni sem inniheldur allt sem þú þarft til að búa til fyrir fyrsta greiðslusamninginn þinn.
{ "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" } ] } ] } ]}
Útskýring:
Við munum ekki útskýra alla gagnapunkta hér þar sem þeir eru þegar fjallaðir um í API-skjölunum.
- Línur:2 - 7er notandinn sem ber ábyrgð á bókuninni. Það eru tvær gerðir bókara:
- Ferðamaður.
- Ferðaskrifstofa.
- Línur:8 - 9Er TripPay reikningurinn sem sér um bókunina? Það getur verið:
- TripPay samþættingarreikningurinn þinn.
- Ef þú rekur samstarfsnet getur það verið samstarfsnetið þitt.
- Notaðu
traceId
til að flokka margar bókanir hjá mörgum birgjum. Þannig er hægt að hætta við hópbókun. redirectUrl
lætur TripPay vita á hvaða síðu á að beina eftir að greiðsla er lokið.sourceUrl
er síðan/appið sem bókunin fór fram á.
HinncontractList
Fylki inniheldur vöruna/vörurnar sem ferðamaðurinn vill kaupa frá mörgum birgjum. Hver vara inniheldur:
- Hinn
identifier
er gilt UUID sem þú býrð til. - Birgirinn sem þú vilt bóka birgðir frá.
- Birgðirnar sem þú vilt bóka frá þeim birgja. Þetta er allt tilgreint í innfelldu fylkinu.
contractItemList
. - Sérhver færsla undir
contractItemList
inniheldur:- GestirÞetta er notandinn sem mun koma á staðinn.
- Nafn á enskuHeiti birgðarinnar á ensku.
- Lýsing á enskuLengri lýsing á birgðunum á ensku.
- VerðVerð hlutarins.
- FerðaáætlunHvenær á að bóka þennan hlut.
- VerðlagningartegundHvernig verðið var reiknað út.
- Tegund birgðaHvers konar birgðir þetta eru.
- GreiðanlegtHvenær á að rukka ferðamanninn.Við styðjum aðeins tafarlausar greiðslur eins og er.
- StefnaHafa með reglur um afpöntunarstefnu.
- Dagleg verðlistiEf varan sem verið er að bóka er herbergi, getur þú valið að taka með kostnaðinn við herbergið fyrir hverja nótt sem gesturinn dvelur.
- RétthafarTakið með hvaða TripPay reikning(ar) á að fá úthlutað hvaða upphæð(ir) af verði vörunnar.Fastar upphæðir / prósentuupphæðir eru studdar.
:::athugið Í JSON dæminu hér að ofan höfum við þrjá rétthafa:
- 1,5% var úthlutað til þess kerfis sem gerði bókunina mögulega.t.d. Wink
- 9,85% var úthlutað til samstarfsaðilans sem þóknun.t.d. Kim Kardashian
- 88,65% fengu úthlutað birgjanum fyrir bókun herbergisins.t.d. Hilton
Þegar TripPay svarar með greiðslusamningi, munt þú taka eftir því að það lagði inn 4,0% innborgun til eigin rétthafa. :::
Þegar TripPay svarar beiðni þinni mun það líta svona út:
[ { "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" } }]
Vistaid
í línu 3. Þú munt nota þetta til að sprauta inn í TripPay vefþáttinn.
Innfella TripPay
Section titled “Innfella TripPay”:::athugið Gakktu úr skugga um að þú hafir hlaðið inn stílunum okkar og Javascript fyrirfram. :::
Á þessum tímapunkti ertu tilbúinn að fella innPayment Web Component
inn á vefsíðuna þína og sýna það notandanum.
<trip-pay id="contract-1"></trip-pay>
Hvað samþættingu varðar, þá er það allt sem þú þarft að gera. TripPay sér um allt erfiða verkið héðan í frá.