Gå til indhold
Academy

Integration med TripPay

Denne artikel indeholder et komplet eksempel på, hvordan man integrerer med TripPay.

Det anbefales, at du allerede har læst:

Her er trinnene til at bruge TripPay til at betale for en booking:

  1. Sørg for, at de begunstigede, du nævner i bookingkontrakten, er blevet kortlagt.
  2. Lad den rejsende vælge det inventar, de ønsker at booke, og lad dem gøre sig klar til at betale.
  3. Opret en payable contract med TripPay, der indeholder de varer, der skal bookes.
  4. Lad den rejsende betale ved hjælp af TripPay-webkomponenten.

Vi antager, at du allerede har gennemførtStep 1ogStep 2og er klar til at give TripPay besked om bookingen.

Opret betalingskontrakt

Section titled “Opret betalingskontrakt”

Anmodning

Section titled “Anmodning”

Her er en JSON-eksempelanmodning, der indeholder alt, hvad du skal bruge for at oprette din første betalbare 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"
            }
          ]
        }
      ]
    }
  ]
}

Forklaring:

Vi vil ikke forklare alle datapunkter her, da de allerede er dækket i API-dokumentationen.

  • Linjer:2-7er brugeren ansvarlig for bookingen. Der er to typer bookere:
    • Rejsende.
    • Rejsebureau.
  • Linjer:8 - 9Er TripPay-kontoen, der muliggør bookingen? Det kan være:
    • Din TripPay-integratorkonto.
    • Hvis du driver et affiliate-netværk, kan det være din affiliate.
  • Brug entraceIdat gruppere flere bookinger på tværs af flere leverandører. På denne måde kan du annullere en gruppebooking.
  • redirectUrllader TripPay vide, hvilken side der skal omdirigeres til, når betalingen er gennemført.
  • sourceUrler det websted/den app, hvor bookingen blev foretaget.

DencontractListArrayet indeholder den/de vare(r), som den rejsende ønsker at købe fra flere leverandører. Hver vare indeholder:

  • Denidentifierer et gyldigt UUID, du genererer.
  • Den leverandør, du ønsker at booke lagerbeholdning fra.
  • Den lagerbeholdning, du vil booke fra den pågældende leverandør. Disse er alle angivet i det indlejrede array.contractItemList.
  • Hver post undercontractItemListindeholder:
    • GæstebrugerDette er den bruger, der ankommer til stedet.
    • Navn på engelskNavnet på inventaret på engelsk.
    • Beskrivelse på engelskEn længere beskrivelse af inventaret på engelsk.
    • PrisVarens pris.
    • RuteHvornår denne vare skal bookes.
    • PristypeHvordan prisen blev beregnet.
    • LagertypeHvilken type lagerbeholdning er dette?
    • BetalesHvornår den rejsende skal opkræves.Vi understøtter i øjeblikket kun øjeblikkelige betalingsmuligheder.
    • PolitikInkluder regler for afbestillingspolitik.
    • Daglig prislisteHvis den bookede vare er et værelse, kan du vælge at inkludere, hvor meget værelset koster for hver nat, gæsten bor.
    • ModtagereAngiv hvilke TripPay-konti, der skal tildeles hvilke beløb af varens pris.Faste beløb/procentbeløb understøttes.

På dette tidspunkt er du klar til at integrerePayment Web Componentind på din hjemmeside og vis den til brugeren.

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

Hvad integration angår, er det alt, hvad du behøver at gøre. Alt det tunge arbejde udføres herfra af TripPay.