Integrācija ar TripPay
Šajā rakstā ir sniegts pilnīgs piemērs tam, kā integrēties ar TripPay.
Ieteicams jau izlasīt:
- Maksājums > Kartēšana.
- Maksājums > Integrācija.
- Maksājumu tīmekļa komponents.
- Maksājumu API.Izlasiet sadaļu par
Create payable contracts
Lai veiksmīgi izmantotu TripPay rezervācijas apmaksai, veiciet tālāk norādītās darbības.
- Pārliecinieties, ka rezervēšanas līgumā minētie labuma guvēji ir kartēti.
- Ļaujiet ceļotājam izvēlēties inventāru, ko viņš vēlas rezervēt, un sagatavojieties maksāšanai.
- Izveidot
payable contract
ar TripPay, kurā ir norādītas rezervējamās preces. - Ļaujiet ceļotājam norēķināties, izmantojot TripPay tīmekļa komponentu.
Mēs pieņemam, ka jūs jau esat pabeidzisStep 1
unStep 2
un ir gatavi informēt TripPay par rezervāciju.
Izveidojiet apmaksātu līgumu
Section titled “Izveidojiet apmaksātu līgumu”:::piezīme Lai uzzinātu vairāk par maksājama līguma izveides prasībām, apmeklējiet Maksājumu API. :::
Pieprasījums
Section titled “Pieprasījums”Šeit ir JSON parauga pieprasījums, kurā ir iekļauts viss nepieciešamais, lai izveidotu savu pirmo apmaksājamo līgumu.
{ "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" } ] } ] } ]}
Paskaidrojums:
Mēs šeit nepaskaidrosim katru datu punktu, jo tie jau ir aplūkoti API dokumentācijā.
- Līnijas:2–7ir lietotājs, kas ir atbildīgs par rezervāciju. Ir divu veidu rezervētāji:
- Ceļotājs.
- Ceļojumu aģents.
- Līnijas:8.–9.ir TripPay konts, kas nodrošina rezervāciju. Tas var būt:
- Jūsu TripPay integratora konts.
- Ja jūs pārvaldāt saistīto uzņēmumu tīklu, tas var būt jūsu saistītais uzņēmums.
- Izmantojiet
traceId
lai grupētu vairākas rezervācijas vairākiem piegādātājiem. Tādā veidā jūs varat atcelt grupas rezervāciju. redirectUrl
ļauj TripPay zināt, uz kuru lapu pāradresēt pēc maksājuma pabeigšanas.sourceUrl
ir vietne/lietotne, kurā tika veikta rezervācija.
ThecontractList
Masīvs satur preces, ko ceļotājs vēlas iegādāties no vairākiem piegādātājiem. Katra prece satur:
- The
identifier
ir derīgs jūsu ģenerēts UUID. - Piegādātājs, no kura vēlaties rezervēt krājumus.
- Inventārs, kuru vēlaties rezervēt no šī piegādātāja. Tas viss ir norādīts ligzdotajā masīvā.
contractItemList
. - Katrs ieraksts zem
contractItemList
satur:- VieslietotājsŠis ir lietotājs, kurš ieradīsies telpās.
- Vārds angļu valodāInventāra nosaukums angļu valodā.
- Apraksts angļu valodāGarāks inventāra apraksts angļu valodā.
- CenaPreces cena.
- MaršrutsKad šī prece ir jārezervē.
- Cenu veidsKā tika aprēķināta cena.
- Krājumu veidsKāda veida inventārs tas ir?
- MaksājamsKad ceļotājam būtu jāiekasē maksa.Pašlaik mēs atbalstām tikai tūlītējas apmaksas iespējas.
- PolitikaIekļaujiet atcelšanas politikas noteikumus.
- Dienas cenrādisJa rezervējamais vienums ir istaba, varat izvēlēties iekļaut istabas cenu par katru viesa uzturēšanās nakti.
- SaņēmējiNorādiet, kuram(-iem) TripPay kontam(-iem) jāpiešķir kāda(-s) preces cenas summa(-s).Tiek atbalstītas fiksētas/procentuālas summas.
:::piezīme Iepriekš minētajā JSON piemērā mums ir 3 saņēmēji:
- 1,5% tika piešķirti platformai, kas veicināja rezervāciju.piem., Wink
- 9,85% tika piešķirti filiālei kā komisija.piemēram, Kima Kardašjana
- 88,65% tika piešķirti piegādātājam istabas rezervēšanai.piem., Hiltons
Kad TripPay atbildēs ar apmaksātu līgumu, jūs ievērosiet, ka tas ir iepludinājis savu saņēmēju 4,0% apmērā. :::
Atbilde
Section titled “Atbilde”Kad TripPay atbildēs uz jūsu pieprasījumu, tas izskatīsies apmēram šādi:
[ { "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" } }]
Saglabātid
3. rindā. Jūs to izmantosiet, lai ievadītu TripPay tīmekļa komponentā.
Iegult TripPay
Section titled “Iegult TripPay”Šajā brīdī jūs esat gatavs iegultPayment Web Component
savā tīmekļa vietnē un parādiet to lietotājam.
<trip-pay id="contract-1"></trip-pay>
Kas attiecas uz integrāciju, tas ir viss, kas jums jādara. Visu smago darbu turpmāk veic TripPay.