Pagsasama sa TripPay
Ang artikulong ito ay naglalaman ng isang end-to-end na halimbawa ng kung paano isama sa TripPay.
Inirerekomenda na nabasa mo na ang:
- Pagbabayad > Pagma-map.
- Pagbabayad > Pagsasama.
- Web Component ng Pagbabayad.
- API ng Pagbabayad. Basahin ang seksyon sa
Create payable contracts
Narito ang mga hakbang upang matagumpay na magamit ang TripPay upang magbayad para sa isang booking:
- Siguraduhin na ang mga benepisyaryo na iyong binanggit sa kontrata sa pagpapareserba ay na-map.
- Hayaang piliin ng manlalakbay ang imbentaryo na gusto niyang i-book at ihanda silang magbayad.
- Lumikha ng a
payable contract
gamit ang TripPay na naglalaman ng mga item na ibi-book. - Hayaang magbayad ang manlalakbay gamit ang TripPay Web Component.
Ipinapalagay namin na nakumpleto mo na Step 1
at Step 2
at handang ipaalam sa TripPay ang tungkol sa booking.
Lumikha ng kontrata na maaaring bayaran
Section titled “Lumikha ng kontrata na maaaring bayaran”Pumunta sa Payment API para matuto pa tungkol sa mga kinakailangan para gumawa ng kontratang babayaran.
Kahilingan
Section titled “Kahilingan”Narito ang isang sample na kahilingan ng JSON na kasama ang lahat ng kailangan mong gawin para sa iyong unang kontratang babayaran.
{ "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" } ] } ] } ]}
Paliwanag:
Hindi namin ipapaliwanag ang bawat punto ng data dito dahil sakop na ang mga ito sa mga doc ng API.
- Mga linya: 2 - 7 ay ang user na responsable para sa booking. Mayroong dalawang uri ng booker:
- Manlalakbay.
- Ahente sa paglalakbay.
- Mga linya: 8 - 9 ay ang TripPay account na nagpapadali sa booking. Maaari itong maging:
- Ang iyong TripPay integrator account.
- Kung nagpapatakbo ka ng isang kaakibat na network, maaari itong maging kaakibat mo.
- Gumamit ng a
traceId
upang igrupo ang maraming booking sa maraming supplier. Sa ganitong paraan maaari mong kanselahin ang isang group booking. redirectUrl
nagpapaalam sa TripPay kung aling pahina ang ire-redirect pagkatapos makumpleto ang pagbabayad.sourceUrl
ay ang site / app kung saan naganap ang booking.
Ang contractList
Ang array ay naglalaman ng (mga) item na gustong bilhin ng manlalakbay mula sa maraming supplier. Ang bawat item ay naglalaman ng:
- Ang
identifier
ay isang wastong UUID na iyong nabuo. - Ang supplier kung saan mo gustong mag-book ng imbentaryo.
- Ang imbentaryo na gusto mong i-book mula sa supplier na iyon. Ang lahat ng ito ay tinukoy sa nested array
contractItemList
. - Bawat entry sa ilalim
contractItemList
naglalaman ng:- Guest user Ito ang user na darating sa lugar.
- Pangalan sa Ingles Ang pangalan ng imbentaryo sa wikang Ingles.
- Paglalarawan sa Ingles Isang mas mahabang paglalarawan ng imbentaryo sa wikang Ingles.
- Presyo Ang presyo ng item.
- Itinerary Kailan dapat i-book ang item na ito.
- Uri ng pagpepresyo Paano kinakalkula ang presyo.
- Uri ng imbentaryo Anong uri ng imbentaryo ito.
- Mababayaran Kailan dapat singilin ang manlalakbay. Kasalukuyan lang naming sinusuportahan ang mga agarang opsyon sa pagbabayad.
- Patakaran Isama ang mga patakaran sa pagkansela.
- Listahan ng pang-araw-araw na rate Kung ang item na ini-book ay isang kuwarto, maaari mong piliing isama kung magkano ang halaga ng kuwartong iyon para sa bawat gabing pananatili ng bisita.
- Mga benepisyaryo Isama kung aling (mga) TripPay account ang dapat ilaan kung anong halaga ng (mga) presyo ng item. Ang mga naayos / Porsiyento ay sinusuportahan.
Sa halimbawa ng JSON sa itaas, mayroon kaming 3 benepisyaryo:
- 1.5% ang inilaan sa platform na nagpadali sa booking. hal. Kumindat
- 9.85% ang inilaan sa kaanib bilang komisyon. hal. Kim Kardashian
- 88.65% ang inilaan sa supplier para sa booking ng kuwarto. hal. Hilton
Kapag tumugon ang TripPay na may bayad na kontrata, mapapansin mong nag-inject ito ng sarili nitong benepisyaryo sa 4.0%.
Kapag tumugon ang TripPay sa iyong kahilingan, magiging ganito ang hitsura:
[ { "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" } }]
I-save ang id
sa linya 3. Gagamitin mo ito para mag-inject sa TripPay web component.
I-embed ang TripPay
Section titled “I-embed ang TripPay”Tiyaking na-load mo muna ang aming mga istilo at Javascript.
Sa puntong ito, handa ka nang i-embed ang Payment Web Component
sa iyong website at ipakita ito sa gumagamit.
<trip-pay id="contract-1"></trip-pay>
Hanggang sa pagsasama, iyon lang ang kailangan mong gawin. Ang lahat ng mabibigat na trabaho ay ginagawa ng TripPay mula dito.