Integrasi dengan TripPay
Artikel ini berisi contoh menyeluruh tentang cara berintegrasi dengan TripPay.
Disarankan agar Anda sudah membaca:
- Pembayaran > Pemetaan.
- Pembayaran > Integrasi.
- Komponen Web Pembayaran.
- API Pembayaran.Baca bagian tentang
Create payable contracts
Berikut langkah-langkah untuk berhasil menggunakan TripPay untuk membayar pemesanan:
- Pastikan penerima manfaat yang Anda sebutkan dalam kontrak pemesanan telah dipetakan.
- Biarkan wisatawan memilih inventaris yang ingin mereka pesan dan biarkan mereka bersiap membayar.
- Membuat sebuah
payable contract
dengan TripPay yang berisi item yang akan dipesan. - Biarkan wisatawan membayar menggunakan Komponen Web TripPay.
Kami berasumsi Anda sudah menyelesaikannyaStep 1
Dan Step 2
dan siap memberi tahu TripPay tentang pemesanan.
Buat kontrak yang harus dibayar
Section titled “Buat kontrak yang harus dibayar”Buka API Pembayaran untuk mempelajari lebih lanjut tentang persyaratan untuk membuat kontrak yang dapat dibayarkan.
Meminta
Section titled “Meminta”Berikut adalah contoh permintaan JSON yang mencakup semua yang Anda butuhkan untuk membuat kontrak pembayaran pertama Anda.
{ "user": { "userIdentifier": "191d5729-0b90-4000-85df-1bea7a6e9a01", "firstName": "John", "lastName": "Smith", }, "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", "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 menjelaskan setiap titik data di sini karena sudah tercakup dalam dokumen API.
- Garis:2 - 7adalah pengguna yang bertanggung jawab atas pemesanan. Ada dua jenis pemesan:
- Wisatawan.
- Agen perjalanan.
- Garis:8 - 9adalah akun TripPay yang memfasilitasi pemesanan. Bisa berupa:
- Akun integrator TripPay Anda.
- Jika Anda menjalankan jaringan afiliasi, itu bisa menjadi afiliasi Anda.
- Gunakan
traceId
untuk mengelompokkan beberapa pemesanan di beberapa pemasok. Dengan cara ini Anda dapat membatalkan pemesanan grup. redirectUrl
memungkinkan TripPay mengetahui halaman mana yang akan diarahkan setelah pembayaran selesai.sourceUrl
adalah situs/aplikasi tempat pemesanan terjadi.
ItucontractList
array berisi item yang ingin dibeli oleh wisatawan dari beberapa pemasok. Setiap item berisi:
- Itu
identifier
adalah UUID valid yang Anda buat. - Pemasok tempat Anda ingin memesan inventaris.
- Inventaris yang ingin Anda pesan dari pemasok tersebut. Semua ini ditentukan dalam array bersarang
contractItemList
. - Setiap entri di bawah
contractItemList
berisi:- Pengguna tamuIni adalah pengguna yang akan tiba di lokasi.
- Nama dalam bahasa InggrisNama inventaris dalam bahasa Inggris.
- Deskripsi dalam bahasa InggrisDeskripsi inventaris yang lebih panjang dalam bahasa Inggris.
- HargaHarga barang.
- Rencana perjalananKapan barang ini harus dipesan.
- Jenis hargaBagaimana harga dihitung.
- Jenis inventarisJenis inventaris apa ini?
- Dapat dibayarKapan wisatawan harus dikenakan biaya.Saat ini kami hanya mendukung opsi pembayaran langsung.
- KebijakanSertakan aturan kebijakan pembatalan.
- Daftar tarif harianJika item yang dipesan adalah kamar, Anda dapat memilih untuk menyertakan berapa biaya kamar tersebut untuk setiap malam tamu menginap.
- Penerima ManfaatSertakan akun TripPay mana yang harus dialokasikan berapa jumlah harga barang.Jumlah tetap/persen didukung.
Dalam contoh JSON di atas, kita memiliki 3 penerima manfaat:
- 1,5% dialokasikan ke platform yang memfasilitasi pemesanan.misalnya Wink
- 9,85% dialokasikan kepada afiliasi sebagai komisi.misalnya Kim Kardashian
- 88,65% dialokasikan kepada pemasok untuk pemesanan kamar.misalnya Hilton
Ketika TripPay merespons dengan kontrak yang harus dibayar, Anda akan melihat bahwa TripPay menyuntikkan penerima manfaatnya sendiri sebesar 4,0%.
Tanggapan
Section titled “Tanggapan”Ketika TripPay menanggapi permintaan Anda, tampilannya akan 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" } }]
Simpanid
pada baris 3. Anda akan menggunakan ini untuk menyuntikkan ke komponen web TripPay.
Sematkan TripPay
Section titled “Sematkan TripPay”Pastikan Anda telah memuat gaya dan Javascript kami sebelumnya.
Pada titik ini, Anda siap untuk menanamkanPayment Web Component
ke situs web Anda dan menunjukkannya kepada pengguna.
<trip-pay id="contract-1"></trip-pay>
Sejauh menyangkut integrasi, itu saja yang perlu Anda lakukan. Semua pekerjaan berat dilakukan oleh TripPay mulai sekarang.