Demo langsung

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.

Berkaitan:eSIMAPI pelanconganIntegrasi API pelancongan

Lembaran fakta pembekal
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.

Permintaan token (contoh)
 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>
client_credentialsPartner API v2Bearer token · Sandbox → Production
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.

  1. 01Dapatkan tokenPOST/v2/token

    PHPTRAVELSLog masuk dengan Client ID dan Client Secret anda dan menyimpan token Bearer di pelayan.

  2. 02Senarai pakejGET/v2/packages

    PHPTRAVELSMenyegerakkan pakej tempatan, serantau dan global dengan data, tempoh sah, liputan dan harga bersih, kemudian menggunakan harga anda.

  3. 03Hantar pesananPOST/v2/orders

    PHPTRAVELSSelepas pembayaran, memesan ID pakej dan kuantiti yang dipilih serta menyimpan pesanan Airalo pada tempahan.

  4. 04Baca eSIMGET/v2/sims/{sim_iccid}

    PHPTRAVELSMembaca eSIM melalui ICCID: kod QR, kod pengaktifan, alamat SM-DP+ dan pautan pemasangan terus untuk iOS.

  5. 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.

  1. 01Dayakan modul eSIMBuka tetapan modul dan hidupkan integrasi eSIM Airalo.
  2. 02Masukkan kelayakan andaTampal Client ID dan Client Secret daripada Airalo, pilih Sandbox dan simpan.
  3. 03Uji sambunganGunakan butang Uji. PHPTRAVELS log masuk ke Airalo dan memaparkan status bersambung, atau ralat yang perlu dibaiki.
  4. 04Segerakkan pakejMuatkan pakej Airalo dan pastikan destinasi, data, tempoh sah dan harga dipaparkan dengan betul di laman web anda.
Modul eSIM · AiraloAiralo

Persekitaran

Pesanan ujian: tiada eSIM sebenar dikeluarkanPesanan sebenar: eSIM sebenar, dicaj pada baki Airalo anda

Client ID7f3c…a91e
Client Secret••••••••••••••••
Markup15% atas harga bersih
StatusBersambung

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.

  1. 01Pelancong

    Membuka bahagian eSIM di laman web anda

  2. 02Pelancong

    Memilih destinasi

  3. 03PHPTRAVELS

    Memaparkan pakej Airalo dengan harga anda

  4. 04Pelancong

    Memilih pakej

  5. 05Pelancong

    Menempah dan membayar melalui gerbang pembayaran anda

  6. 06PHPTRAVELS

    Menghantar pesanan ke API Airalo

  7. 07Airalo

    Mengeluarkan eSIM

  8. 08Airalo

    Memulangkan kod QR dan butiran pemasangan

  9. 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.

  1. Pelanggan
  2. Tempahan PHPTRAVELS
  3. Pesanan Airalo
  4. 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.

Contoh jualan silang
  1. Penerbangan ke Dubai
  2. Hotel di Dubai
  3. Pemindahan lapangan terbang
  4. 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

Soalan lazim

Integrasi API Airalo: soalan yang ditanya agensi

Hubungi jualan

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.