Integrasi API eSIM
Integrasi API Airalo: jual eSIM bersama setiap perjalanan
Sambungkan akaun rakan kongsi Airalo anda ke PHPTRAVELS dan jual eSIM tempatan, serantau dan global di laman web anda sendiri, bersama penerbangan, hotel dan lawatan. Penyambung sudah sedia: masukkan Client ID dan Client Secret, uji dalam sandbox, segerakkan pakej, tetapkan harga dan mula beroperasi.
- Penyambung Airalo sedia guna
- Airalo Partner API v2
- Kod QR dan langkah pemasangan
- Harga jualan anda sendiri
Pembekal
Apa itu Airalo, dan mengapa agensi pelancongan menjual eSIMnya
Airalo menjual eSIM: pakej SIM digital yang dipasang oleh pelancong pada telefon tanpa mengeluarkan SIM fizikal. Daripada membeli SIM tempatan di lapangan terbang, pelancong membeli data sebelum perjalanan dan memasangnya dalam beberapa minit.
Melalui Airalo Partner API, perniagaan pelancongan boleh menjual inventori ini di laman web atau aplikasinya sendiri. PHPTRAVELS menyertakan penyambung Airalo dalam modul eSIM, jadi eSIM menjadi satu lagi produk dalam troli yang sama dengan penerbangan, hotel, pemindahan, visa atau lawatan.
- Syarikat
- Airalo, penyedia sambungan eSIM
- Liputan
- 200+ destinasi, menurut Airalo
- Pakej
- eSIM tempatan, serantau dan global
- API
- Partner API v2 · REST · token Bearer
- SDK
- PHP · Node.js · Python
- Dalam PHPTRAVELS
- Penyambung sedia guna dalam modul eSIM
Langkah 1 · Akaun rakan kongsi
Mohon akaun rakan kongsi Airalo
Akses API Airalo memerlukan perjanjian rakan kongsi dengan Airalo. PHPTRAVELS tidak mengeluarkan akaun atau kunci Airalo: anda memohon, Airalo menyemak perniagaan anda dan menghantar kelayakan anda.
Perkara yang perlu dihantar kepada Airalo
- Nama syarikat dan laman web
- Negara dan jenis perniagaan
- Jangkaan jumlah jualan eSIM
- Pasaran sasaran dan destinasi
- B2C, B2B atau kedua-duanya
- Bahawa anda menggunakan PHPTRAVELS
Langkah 2 · Kelayakan
Client ID, Client Secret dan token akses
Apabila Airalo meluluskan akaun anda, anda menerima Client ID dan Client Secret. PHPTRAVELS menghantarnya ke endpoint token dari pelayan anda, menerima token akses Bearer dan menggunakannya untuk setiap permintaan pakej, 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>
- Di sisi pelayan sahaja
- Token diminta oleh pelayan PHPTRAVELS anda. Client Secret tidak pernah sampai ke pelayar.
- Penggunaan semula token
- Penyambung menyimpan token sehingga tamat tempoh, jadi ia tidak meminta token baharu pada setiap carian.
- Rahsiakan secret anda
- Jangan sekali-kali letakkan Client Secret dalam JavaScript awam, HTML, repositori Git awam, tangkapan skrin atau hantaran forum.
- Satu akaun, dua mod
- Airalo membolehkan anda memilih Sandbox atau Production dalam konfigurasinya. Uji semuanya dalam Sandbox terlebih dahulu.
Aliran Partner API
Lima panggilan API Airalo di sebalik setiap jualan eSIM
Dari harga pertama di skrin hingga kod QR dalam peti masuk pelancong, penyambung menggunakan lima panggilan yang sama. Setiap satu menunjukkan apa yang PHPTRAVELS lakukan dengan jawapannya.
- 01Dapatkan tokenPOST/v2/token
PHPTRAVELSLog masuk dengan Client ID dan Client Secret anda dan menyimpan token Bearer di pelayan.
- 02Senarai pakejGET/v2/packages
PHPTRAVELSMenyegerakkan pakej tempatan, serantau dan global dengan data, tempoh sah, liputan dan harga bersih, kemudian menggunakan harga anda.
- 03Hantar pesananPOST/v2/orders
PHPTRAVELSSelepas pembayaran, memesan ID pakej dan kuantiti yang dipilih serta menyimpan pesanan Airalo pada tempahan.
- 04Baca eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSMembaca eSIM melalui ICCID: kod QR, kod pengaktifan, alamat SM-DP+ dan pautan pemasangan terus untuk iOS.
- 05Langkah pemasanganGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSMendapatkan arahan pemasangan Airalo untuk peranti dan bahasa pelancong, dan menambahkannya pada baucar.
Langkah 3 hingga 5 · Admin PHPTRAVELS
Konfigurasi, uji dan segerakkan Airalo dalam admin anda
Semuanya dilakukan dalam tetapan modul eSIM di admin PHPTRAVELS anda. Medan sebenar bergantung pada versi PHPTRAVELS anda.
- 01Dayakan modul eSIMBuka tetapan modul dan hidupkan integrasi eSIM Airalo.
- 02Masukkan kelayakan andaTampal Client ID dan Client Secret daripada Airalo, pilih Sandbox dan simpan.
- 03Uji sambunganGunakan butang Uji. PHPTRAVELS log masuk ke Airalo dan memaparkan status bersambung, atau ralat yang perlu dibaiki.
- 04Segerakkan pakejMuatkan pakej Airalo dan pastikan destinasi, data, tempoh sah dan harga dipaparkan dengan betul di laman web anda.
Persekitaran
Pesanan ujian: tiada eSIM sebenar dikeluarkanPesanan sebenar: eSIM sebenar, dicaj pada baki Airalo anda
Contoh skrin. Medan mungkin berbeza dalam versi anda.
Langkah 5 · Pakej eSIM
eSIM tempatan, serantau dan global daripada satu suapan
Airalo memulangkan tiga jenis pakej, jadi anda boleh memadankan eSIM dengan jadual perjalanan pelancong. Pakej, harga dan ketersediaan sentiasa diambil secara langsung daripada Airalo.
eSIM tempatan
Satu destinasi, untuk perjalanan ke satu negara.
ContoheSIM Amerika Syarikat
eSIM serantau
Beberapa negara dalam satu rantau, untuk perjalanan pelbagai negara.
ContoheSIM Eropah
eSIM global
Negara merentas beberapa rantau, untuk perjalanan panjang atau keliling dunia.
ContoheSIM Global
- Dipaparkan kepada pelancong
- Destinasi · nama pakej · data · tempoh sah · rangkaian · liputan · harga
- Saiz data biasa: 1 GB, 3 GB, 5 GB dan 10 GB, setiap satu dengan tempoh sahnya sendiri.
Langkah 6 hingga 9 · Jualan
Cara pelancong membeli eSIM Airalo di laman web anda
Pelancong tidak pernah meninggalkan laman anda. PHPTRAVELS mengendalikan tempahan dan pembayaran, Airalo mengeluarkan eSIM.
- 01Pelancong
Membuka bahagian eSIM di laman web anda
- 02Pelancong
Memilih destinasi
- 03PHPTRAVELS
Memaparkan pakej Airalo dengan harga anda
- 04Pelancong
Memilih pakej
- 05Pelancong
Menempah dan membayar melalui gerbang pembayaran anda
- 06PHPTRAVELS
Menghantar pesanan ke API Airalo
- 07Airalo
Mengeluarkan eSIM
- 08Airalo
Memulangkan kod QR dan butiran pemasangan
- 09PHPTRAVELS
Menghantar eSIM kepada pelancong melalui e-mel dan dalam akaunnya
Penghantaran eSIM
Lima cara pelancong boleh memasang eSIM
Airalo menyokong beberapa aliran pemasangan untuk rakan kongsi API. PHPTRAVELS meletakkan butirannya pada baucar tempahan, e-mel pengesahan dan akaun pelancong.
Kod QR
Pelancong mengimbas kod QR daripada tetapan eSIM telefon.
Kemasukan manual
Kod pengaktifan dan alamat SM-DP+, untuk telefon yang tidak boleh mengimbas.
Arahan Airalo
Arahan pemasangan langkah demi langkah daripada API, mengikut peranti dan bahasa.
Pautan eSIM Cloud atau PDF
Pautan perkongsian atau PDF daripada Airalo dengan panduan pemasangan lengkap.
Pemasangan terus iOS
Pautan pemasangan satu ketikan untuk iPhone yang serasi dengan versi iOS yang disokong.
Data pelanggan
Petakan setiap pelanggan kepada ICCID
Airalo mengenal pasti setiap eSIM melalui ICCID dan, untuk aliran ini, tidak menyimpan data peribadi pelancong anda. Menyimpan hubungan antara pelancong dan eSIM ialah tanggungjawab anda, dan PHPTRAVELS melakukannya pada tempahan.
- Pelanggan
- Tempahan PHPTRAVELS
- Pesanan Airalo
- ICCID
Rantaian ini memudahkan sokongan:Permintaan sokonganMasalah pemasanganCarian pesananSejarah tempahanStatus eSIM
Langkah 7 · Harga anda
Tetapkan harga jualan dan raih keuntungan pada setiap eSIM
Airalo mengenakan kos pakej mengikut perjanjian komersial anda. Anda menentukan berapa yang dibayar oleh pelancong, dalam had perjanjian anda dengan Airalo.
Markup tetap
Jumlah yang sama di atas setiap pakej.
Markup peratusan
Peratusan daripada harga bersih, jadi margin meningkat dengan pelan yang lebih besar.
Caj perkhidmatan
Caj berasingan bagi setiap pesanan, dipaparkan semasa pembayaran.
Termasuk dalam pakej
eSIM yang termasuk dalam pakej percutian atau sebagai hadiah bersama penerbangan.
- Penerbangan ke Dubai
- Hotel di Dubai
- Pemindahan lapangan terbang
- eSIM UAE
Mengapa agensi menambah eSIM
- Lebih banyak hasil bagi setiap tempahan
- Perkhidmatan tambahan yang diperlukan hampir setiap pelancong antarabangsa
- Penghantaran digital segera, tanpa stok
- Pelancong kembali untuk perjalanan seterusnya
Pilihan baucar. Airalo juga menjual baucar eSIM: anda membeli kod pengaktifan dan mengedarkannya melalui laman web, aplikasi, CRM atau e-mel anda. Pilih kaedah yang sepadan dengan perjanjian Airalo anda.
Penyelesaian masalah
Jika sesuatu tidak berfungsi, semak perkara ini dahulu
Kebanyakan masalah berpunca daripada kelayakan, persekitaran atau peranti. Ikuti senarai untuk masalah yang anda hadapi.
- Ujian sambungan gagal
- Client IDClient Secretakaun rakan kongsi aktifakses API didayakanSandbox atau ProductionHTTPS keluar dari pelayan andaSSL
- Tiada pakej eSIM dipaparkan
- Sambungan APIketersediaan pakejpersekitaranpenapis destinasirespons APIcache PHPTRAVELS
- Pesanan gagal
- Pakej tidak sah atau tidak tersediabaki Airalokegagalan tokenralat rangkaianpersekitaran salahisu sementara Airalo
- Kod QR tidak dipaparkan
- Pesanan selesaieSIM dikeluarkanICCID disimpandata pemasangan dipulangkanmedan QR dalam respons API
- Pelancong tidak dapat memasang eSIM
- Telefon menyokong eSIMtelefon tidak dikuncikod QR yang betuleSIM belum dipasangperayauan dihidupkanAPN jika perlu
Siapa buat apa
PHPTRAVELS mengendalikan perisian, Airalo mengendalikan eSIM
Airalo ialah pembekal luar. Hubungan komersial adalah antara perniagaan pelancongan anda dan Airalo.
PHPTRAVELS
- Penyambung Airalo dan tetapannya
- Halaman eSIM, carian dan pembayaran
- Markup dan gerbang pembayaran anda
- Baucar, e-mel dan ICCID pada tempahan
- Sokongan untuk integrasi itu sendiri
Airalo
- Kelulusan rakan kongsi dan kelayakan API
- Harga pakej, komisen dan peraturan baki
- Liputan, rangkaian dan ketersediaan pakej
- Masa operasi API dan pengeluaran eSIM
- Perjanjian komersial anda
Keselamatan
Lindungi kelayakan Airalo anda
- Buat pengesahan dari pelayan sahaja, jangan sekali-kali dalam JavaScript pelayar
- Gunakan HTTPS untuk laman web dan admin anda
- Lindungi panel admin dan hadkan akses pelayan
- Pastikan PHPTRAVELS sentiasa dikemas kini
- Pantau aktiviti API yang luar biasa
Airalo
Perlukan bantuan dengan integrasi?
Jika akaun Airalo anda telah diluluskan tetapi integrasi memaparkan ralat, buka tiket sokongan dalam akaun PHPTRAVELS anda dengan: versi PHPTRAVELS, tangkapan skrin tetapan Airalo, keputusan ujian, contoh destinasi dan pakej, rujukan tempahan dan mesej ralat. Jangan sekali-kali sertakan Client Secret penuh.
Baca: cara agensi pelancongan boleh menjual eSIM dalam talianDokumentasi pembangun Airalo
Tidak. Anda memerlukan akaun rakan kongsi Airalo anda sendiri yang telah diluluskan. PHPTRAVELS menyediakan perisian dan penyambung Airalo sedia guna.
Airalo menghantar Client ID dan Client Secret selepas meluluskan akaun rakan kongsi anda. PHPTRAVELS tidak mengeluarkannya.
Pelanggan PHPTRAVELS boleh menghantar e-mel kepada Rao Suhaib Khan, Head of Partnerships di Airalo, di rao.khan@airalo.com, dan menyatakan bahawa mereka menggunakan PHPTRAVELS.
Ya. Dengan akaun rakan kongsi Airalo yang diluluskan dan penyambung PHPTRAVELS, pakej Airalo yang disokong dipaparkan di laman web anda sendiri dan tempahan kekal di laman anda.
Ya, markup tetap, markup peratusan atau caj perkhidmatan, selagi ia selaras dengan perjanjian komersial anda dengan Airalo.
Ya. Airalo mempunyai mod Sandbox di mana pesanan ujian tidak mengeluarkan eSIM sebenar. Tukar ke Production hanya selepas keseluruhan aliran berfungsi.
Ya. Airalo menawarkan pakej tempatan, serantau dan global, bergantung pada inventori yang tersedia untuk setiap destinasi.
Dengan kod QR, dengan memasukkan kod pengaktifan dan alamat SM-DP+, dengan arahan langkah demi langkah Airalo, daripada pautan eSIM Cloud atau PDF, atau dengan pautan pemasangan terus pada iPhone yang serasi.
Tidak. Airalo mempunyai SDK untuk PHP, Node.js dan Python, tetapi penyambung sudah tersedia dalam PHPTRAVELS. Anda hanya perlu menambah kelayakan anda.
Terokai lagi
Lagi tentang platform
- eSIM
- Integrasi API TiqetsTiket tarikan Tiqets dalam enjin tempahan anda
- Integrasi API ViatorLawatan dan aktiviti Viator di laman tempahan anda
- Integrasi PKFARE APICarian, tempahan dan PNR PKFARE dalam portal anda
- Integrasi API RateHawkHotel RateHawk dalam enjin tempahan anda, penyambung sedia ada
- API pelanconganAPI GDS, hotel, lawatan, kereta dan pembayaran
