Integreerimine TripPayga

See artikkel sisaldab lõpp-lõpuni näidet, kuidas integreeruda TripPayga.

Soovitatav on, et olete juba lugenud:

Makse > Kaardistamine.
Makse > Integreerimine.
Makse veebikomponent.
Makse API. Lugege jaotist Loo tasumisele kuuluvad lepingud

Siin on sammud, kuidas edukalt kasutada TripPayd broneeringu eest tasumiseks:

Veenduge, et broneerimislepingus mainitud kasusaajad on kaardistatud.
Laske reisijal valida soovitud inventar ja valmistuda maksmiseks.
Looge TripPayga tasumisele kuuluv leping, mis sisaldab broneeritavaid üksusi.
Laske reisijal maksta TripPay veebikomponendi abil.

Eeldame, et olete juba lõpetanud Samm 1 ja Samm 2 ning olete valmis TripPayle broneeringust teatama.

Loo tasumisele kuuluv leping

Päring

Siin on JSON-i näidispäring, mis sisaldab kõike, mida vajate oma esimese tasumisele kuuluva lepingu loomiseks.

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

Selgitus:

Me ei selgita siin kõiki andmepunkte, kuna need on juba API dokumentatsioonis kaetud.

Read: 2 - 7 on broneeringu eest vastutav kasutaja. On kaks tüüpi broneerijaid:
- Reisija.
- Reisibüroo esindaja.
Read: 8 - 9 on TripPay konto, mis broneeringut vahendab. See võib olla:
- Teie TripPay integreerija konto.
- Kui juhite sidusvõrku, võib see olla teie sidusettevõte.
Kasutage traceId, et grupeerida mitu broneeringut mitme tarnija vahel. Nii saate tühistada grupibroneeringu.
redirectUrl ütleb TripPayle, millisele lehele suunata pärast makse lõpetamist.
sourceUrl on sait või rakendus, kus broneering tehti.

contractList massiiv sisaldab üksust(e), mida reisija soovib osta mitmelt tarnijalt. Iga üksus sisaldab:

identifier on kehtiv UUID, mille te genereerite.
Tarnija, kelle inventari soovite broneerida.
Inventar, mida soovite sellelt tarnijalt broneerida. Need on kõik määratletud pesastatud massiivis contractItemList.
Iga kirje contractItemList all sisaldab:
- Külaliskasutaja See on kasutaja, kes saabub objekti juurde.
- Nimi inglise keeles Inventari nimi inglise keeles.
- Kirjeldus inglise keeles Pikem inventari kirjeldus inglise keeles.
- Hind Üksuse hind.
- Reisigraafik Millal see üksus tuleks broneerida.
- Hinnatüüp Kuidas hind arvutati.
- Inventari tüüp Millist tüüpi inventar see on.
- Tasumisele kuuluv Millal reisijat arveldada. Praegu toetame ainult kohest makset.
- Põhimõte Lisage tühistamispoliitika reeglid.
- Päevamäärade nimekiri Kui broneeritav üksus on tuba, saate lisada, kui palju see tuba maksab iga öö eest, mil külaline viibib.
- Kasusaajad Lisage, millisele TripPay kontole(d) tuleks määrata milline osa hinna summast. Toetatud on fikseeritud ja protsendipõhised summad.

Vastus

Kui TripPay vastab teie päringule, näeb see välja umbes selline:

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

Salvestage id real 3. Seda kasutate TripPay veebikomponendi sisestamiseks.

TripPay manustamine

Selles etapis olete valmis manustama Payment Web Component oma veebisaidile ja seda kasutajale kuvama.

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

Mis puutub integreerimisse, siis see on kõik, mida peate tegema. Kõik raske töö teeb TripPay edaspidi ära.