Skip to content
Academy

Integrointi TripPayn kanssa

Tämä artikkeli sisältää kokonaisvaltaisen esimerkin TripPayn integroinnista.

On suositeltavaa, että olet jo lukenut:

Tässä ovat vaiheet TripPayn käyttämiseen varauksen maksamiseen:

  1. Varmista, että varaussopimuksessa mainitsemasi edunsaajat on kartoitettu.
  2. Anna matkustajan valita varattavat palvelut ja valmistautua maksamaan.
  3. Luo payable contract TripPaylla, joka sisältää varattavat tuotteet.
  4. Anna matkustajan maksaa TripPay-verkkokomponentin avulla.

Oletamme, että olet jo suorittanutStep 1jaStep 2ja ovat valmiita ilmoittamaan TripPaylle varauksesta.

Luo maksullinen sopimus

Section titled “Luo maksullinen sopimus”

Pyytää

Section titled “Pyytää”

Tässä on JSON-näytepyyntö, joka sisältää kaiken tarvittavan ensimmäisen maksullisen sopimuksesi luomiseen.

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

Selitys:

Emme selitä tässä kaikkia datapisteitä, koska ne on jo käsitelty API-dokumentaatiossa.

  • Rivit:2–7on varauksesta vastaava käyttäjä. Varauksen tekijöitä on kahdenlaisia:
    • Matkustaja.
    • Matkatoimisto.
  • Rivit:8–9on TripPay-tili, joka mahdollistaa varauksen tekemisen. Se voi olla:
    • TripPay-integraattoritilisi.
    • Jos ylläpidät kumppanuusverkostoa, se voi olla sinun kumppanuutesi.
  • KäytätraceIdryhmitellä useita varauksia useille eri toimittajille. Tällä tavoin voit peruuttaa ryhmävarauksen.
  • redirectUrlkertoo TripPaylle, mille sivulle maksun suorittamisen jälkeen ohjataan.
  • sourceUrlon sivusto/sovellus, jolla varaus tehtiin.

ThecontractListtaulukko sisältää tuotteet, jotka matkustaja haluaa ostaa useilta toimittajilta. Jokainen tuote sisältää:

  • Theidentifieron luomasi kelvollinen UUID.
  • Toimittaja, jolta haluat varata varaston.
  • Varasto, jonka haluat varata kyseiseltä toimittajalta. Nämä kaikki on määritelty sisäkkäisessä taulukossa.contractItemList.
  • Jokainen merkintä allacontractItemListsisältää:
    • VieraskäyttäjäTämä on käyttäjä, joka saapuu tiloihin.
    • Nimi englanniksiVaraston nimi englanniksi.
    • Kuvaus englanniksiPidempi kuvaus varastosta englanniksi.
    • HintaTuotteen hinta.
    • MatkasuunnitelmaMilloin tämä kohde tulisi varata.
    • HinnoittelutyyppiMiten hinta laskettiin.
    • VarastotyyppiMinkä tyyppinen varasto tämä on?
    • MaksettavaMilloin matkustajalta pitäisi periä maksu.Tuemme tällä hetkellä vain välittömiä maksuvaihtoehtoja.
    • KäytäntöSisällytä peruutusehdot.
    • PäivähintalistaJos varattava kohde on huone, voit valita, kuinka paljon kyseinen huone maksaa kultakin vieraan yöpymiseltä.
    • EdunsaajatSisällytä kenttään, mille TripPay-tilille/-tileille tuotteen hinta tulisi kohdistaa.Kiinteitä/prosenttisesti määrät ovat tuettuja.

Yllä olevassa JSON-esimerkissä meillä on kolme edunsaajaa:

  • 1,5 % kohdennettiin alustalle, joka mahdollisti varauksen.esim. Wink
  • 9,85 % kohdennettiin tytäryhtiölle provisioina.esim. Kim Kardashian
  • Huoneen varauksesta toimittajalle osoitettiin 88,65 %.esim. Hilton

Kun TripPay vastaa maksusopimuksella, huomaat, että se on lisännyt oman edunsaajansa 4,0 %.

Vastaus

Section titled “Vastaus”

Kun TripPay vastaa pyyntöösi, se näyttää suunnilleen tältä:

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

Tallennaidrivillä 3. Käytät tätä syöttääksesi sen TripPay-verkkokomponenttiin.

Upota TripPay

Section titled “Upota TripPay”

Tässä vaiheessa olet valmis upottamaanPayment Web Componentverkkosivustollesi ja näytä se käyttäjälle.

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

Integraation osalta se on kaikki mitä sinun tarvitsee tehdä. TripPay tekee kaiken raskaan työn tästä eteenpäin.