Integrācija ar TripPay

Šajā rakstā ir sniegts pilnīgs piemērs tam, kā integrēties ar TripPay.

Ieteicams jau izlasīt:

Maksājums > Kartēšana.
Maksājums > Integrācija.
Maksājumu tīmekļa komponents.
Maksājumu API.Izlasiet sadaļu parCreate payable contracts

Lai veiksmīgi izmantotu TripPay rezervācijas apmaksai, veiciet tālāk norādītās darbības.

Pārliecinieties, ka rezervēšanas līgumā minētie labuma guvēji ir kartēti.
Ļaujiet ceļotājam izvēlēties inventāru, ko viņš vēlas rezervēt, un sagatavojieties maksāšanai.
Izveidot payable contract ar TripPay, kurā ir norādītas rezervējamās preces.
Ļaujiet ceļotājam norēķināties, izmantojot TripPay tīmekļa komponentu.

Mēs pieņemam, ka jūs jau esat pabeidzisStep 1unStep 2un ir gatavi informēt TripPay par rezervāciju.

Izveidojiet apmaksātu līgumu

:::piezīme Lai uzzinātu vairāk par maksājama līguma izveides prasībām, apmeklējiet Maksājumu API. :::

Pieprasījums

Šeit ir JSON parauga pieprasījums, kurā ir iekļauts viss nepieciešamais, lai izveidotu savu pirmo apmaksājamo līgumu.

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

Paskaidrojums:

Mēs šeit nepaskaidrosim katru datu punktu, jo tie jau ir aplūkoti API dokumentācijā.

Līnijas:2–7ir lietotājs, kas ir atbildīgs par rezervāciju. Ir divu veidu rezervētāji:
- Ceļotājs.
- Ceļojumu aģents.
Līnijas:8.–9.ir TripPay konts, kas nodrošina rezervāciju. Tas var būt:
- Jūsu TripPay integratora konts.
- Ja jūs pārvaldāt saistīto uzņēmumu tīklu, tas var būt jūsu saistītais uzņēmums.
IzmantojiettraceIdlai grupētu vairākas rezervācijas vairākiem piegādātājiem. Tādā veidā jūs varat atcelt grupas rezervāciju.
redirectUrlļauj TripPay zināt, uz kuru lapu pāradresēt pēc maksājuma pabeigšanas.
sourceUrlir vietne/lietotne, kurā tika veikta rezervācija.

ThecontractListMasīvs satur preces, ko ceļotājs vēlas iegādāties no vairākiem piegādātājiem. Katra prece satur:

Theidentifierir derīgs jūsu ģenerēts UUID.
Piegādātājs, no kura vēlaties rezervēt krājumus.
Inventārs, kuru vēlaties rezervēt no šī piegādātāja. Tas viss ir norādīts ligzdotajā masīvā.contractItemList.
Katrs ieraksts zemcontractItemListsatur:
- VieslietotājsŠis ir lietotājs, kurš ieradīsies telpās.
- Vārds angļu valodāInventāra nosaukums angļu valodā.
- Apraksts angļu valodāGarāks inventāra apraksts angļu valodā.
- CenaPreces cena.
- MaršrutsKad šī prece ir jārezervē.
- Cenu veidsKā tika aprēķināta cena.
- Krājumu veidsKāda veida inventārs tas ir?
- MaksājamsKad ceļotājam būtu jāiekasē maksa.Pašlaik mēs atbalstām tikai tūlītējas apmaksas iespējas.
- PolitikaIekļaujiet atcelšanas politikas noteikumus.
- Dienas cenrādisJa rezervējamais vienums ir istaba, varat izvēlēties iekļaut istabas cenu par katru viesa uzturēšanās nakti.
- SaņēmējiNorādiet, kuram(-iem) TripPay kontam(-iem) jāpiešķir kāda(-s) preces cenas summa(-s).Tiek atbalstītas fiksētas/procentuālas summas.

:::piezīme Iepriekš minētajā JSON piemērā mums ir 3 saņēmēji:

1,5% tika piešķirti platformai, kas veicināja rezervāciju.piem., Wink
9,85% tika piešķirti filiālei kā komisija.piemēram, Kima Kardašjana
88,65% tika piešķirti piegādātājam istabas rezervēšanai.piem., Hiltons

Kad TripPay atbildēs ar apmaksātu līgumu, jūs ievērosiet, ka tas ir iepludinājis savu saņēmēju 4,0% apmērā. :::

Atbilde

Kad TripPay atbildēs uz jūsu pieprasījumu, tas izskatīsies apmēram šādi:

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

Saglabātid3. rindā. Jūs to izmantosiet, lai ievadītu TripPay tīmekļa komponentā.

Iegult TripPay

Šajā brīdī jūs esat gatavs iegultPayment Web Componentsavā tīmekļa vietnē un parādiet to lietotājam.

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

Kas attiecas uz integrāciju, tas ir viss, kas jums jādara. Visu smago darbu turpmāk veic TripPay.