Skip to content
Academy

TripPayga integreerimine

See artikkel sisaldab terviklikku näidet TripPayga integreerimise kohta.

Soovitatav on, et oleksite juba lugenud:

Siin on sammud TripPay edukaks kasutamiseks broneeringu eest tasumiseks:

  1. Veenduge, et broneerimislepingus mainitud soodustatud isikud on kaardistatud.
  2. Laske reisijal valida, milliseid varusid ta broneerida soovib, ja laske tal maksmiseks valmistuda.
  3. Loo payable contract koos TripPayga, mis sisaldab broneeritavaid esemeid.
  4. Laske reisijal maksta TripPay veebikomponendi abil.

Eeldame, et olete juba lõpetanudStep 1jaStep 2ja on valmis TripPayd broneeringust teavitama.

Looge makstav leping

Section titled “Looge makstav leping”

Taotlus

Section titled “Taotlus”

Siin on JSON-näidistaotlus, mis sisaldab kõike, mida vajate oma esimese makstava 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 hakka siin iga andmepunkti selgitama, kuna need on juba API dokumentatsioonis käsitletud.

  • Read:2–7on broneeringu eest vastutav kasutaja. Broneerijaid on kahte tüüpi:
    • Rändur.
    • Reisibüroo.
  • Read:8–9on TripPay konto, mis teeb broneeringu. See võib olla:
    • Teie TripPay integraatori konto.
    • Kui haldate partnerlusvõrgustikku, võib see olla teie partner.
  • KasutagetraceIdmitme broneeringu koondamiseks mitme tarnija alla. Nii saate grupibroneeringu tühistada.
  • redirectUrlannab TripPayle teada, millisele lehele pärast makse sooritamist suunata.
  • sourceUrlon sait/rakendus, kus broneering tehti.

SeecontractListMassiiv sisaldab kaupa/kaupu, mida reisija soovib mitmelt tarnijalt osta. Iga kaup sisaldab:

  • Seeidentifieron teie loodud kehtiv UUID.
  • Tarnija, kellelt soovite laoseisu broneerida.
  • Laoseisud, mida soovite sellelt tarnijalt broneerida. Need kõik on määratud pesastatud massiivis.contractItemList.
  • Iga kirje allcontractItemListsisaldab:
    • KülaliskasutajaSee on kasutaja, kes saabub ruumidesse.
    • Nimi inglise keelesInventuuri nimi inglise keeles.
    • Kirjeldus inglise keelesPikem kirjeldus inventuurist inglise keeles.
    • HindEseme hind.
    • ReisiplaanMillal see üksus broneerida.
    • Hinnakujunduse tüüpKuidas hinda arvutati.
    • Varude tüüpMis tüüpi inventar see on?
    • MakstavMillal tuleks reisijalt tasu võtta.Praegu toetame ainult kohese maksmise võimalusi.
    • PoliitikaLisage tühistamispoliitika reeglid.
    • PäevahinnakiriKui broneeritav objekt on tuba, saate valida, kui palju see tuba iga külalise ööbimise eest maksma läheb.
    • ToetusesaajadLisage, millisele TripPay kontole/kontodele tuleks toote hinnast milline/milliseid summasid eraldada.Fikseeritud/protsentuaalsed summad on toetatud.

Vastus

Section titled “Vastus”

Kui TripPay teie päringule vastab, 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"
    }
  }
]

Salvestaid3. real. Seda kasutatakse TripPay veebikomponenti sisestamiseks.

TripPay manustamine

Section titled “TripPay manustamine”

Sel hetkel olete valmis manustamaPayment Web Componentoma veebisaidile ja kuva seda kasutajale.

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

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