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 umCreate 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 1ogStep 2og eru tilbúin að láta TripPay vita af bókuninni.

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

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

Svar

Þ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

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