Samþætting við TripPay

Þessi grein inniheldur dæmi frá upphafi til enda um hvernig á að samþætta við TripPay.

Mælt er með að þú hafir þegar lesið:

Payment > Mapping.
Payment > Integration.
Payment Web Component.
Payment API. Lestu kaflann um Create payable contracts

Hér eru skrefin til að nota TripPay til að greiða fyrir bókun með góðum árangri:

Gakktu úr skugga um að þeir sem þú nefnir sem þiggjendur í bókunarsamningnum hafi verið kortlagðir.
Láttu ferðalanginn velja birgðirnar sem hann vill bóka og undirbúa sig til að greiða.
Búðu til payable contract með TripPay sem inniheldur þá hluti sem á að bóka.
Láttu ferðalanginn greiða með TripPay Web Component.

Við gerum ráð fyrir að þú hafir þegar lokið Skrefi 1 og Skrefi 2 og ert tilbúinn að láta TripPay vita af bókuninni.

Búa til greiðslusamning

Fyrirspurn

Hér er JSON dæmi um fyrirspurn sem inniheldur allt sem þú þarft til að búa til þinn fyrsta greiðslusamning.

{
  "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 hvert gagnapunkt hér þar sem þau eru þegar útskýrð í API skjölunum.

Línur: 2 - 7 eru notandinn sem ber ábyrgð á bókuninni. Það eru tveir gerðir bókenda:
- Ferðalangur.
- Ferðaskrifstofumaður.
Línur: 8 - 9 eru TripPay reikningurinn sem sér um bókunina. Hann getur verið:
- Þinn TripPay samþættingarreikningur.
- Ef þú rekur tengdanet, getur það verið tengdiliður þinn.
Notaðu traceId til að hópa saman margar bókanir frá mörgum birgjum. Þannig getur þú hætt við hópbókun.
redirectUrl segir TripPay hvaða síðu á að vísa á eftir að greiðslan er lokið.
sourceUrl er vefsvæðið / appið þar sem bókunin átti sér stað.

Fylkið contractList inniheldur þann hlut eða þá hluti sem ferðalangurinn vill kaupa frá mörgum birgjum. Hver hlutur inniheldur:

identifier er gilt UUID sem þú býrð til.
Birginn sem þú vilt bóka birgðir frá.
Birgðirnar sem þú vilt bóka frá þeim birgi. Þær eru allar tilgreindar í innra fylkinu contractItemList.
Hver færsla undir contractItemList inniheldur:
- Gestanotandi Þetta er notandinn sem mun koma á staðinn.
- Nafn á ensku Nafn birgðarinnar á ensku.
- Lýsing á ensku Lengri lýsing á birgðinni á ensku.
- Verð Verð hlutarins.
- Ferðaáætlun Hvenær á að bóka þennan hlut.
- Tegund verðlagningar Hvernig verðið var reiknað.
- Tegund birgða Hvaða tegund birgða þetta er.
- Greiðsluskyldur Hvenær ferðalangurinn á að greiða. Við styðjum nú aðeins tafarlausar greiðslumöguleika.
- Stefna Inniheldur reglur um afpöntun.
- Dagsverðlisti Ef hluturinn sem er bókaður er herbergi, getur þú valið að taka með hversu mikið herbergið kostar fyrir hverja nótt sem gesturinn dvelur.
- Þiggjendur Inniheldur hvaða TripPay reikning(ur) eiga að fá hvaða hluta af verði hlutarins. Fastar / prósentu upphæðir eru studdar.

Svar

Þegar TripPay svarar fyrirspurn þinni mun það líta út svona:

[
  {
    "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"
    }
  }
]

Vistaðu id á línu 3. Þú munt nota það til að setja inn í TripPay vefhlutann.

Innbyggja TripPay

Á þessum tímapunkti ertu tilbúinn að innbyggja Payment Web Component á vefsíðuna þína og sýna notandanum.

<trip-pay id="contract-1"></trip-pay>

Varðandi samþættingu, þá er þetta allt sem þú þarft að gera. Allt þungt verk er unnið af TripPay héðan í frá.