Integrasi API eSIM
Integrasi API Airalo: jual eSIM di setiap perjalanan
Hubungkan akun mitra Airalo Anda ke PHPTRAVELS dan jual eSIM lokal, regional, dan global di situs web Anda sendiri, berdampingan dengan tiket pesawat, hotel, dan tur. Konektornya sudah siap: masukkan Client ID dan Client Secret, uji di sandbox, sinkronkan paket, tetapkan harga, lalu tayangkan.
- Konektor Airalo siap pakai
- Airalo Partner API v2
- Kode QR dan langkah instalasi
- Harga jual Anda sendiri
Pemasok
Apa itu Airalo, dan mengapa agen perjalanan menjual eSIM-nya
Airalo menjual eSIM: paket SIM digital yang dipasang wisatawan di ponsel tanpa melepas SIM fisik. Alih-alih membeli SIM lokal di bandara, wisatawan membeli paket data sebelum berangkat dan memasangnya dalam beberapa menit.
Melalui Airalo Partner API, bisnis perjalanan dapat menjual inventaris ini di situs web atau aplikasinya sendiri. PHPTRAVELS menyertakan konektor Airalo di modul eSIM, sehingga eSIM menjadi satu produk lagi di keranjang yang sama dengan penerbangan, hotel, transfer, visa, atau tur.
- Perusahaan
- Airalo, penyedia konektivitas eSIM
- Cakupan
- 200+ destinasi, menurut Airalo
- Paket
- eSIM lokal, regional, dan global
- API
- Partner API v2 · REST · token Bearer
- SDK
- PHP · Node.js · Python
- Di PHPTRAVELS
- Konektor siap pakai di modul eSIM
Langkah 1 · Akun mitra
Ajukan akun mitra Airalo
Akses API Airalo memerlukan perjanjian kemitraan dengan Airalo. PHPTRAVELS tidak menerbitkan akun atau kunci Airalo: Anda mengajukan, Airalo meninjau bisnis Anda lalu mengirimkan kredensial.
Yang perlu dikirim ke Airalo
- Nama perusahaan dan situs web
- Negara dan jenis bisnis
- Perkiraan volume penjualan eSIM
- Target pasar dan destinasi
- B2C, B2B, atau keduanya
- Bahwa Anda menggunakan PHPTRAVELS
Langkah 2 · Kredensial
Client ID, Client Secret, dan token akses
Setelah Airalo menyetujui akun Anda, Anda menerima Client ID dan Client Secret. PHPTRAVELS mengirimkannya ke endpoint token dari server Anda, menerima token akses Bearer, dan menggunakannya untuk setiap permintaan paket, pesanan, dan eSIM.
1# Server-side only: the Client Secret never reaches the browser 2curl -X POST "$AIRALO_API/v2/token" \ 3 -H "Accept: application/json" \ 4 -F "client_id=$CLIENT_ID" \ 5 -F "client_secret=$CLIENT_SECRET" \ 6 -F "grant_type=client_credentials" 7 8# → { "data": { "access_token": "eyJ0eXAi…", "expires_in": … } } 9# then: Authorization: Bearer <access_token>
- Hanya di sisi server
- Token diminta oleh server PHPTRAVELS Anda. Client Secret tidak pernah sampai ke browser.
- Penggunaan ulang token
- Konektor menyimpan token hingga kedaluwarsa, sehingga tidak meminta token baru di setiap pencarian.
- Jaga kerahasiaan secret
- Jangan pernah menaruh Client Secret di JavaScript publik, HTML, repositori Git publik, tangkapan layar, atau postingan forum.
- Satu akun, dua mode
- Airalo memungkinkan Anda memilih Sandbox atau Production di konfigurasinya. Uji semuanya di Sandbox terlebih dahulu.
Alur Partner API
Lima panggilan API Airalo di balik setiap penjualan eSIM
Dari harga pertama di layar hingga kode QR di kotak masuk wisatawan, konektor menggunakan lima panggilan yang sama. Masing-masing menunjukkan apa yang dilakukan PHPTRAVELS dengan responsnya.
- 01Ambil tokenPOST/v2/token
PHPTRAVELSMasuk dengan Client ID dan Client Secret Anda, lalu menyimpan token Bearer di server.
- 02Daftar paketGET/v2/packages
PHPTRAVELSMenyinkronkan paket lokal, regional, dan global beserta kuota data, masa berlaku, cakupan, dan harga net, lalu menerapkan harga Anda.
- 03Kirim pesananPOST/v2/orders
PHPTRAVELSSetelah pembayaran, memesan ID paket dan jumlah yang dipilih, lalu menyimpan pesanan Airalo pada pemesanan.
- 04Baca eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSMembaca eSIM berdasarkan ICCID: kode QR, kode aktivasi, alamat SM-DP+, dan tautan instalasi langsung untuk iOS.
- 05Langkah instalasiGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSMengambil petunjuk instalasi Airalo sesuai perangkat dan bahasa wisatawan, lalu menambahkannya ke voucher.
Langkah 3 sampai 5 · Admin PHPTRAVELS
Konfigurasi, uji, dan sinkronkan Airalo di admin Anda
Semuanya dilakukan di pengaturan modul eSIM pada admin PHPTRAVELS Anda. Kolom yang tersedia bergantung pada versi PHPTRAVELS Anda.
- 01Aktifkan modul eSIMBuka pengaturan modul dan aktifkan integrasi eSIM Airalo.
- 02Masukkan kredensial AndaTempel Client ID dan Client Secret dari Airalo, pilih Sandbox, lalu simpan.
- 03Uji koneksiGunakan tombol Uji. PHPTRAVELS masuk ke Airalo dan menampilkan status terhubung, atau kesalahan yang perlu diperbaiki.
- 04Sinkronkan paketMuat paket Airalo dan pastikan destinasi, kuota data, masa berlaku, dan harga tampil dengan benar di situs web Anda.
Lingkungan
Pesanan uji: tidak ada eSIM asli yang diterbitkanPesanan langsung: eSIM asli, dibebankan ke saldo Airalo Anda
Contoh tampilan. Kolom dapat berbeda di versi Anda.
Langkah 5 · Paket eSIM
eSIM lokal, regional, dan global dari satu feed
Airalo menyediakan tiga jenis paket, sehingga Anda dapat mencocokkan eSIM dengan rencana perjalanan wisatawan. Paket, harga, dan ketersediaan selalu diambil langsung dari Airalo.
eSIM lokal
Satu destinasi, untuk perjalanan ke satu negara.
ContoheSIM Amerika Serikat
eSIM regional
Beberapa negara dalam satu kawasan, untuk perjalanan multi-negara.
ContoheSIM Eropa
eSIM global
Negara di berbagai kawasan, untuk perjalanan panjang atau keliling dunia.
ContoheSIM Global
- Ditampilkan kepada wisatawan
- Destinasi · nama paket · kuota data · masa berlaku · jaringan · cakupan · harga
- Kuota data umum: 1 GB, 3 GB, 5 GB, dan 10 GB, masing-masing dengan masa berlakunya sendiri.
Langkah 6 sampai 9 · Penjualan
Cara wisatawan membeli eSIM Airalo di situs web Anda
Wisatawan tidak pernah meninggalkan situs Anda. PHPTRAVELS menangani pemesanan dan pembayaran, Airalo menerbitkan eSIM.
- 01Wisatawan
Membuka bagian eSIM di situs web Anda
- 02Wisatawan
Memilih destinasi
- 03PHPTRAVELS
Menampilkan paket Airalo dengan harga Anda
- 04Wisatawan
Memilih paket
- 05Wisatawan
Memesan dan membayar melalui payment gateway Anda
- 06PHPTRAVELS
Mengirim pesanan ke API Airalo
- 07Airalo
Menerbitkan eSIM
- 08Airalo
Mengembalikan kode QR dan detail instalasi
- 09PHPTRAVELS
Mengirim eSIM ke wisatawan melalui email dan di akunnya
Pengiriman eSIM
Lima cara wisatawan dapat memasang eSIM
Airalo mendukung beberapa alur instalasi untuk mitra API. PHPTRAVELS mencantumkan detailnya di voucher pemesanan, email konfirmasi, dan akun wisatawan.
Kode QR
Wisatawan memindai kode QR dari pengaturan eSIM di ponsel.
Input manual
Kode aktivasi dan alamat SM-DP+, untuk ponsel yang tidak dapat memindai.
Petunjuk Airalo
Petunjuk instalasi langkah demi langkah dari API, per perangkat dan bahasa.
Tautan eSIM Cloud atau PDF
Tautan berbagi atau PDF dari Airalo dengan panduan instalasi lengkap.
Instalasi langsung di iOS
Tautan instalasi sekali ketuk untuk iPhone yang kompatibel dengan versi iOS yang didukung.
Data pelanggan
Petakan setiap pelanggan ke ICCID
Airalo mengidentifikasi setiap eSIM berdasarkan ICCID dan, dalam alur ini, tidak menyimpan data pribadi wisatawan Anda. Menjaga hubungan antara wisatawan dan eSIM adalah tugas Anda, dan PHPTRAVELS melakukannya pada pemesanan.
- Pelanggan
- Pemesanan PHPTRAVELS
- Pesanan Airalo
- ICCID
Rantai ini memudahkan dukungan:Permintaan dukunganMasalah instalasiPencarian pesananRiwayat pemesananStatus eSIM
Langkah 7 · Harga Anda
Tetapkan harga jual dan dapatkan keuntungan dari setiap eSIM
Airalo menagih biaya paket sesuai perjanjian komersial Anda. Anda menentukan berapa yang dibayar wisatawan, dalam batas perjanjian Anda dengan Airalo.
Markup tetap
Jumlah yang sama di atas setiap paket.
Markup persentase
Persentase dari harga net, sehingga margin naik pada paket yang lebih besar.
Biaya layanan
Biaya terpisah per pesanan, ditampilkan saat checkout.
Termasuk dalam paket
eSIM yang termasuk dalam paket liburan atau sebagai hadiah dengan tiket pesawat.
- Penerbangan ke Dubai
- Hotel di Dubai
- Transfer bandara
- eSIM UEA
Mengapa agen menambahkan eSIM
- Pendapatan lebih besar per pemesanan
- Layanan tambahan yang dibutuhkan hampir setiap wisatawan internasional
- Pengiriman digital instan, tanpa stok
- Wisatawan kembali untuk perjalanan berikutnya
Opsi voucher. Airalo juga menjual voucher eSIM: Anda membeli kode aktivasi dan membagikannya melalui situs web, aplikasi, CRM, atau email Anda. Pilih metode yang sesuai dengan perjanjian Airalo Anda.
Pemecahan masalah
Jika ada yang tidak berfungsi, periksa hal ini terlebih dahulu
Sebagian besar masalah berasal dari kredensial, lingkungan, atau perangkat. Telusuri daftar sesuai masalah yang Anda alami.
- Uji koneksi gagal
- Client IDClient Secretakun mitra aktifakses API diaktifkanSandbox atau ProductionHTTPS keluar dari server AndaSSL
- Paket eSIM tidak muncul
- Koneksi APIketersediaan paketlingkunganfilter destinasirespons APIcache PHPTRAVELS
- Pesanan gagal
- Paket tidak valid atau tidak tersediasaldo Airalokegagalan tokenkesalahan jaringanlingkungan salahgangguan sementara Airalo
- Kode QR tidak muncul
- Pesanan selesaieSIM diterbitkanICCID tersimpandata instalasi dikembalikankolom QR di respons API
- Wisatawan tidak dapat memasang eSIM
- Ponsel mendukung eSIMponsel tidak terkunci operatorkode QR yang benareSIM belum terpasangroaming aktifAPN jika diperlukan
Siapa melakukan apa
PHPTRAVELS menjalankan perangkat lunak, Airalo menjalankan eSIM
Airalo adalah pemasok eksternal. Hubungan komersial terjalin antara bisnis perjalanan Anda dan Airalo.
PHPTRAVELS
- Konektor Airalo dan pengaturannya
- Halaman eSIM, pencarian, dan checkout
- Markup dan payment gateway Anda
- Voucher, email, dan ICCID pada pemesanan
- Dukungan untuk integrasinya
Airalo
- Persetujuan mitra dan kredensial API
- Harga paket, komisi, dan aturan saldo
- Cakupan, jaringan, dan ketersediaan paket
- Ketersediaan API dan penerbitan eSIM
- Perjanjian komersial Anda
Keamanan
Lindungi kredensial Airalo Anda
- Lakukan autentikasi hanya dari server, jangan pernah di JavaScript browser
- Gunakan HTTPS untuk situs web dan admin Anda
- Amankan panel admin dan batasi akses server
- Selalu perbarui PHPTRAVELS
- Pantau aktivitas API yang tidak biasa
Airalo
Butuh bantuan dengan integrasi?
Jika akun Airalo Anda sudah disetujui tetapi integrasi menampilkan kesalahan, buka tiket dukungan di akun PHPTRAVELS Anda dengan menyertakan: versi PHPTRAVELS, tangkapan layar pengaturan Airalo, hasil uji, contoh destinasi dan paket, nomor referensi pemesanan, dan pesan kesalahan. Jangan pernah menyertakan Client Secret lengkap.
Baca: cara agen perjalanan menjual eSIM secara onlineDokumentasi developer Airalo
Tidak. Anda memerlukan akun mitra Airalo sendiri yang sudah disetujui. PHPTRAVELS menyediakan perangkat lunak dan konektor Airalo siap pakai.
Airalo mengirimkan Client ID dan Client Secret setelah menyetujui akun mitra Anda. PHPTRAVELS tidak menerbitkannya.
Pelanggan PHPTRAVELS dapat mengirim email ke Rao Suhaib Khan, Head of Partnerships di Airalo, di rao.khan@airalo.com, dan menyebutkan bahwa mereka menggunakan PHPTRAVELS.
Bisa. Dengan akun mitra Airalo yang disetujui dan konektor PHPTRAVELS, paket Airalo yang didukung tampil di situs web Anda sendiri dan pemesanan tetap berada di situs Anda.
Bisa, berupa markup tetap, markup persentase, atau biaya layanan, selama sesuai dengan perjanjian komersial Anda dengan Airalo.
Bisa. Airalo memiliki mode Sandbox, di mana pesanan uji tidak menerbitkan eSIM asli. Beralihlah ke Production hanya setelah seluruh alur berjalan.
Ya. Airalo menawarkan paket lokal, regional, dan global, tergantung inventaris yang tersedia untuk setiap destinasi.
Dengan kode QR, dengan memasukkan kode aktivasi dan alamat SM-DP+, dengan petunjuk langkah demi langkah dari Airalo, dari tautan eSIM Cloud atau PDF, atau dengan tautan instalasi langsung di iPhone yang kompatibel.
Tidak. Airalo memiliki SDK untuk PHP, Node.js, dan Python, tetapi konektornya sudah ada di PHPTRAVELS. Anda cukup menambahkan kredensial.
Jelajahi lebih lanjut
Selengkapnya tentang platform
- eSIM
- Integrasi API TiqetsTiket atraksi Tiqets di mesin pemesanan Anda
- Integrasi API ViatorTur dan aktivitas Viator di situs pemesanan Anda
- Integrasi PKFARE APIPencarian, pemesanan, dan PNR PKFARE di portal Anda
- Integrasi API RateHawkHotel RateHawk di mesin booking Anda, konektor siap pakai
- API travelAPI GDS, hotel, tur, mobil dan pembayaran