Mengintegrasikan dengan TripPay

Artikel ini mengandungi contoh hujung ke hujung tentang cara menyepadukan dengan TripPay.

Adalah disyorkan bahawa anda telah membaca:

Pembayaran > Pemetaan.
Pembayaran > Integrasi.
Komponen Web Pembayaran.
API Pembayaran. Baca bahagian pada Create payable contracts

Berikut ialah langkah-langkah untuk berjaya menggunakan TripPay untuk membayar tempahan:

Pastikan benefisiari yang anda nyatakan dalam kontrak tempahan telah dipetakan.
Biarkan pengembara memilih inventori yang ingin mereka tempah dan minta mereka bersedia untuk membayar.
Buat a payable contract dengan TripPay yang mengandungi item yang akan ditempah.
Biarkan pengembara membayar menggunakan Komponen Web TripPay.

Kami menganggap anda telah pun selesai Step 1 dan Step 2 dan bersedia untuk memberitahu TripPay tentang tempahan.

Buat kontrak berbayar

Pergi ke Payment API untuk mengetahui lebih lanjut tentang keperluan untuk membuat kontrak berbayar.

Permintaan

Berikut ialah contoh permintaan JSON yang merangkumi semua yang anda perlukan untuk membuat kontrak pertama anda yang perlu dibayar.

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

Penjelasan:

Kami tidak akan menerangkan setiap titik data di sini kerana ia telah pun diliputi dalam dokumen API.

Garisan: 2 - 7 adalah pengguna yang bertanggungjawab untuk membuat tempahan. Terdapat dua jenis penempah:
- Pengembara.
- Ejen pelancongan.
Garisan: 8 - 9 adalah akaun TripPay yang memudahkan tempahan. Ia boleh menjadi:
- Akaun penyepadu TripPay anda.
- Jika anda menjalankan rangkaian ahli gabungan, ia boleh menjadi ahli gabungan anda.
Gunakan a traceId untuk mengumpulkan berbilang tempahan merentas berbilang pembekal. Dengan cara ini anda boleh membatalkan tempahan berkumpulan.
redirectUrl membolehkan TripPay mengetahui halaman yang hendak diubah hala selepas pembayaran selesai.
sourceUrl ialah tapak / aplikasi tempat tempahan berlaku.

The contractList tatasusunan mengandungi item yang ingin dibeli oleh pengembara daripada berbilang pembekal. Setiap item mengandungi:

The identifier ialah UUID sah yang anda hasilkan.
Pembekal yang anda ingin tempah inventori.
Inventori yang anda ingin tempah daripada pembekal tersebut. Ini semua dinyatakan dalam tatasusunan bersarang contractItemList.
Setiap entri di bawah contractItemList mengandungi:
- Pengguna tetamu Ini adalah pengguna yang akan tiba di premis.
- Nama dalam bahasa Inggeris Nama inventori dalam bahasa Inggeris.
- Penerangan dalam bahasa Inggeris Penerangan yang lebih panjang tentang inventori dalam bahasa Inggeris.
- harga Harga barang.
- Jadual perjalanan Bila barang ini perlu ditempah.
- Jenis harga Bagaimana harga dikira.
- Jenis inventori Apakah jenis inventori ini.
- Boleh dibayar Apabila pengembara perlu dikenakan bayaran. Pada masa ini kami hanya menyokong pilihan pembayaran segera.
- Dasar Sertakan peraturan dasar pembatalan.
- Senarai kadar harian Jika item yang ditempah ialah bilik, anda boleh memilih untuk memasukkan kos bilik itu untuk setiap malam penginapan tetamu.
- Penerima manfaat Sertakan akaun TripPay mana yang harus diperuntukkan berapa jumlah harga item tersebut. Amaun tetap / Peratus disokong.

Dalam contoh JSON di atas, kami mempunyai 3 penerima:

1.5% diperuntukkan kepada platform yang memudahkan tempahan. cth. Kejap
9.85% diperuntukkan kepada ahli gabungan sebagai komisen. cth. Kim Kardashian
88.65% diperuntukkan pembekal untuk tempahan bilik. cth. Hilton

Apabila TripPay membalas dengan kontrak yang perlu dibayar, anda akan melihat bahawa ia menyuntik benefisiarinya sendiri pada kadar 4.0%.

Respon

Apabila TripPay membalas permintaan anda, ia akan kelihatan seperti ini:

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

Simpan id pada baris 3. Anda akan menggunakan ini untuk menyuntik ke dalam komponen web TripPay.

Benamkan TripPay

Pastikan anda telah memuatkan gaya dan Javascript kami terlebih dahulu.

Pada ketika ini, anda sudah bersedia untuk membenamkan Payment Web Component ke dalam laman web anda dan tunjukkan kepada pengguna.

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

Setakat integrasi, itu sahaja yang anda perlu lakukan. Semua kerja berat dilakukan oleh TripPay mulai sekarang.