Skip to content

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ð:

Hér eru skrefin til að nota TripPay til að greiða fyrir bókun:

  1. Gakktu úr skugga um að rétthafarnir sem þú nefnir í bókunarsamningnum hafi verið kortlagðir.
  2. Leyfðu ferðalangnum að velja þá geymslu sem hann vill bóka og láttu hann undirbúa greiðslu.
  3. Búa til payable contract með TripPay sem inniheldur vörurnar sem á að bóka.
  4. Láttu ferðalanginn greiða með TripPay vefþáttinum.

Við gerum ráð fyrir að þú hafir þegar lokiðStep 1ogStep 2og eru tilbúin að láta TripPay vita af bókuninni.

:::athugið Farið í greiðsluforritaskilið til að fá frekari upplýsingar um kröfur til að búa til greiðslusamning. :::

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",
"email": "[email protected]"
},
"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",
"email": "[email protected]",
"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ðutraceIdtil að flokka margar bókanir hjá mörgum birgjum. Þannig er hægt að hætta við hópbókun.
  • redirectUrllætur TripPay vita á hvaða síðu á að beina eftir að greiðsla er lokið.
  • sourceUrler síðan/appið sem bókunin fór fram á.

HinncontractListFylki inniheldur vöruna/vörurnar sem ferðamaðurinn vill kaupa frá mörgum birgjum. Hver vara inniheldur:

  • Hinnidentifierer 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 undircontractItemListinniheldur:
    • 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.

:::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 Componentinn á 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á.