Hoppa till innehåll
Academy

Integrering med TripPay

Den här artikeln innehåller ett heltäckande exempel på hur man integrerar med TripPay.

Det rekommenderas att du redan har läst:

Här är stegen för att framgångsrikt använda TripPay för att betala för en bokning:

  1. Se till att de förmånstagare du nämner i bokningskontraktet har kartlagts.
  2. Låt resenären välja vilket inventarie de vill boka och be dem göra sig redo att betala.
  3. Skapa en payable contract med TripPay som innehåller de objekt som ska bokas.
  4. Låt resenären betala med TripPay-webbkomponenten.

Vi antar att du redan har slutförtStep 1ochStep 2och är redo att meddela TripPay om bokningen.

Skapa betalbart kontrakt

Section titled “Skapa betalbart kontrakt”

Gå till betalnings-API:et för att läsa mer om kraven för att skapa ett betalbart kontrakt.

Begäran

Section titled “Begäran”

Här är en JSON-exempelförfrågan som innehåller allt du behöver skapa för ditt första betalbara kontrakt.

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

Förklaring:

Vi kommer inte att förklara varje datapunkt här eftersom de redan behandlas i API-dokumentationen.

  • Linjer:2–7är användaren ansvarig för bokningen. Det finns två typer av bokare:
    • Resande.
    • Resebyråman.
  • Linjer:8–9Är TripPay-kontot som möjliggör bokningen? Det kan vara:
    • Ditt TripPay-integratorkonto.
    • Om du driver ett affiliatenätverk kan det vara din affiliate.
  • Använd entraceIdatt gruppera flera bokningar över flera leverantörer. På så sätt kan du avbryta en gruppbokning.
  • redirectUrllåter TripPay veta vilken sida som ska omdirigeras till efter att betalningen är slutförd.
  • sourceUrlär webbplatsen/appen som bokningen gjordes på.

DencontractListMatrisen innehåller den/de varor som resenären vill köpa från flera leverantörer. Varje vara innehåller:

  • Denidentifierär ett giltigt UUID som du genererar.
  • Leverantören du vill boka lager från.
  • Lagret du vill boka från den leverantören. Alla dessa anges i den kapslade arrayen.contractItemList.
  • Varje post undercontractItemListinnehåller:
    • GästanvändareDetta är användaren som kommer att anlända till lokalen.
    • Namn på engelskaInventarieförteckningens namn på engelska.
    • Beskrivning på engelskaEn längre beskrivning av inventeringen på engelska.
    • PrisPriset på varan.
    • ResvägNär denna artikel ska bokas.
    • PrissättningstypHur priset beräknades.
    • InventarietypVilken typ av inventarielager är detta?
    • BetalningsbarNär resenären ska debiteras.Vi stöder för närvarande endast omedelbara betalningsalternativ.
    • PolitikInkludera regler för avbokningsregler.
    • Daglig prislistaOm det som bokas är ett rum kan du välja att inkludera hur mycket rummet kostar för varje natt gästen bor.
    • StödmottagareAnge vilket/vilka TripPay-konton som ska tilldelas vilka belopp av varans pris.Fasta belopp/procentbelopp stöds.

Vid det här laget är du redo att bädda inPayment Web Componentin på din webbplats och visa den för användaren.

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

När det gäller integrationen är det allt du behöver göra. Allt det tunga arbetet görs från och med nu av TripPay.