Integration mit TripPay

Dieser Artikel enthält ein umfassendes Beispiel für die Integration mit TripPay.

Es wird empfohlen, dass Sie Folgendes bereits gelesen haben:

Zahlung > Zuordnung.
Zahlung > Integration.
Zahlungs-Webkomponente.
Zahlungs-API.Lesen Sie den Abschnitt überCreate payable contracts

So bezahlen Sie eine Buchung erfolgreich mit TripPay:

Stellen Sie sicher, dass die im Buchungsvertrag genannten Begünstigten erfasst sind.
Lassen Sie den Reisenden den Bestand auswählen, den er buchen möchte, und machen Sie ihn bereit für die Zahlung.
Erstellen Sie ein payable contract mit TripPay, das die zu buchenden Artikel enthält.
Lassen Sie den Reisenden mit der TripPay-Webkomponente bezahlen.

Wir gehen davon aus, dass Sie bereits abgeschlossen habenStep 1 Und Step 2und sind bereit, TripPay über die Buchung zu informieren.

Zahlungsvertrag erstellen

Weitere Informationen zu den Voraussetzungen für die Erstellung eines zahlbaren Vertrags finden Sie in der Zahlungs-API.

Anfrage

Hier ist eine JSON-Beispielanfrage, die alles enthält, was Sie für Ihren ersten zahlbaren Vertrag erstellen müssen.

{
  "user": {
    "userIdentifier": "191d5729-0b90-4000-85df-1bea7a6e9a01",
    "firstName": "John",
    "lastName": "Smith",
    "email": "john.smith@email.com"
  },
  "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": "john.smith@email.com",
            "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"
            }
          ]
        }
      ]
    }
  ]
}

Erläuterung:

Wir werden hier nicht jeden Datenpunkt erklären, da sie bereits in den API-Dokumenten behandelt werden.

Linien:2 - 7ist der für die Buchung zuständige Benutzer. Es gibt zwei Arten von Buchern:
- Reisender.
- Reisebüro.
Linien:8 - 9ist das TripPay-Konto, das die Buchung ermöglicht. Es kann sein:
- Ihr TripPay-Integratorkonto.
- Wenn Sie ein Affiliate-Netzwerk betreiben, kann dies Ihr Affiliate sein.
Verwenden Sie eintraceIdum mehrere Buchungen bei mehreren Anbietern zu gruppieren. Auf diese Weise können Sie eine Gruppenbuchung stornieren.
redirectUrlteilt TripPay mit, auf welche Seite nach Abschluss der Zahlung umgeleitet werden soll.
sourceUrlist die Site/App, auf der die Buchung erfolgt ist.

Der contractListDas Array enthält die Artikel, die der Reisende von verschiedenen Anbietern kaufen möchte. Jeder Artikel enthält:

Der identifierist eine gültige UUID, die Sie generieren.
Der Lieferant, bei dem Sie Lagerbestände buchen möchten.
Der Bestand, den Sie von diesem Lieferanten buchen möchten. Diese sind alle im verschachtelten Array angegebencontractItemList.
Jeder Eintrag untercontractItemListenthält:
- GastbenutzerDies ist der Benutzer, der auf dem Gelände ankommt.
- Name auf EnglischDer Name des Inventars in englischer Sprache.
- Beschreibung auf EnglischEine längere Beschreibung des Inventars in englischer Sprache.
- PreisDer Preis des Artikels.
- RouteWann dieser Artikel gebucht werden soll.
- PreistypWie der Preis berechnet wurde.
- InventartypUm welche Art von Inventar handelt es sich?
- ZahlbarWann dem Reisenden Gebühren berechnet werden sollen.Wir unterstützen derzeit nur sofortige Zahlungsoptionen.
- PolitikFügen Sie Stornierungsbedingungen hinzu.
- TagespreislisteWenn es sich bei der Buchung um ein Zimmer handelt, können Sie angeben, wie viel das Zimmer pro Übernachtung des Gastes kostet.
- BegünstigteGeben Sie an, welchem/welchen TripPay-Konto(s) welcher/welche Beträge des Artikelpreises zugewiesen werden sollen.Feste/prozentuale Beträge werden unterstützt.

Im obigen JSON-Beispiel gibt es drei Begünstigte:

1,5 % wurden der Plattform zugewiesen, die die Buchung ermöglichte.zB Wink
9,85 % wurden dem Affiliate als Provision zugeteilt.z.B. Kim Kardashian
88,65 % wurden dem Anbieter für die Zimmerbuchung zugeteilt.z. B. Hilton

Wenn TripPay mit einem zahlbaren Vertrag antwortet, werden Sie feststellen, dass es seinem eigenen Begünstigten 4,0 % injiziert hat.

Antwort

Wenn TripPay auf Ihre Anfrage antwortet, sieht dies ungefähr so aus:

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

Speichern Sie dieidin Zeile 3. Sie verwenden dies zum Einfügen in die TripPay-Webkomponente.

TripPay einbetten

Stellen Sie sicher, dass Sie unsere Stile und Javascript vorher geladen haben.

An diesem Punkt sind Sie bereit, diePayment Web Componentin Ihre Website und zeigen Sie es dem Benutzer.

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

Was die Integration betrifft, ist das alles, was Sie tun müssen. Die ganze schwere Arbeit wird von nun an von TripPay erledigt.