Canlı demo

eSIM API entegrasyonu

Airalo API entegrasyonu: her seyahatle eSIM satın

Airalo iş ortağı hesabınızı PHPTRAVELS'a bağlayın ve yerel, bölgesel ve küresel eSIM'leri kendi sitenizde uçuş, otel ve turların yanında satın. Bağlayıcı hazır: Client ID ve Client Secret bilgilerinizi ekleyin, sandbox'ta test edin, paketleri senkronize edin, fiyatınızı belirleyin ve yayına alın.

  • Hazır Airalo bağlayıcısı
  • Airalo Partner API v2
  • QR kod ve kurulum adımları
  • Kendi satış fiyatınız

Tedarikçi

Airalo nedir ve seyahat acenteleri neden eSIM'lerini satar

Airalo eSIM satar: yolcunun fiziksel SIM kartı çıkarmadan telefonuna kurduğu dijital SIM paketleri. Yolcu havalimanında yerel SIM almak yerine veriyi seyahatten önce satın alır ve birkaç dakikada kurar.

Airalo Partner API sayesinde bir seyahat işletmesi bu envanteri kendi sitesinde veya uygulamasında satabilir. PHPTRAVELS, eSIM modülünde bir Airalo bağlayıcısı sunar. Böylece eSIM; uçuş, otel, transfer, vize veya turla aynı sepette yer alan bir ürün olur.

İlgili:eSIMSeyahat API'leriSeyahat API entegrasyonu

Tedarikçi bilgi kartı
Şirket
Airalo, eSIM bağlantı sağlayıcısı
Kapsama
Airalo'ya göre 200'den fazla destinasyon
Paketler
Yerel, bölgesel ve küresel eSIM'ler
API
Partner API v2 · REST · Bearer token
SDK'lar
PHP · Node.js · Python
PHPTRAVELS'ta
eSIM modülünde hazır bağlayıcı

Adım 1 · İş ortağı hesabı

Airalo iş ortağı hesabına başvurun

Airalo API erişimi için Airalo ile bir iş ortaklığı sözleşmesi gerekir. PHPTRAVELS Airalo hesabı veya anahtarı vermez: siz başvurursunuz, Airalo işletmenizi inceler ve kimlik bilgilerinizi gönderir.

Airalo'ya gönderilecekler

  • Şirket adı ve web sitesi
  • Ülke ve işletme türü
  • Beklenen eSIM satış hacmi
  • Hedef pazarlar ve destinasyonlar
  • B2C, B2B veya her ikisi
  • PHPTRAVELS kullandığınız bilgisi

Adım 2 · Kimlik bilgileri

Client ID, Client Secret ve erişim token'ı

Airalo hesabınızı onayladığında bir Client ID ve bir Client Secret alırsınız. PHPTRAVELS bunları sunucunuzdan token uç noktasına gönderir, bir Bearer erişim token'ı alır ve her paket, sipariş ve eSIM isteğinde kullanır.

Token isteği (örnek)
 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
Yalnızca sunucu tarafında
Token'ı PHPTRAVELS sunucunuz ister. Client Secret asla tarayıcıya ulaşmaz.
Token'ın yeniden kullanımı
Bağlayıcı token'ı süresi dolana kadar saklar. Her aramada yeni token istemez.
Secret'ı gizli tutun
Client Secret'ı asla herkese açık JavaScript'e, HTML'ye, açık bir Git deposuna, ekran görüntüsüne veya forum gönderisine koymayın.
Tek hesap, iki mod
Airalo, yapılandırmasında Sandbox veya Production seçmenize izin verir. Her şeyi önce Sandbox'ta test edin.

Partner API akışı

Her eSIM satışının arkasındaki beş Airalo API çağrısı

Ekrandaki ilk fiyattan yolcunun gelen kutusundaki QR koda kadar bağlayıcı aynı beş çağrıyı kullanır. Her biri PHPTRAVELS'ın yanıtla ne yaptığını gösterir.

  1. 01Token almaPOST/v2/token

    PHPTRAVELSClient ID ve Client Secret ile oturum açar ve Bearer token'ı sunucuda saklar.

  2. 02Paketleri listelemeGET/v2/packages

    PHPTRAVELSYerel, bölgesel ve küresel paketleri veri, geçerlilik, kapsama ve net fiyatla senkronize eder, ardından fiyatınızı uygular.

  3. 03Sipariş göndermePOST/v2/orders

    PHPTRAVELSÖdemeden sonra seçilen paket ID'si ve adediyle sipariş verir ve Airalo siparişini rezervasyona kaydeder.

  4. 04eSIM'i okumaGET/v2/sims/{sim_iccid}

    PHPTRAVELSeSIM'i ICCID ile okur: QR kod, aktivasyon kodu, SM-DP+ adresi ve doğrudan iOS kurulum bağlantısı.

  5. 05Kurulum adımlarıGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSYolcunun cihazı ve dili için Airalo kurulum talimatlarını alır ve vouchera ekler.

Adım 3 ila 5 · PHPTRAVELS yönetim paneli

Airalo'yu yönetim panelinizde yapılandırın, test edin ve senkronize edin

Her şey PHPTRAVELS yönetim panelinizdeki eSIM modülü ayarlarında yapılır. Alanlar PHPTRAVELS sürümünüze göre değişebilir.

  1. 01eSIM modülünü etkinleştirinModül ayarlarını açın ve Airalo eSIM entegrasyonunu etkinleştirin.
  2. 02Kimlik bilgilerinizi girinAiralo'dan gelen Client ID ve Client Secret'ı yapıştırın, Sandbox'ı seçin ve kaydedin.
  3. 03Bağlantıyı test edinTest düğmesini kullanın. PHPTRAVELS Airalo'ya bağlanır ve bağlı durumunu ya da düzeltilmesi gereken hatayı gösterir.
  4. 04Paketleri senkronize edinAiralo paketlerini yükleyin ve destinasyon, veri, geçerlilik ve fiyatların sitenizde doğru göründüğünü kontrol edin.
eSIM modülü · AiraloAiralo

Ortam

Test siparişleri: gerçek eSIM sağlanmazCanlı siparişler: gerçek eSIM'ler, Airalo bakiyenizden düşülür

Client ID7f3c…a91e
Client Secret••••••••••••••••
Kâr payıNet fiyat üzerine %15
DurumBağlı

Örnek ekran. Alanlar sürümünüzde farklı olabilir.

Adım 5 · eSIM paketleri

Tek akışta yerel, bölgesel ve küresel eSIM'ler

Airalo üç tür paket sunar. Böylece eSIM'i yolcunun güzergâhına göre seçebilirsiniz. Paketler, fiyatlar ve uygunluk her zaman Airalo'dan canlı gelir.

  • Yerel eSIM

    Tek ülkeye yapılan seyahat için tek destinasyon.

    ÖrnekABD eSIM

  • Bölgesel eSIM

    Çok ülkeli bir seyahat için aynı bölgede birkaç ülke.

    ÖrnekAvrupa eSIM

  • Küresel eSIM

    Uzun seyahatler veya dünya turları için farklı bölgelerden ülkeler.

    ÖrnekKüresel eSIM

Yolcuya gösterilenler
Destinasyon · paket adı · veri · geçerlilik · şebeke · kapsama · fiyat
Tipik veri miktarları: 1 GB, 3 GB, 5 GB ve 10 GB, her biri kendi geçerlilik süresiyle.

Adım 6 ila 9 · Satış

Yolcu sitenizden Airalo eSIM'i nasıl satın alır

Yolcu sitenizden hiç ayrılmaz. Rezervasyonu ve ödemeyi PHPTRAVELS yürütür, eSIM'i Airalo sağlar.

  1. 01Yolcu

    Sitenizin eSIM bölümünü açar

  2. 02Yolcu

    Bir destinasyon seçer

  3. 03PHPTRAVELS

    Airalo paketlerini sizin fiyatınızla gösterir

  4. 04Yolcu

    Bir paket seçer

  5. 05Yolcu

    Ödeme altyapınızla rezervasyon yapar ve öder

  6. 06PHPTRAVELS

    Siparişi Airalo API'ye gönderir

  7. 07Airalo

    eSIM'i sağlar

  8. 08Airalo

    QR kodu ve kurulum bilgilerini döndürür

  9. 09PHPTRAVELS

    eSIM'i yolcuya e-postayla ve hesabında iletir

eSIM teslimatı

Yolcunun eSIM'i kurabileceği beş yol

Airalo, API iş ortakları için birkaç kurulum yöntemi destekler. PHPTRAVELS bu bilgileri rezervasyon voucherına, onay e-postasına ve yolcunun hesabına ekler.

  • QR kod

    Yolcu QR kodu telefonun eSIM ayarlarından tarar.

  • Manuel giriş

    Tarama yapamayan telefonlar için aktivasyon kodu ve SM-DP+ adresi.

  • Airalo talimatları

    API'den gelen, cihaza ve dile göre adım adım kurulum talimatları.

  • eSIM Cloud bağlantısı veya PDF

    Airalo'dan tam kurulum rehberini içeren bir paylaşım bağlantısı veya PDF.

  • Doğrudan iOS kurulumu

    Desteklenen iOS sürümlerindeki uyumlu iPhone'lar için tek dokunuşla kurulum bağlantısı.

Müşteri verileri

Her müşteriyi bir ICCID ile eşleyin

Airalo her eSIM'i ICCID ile tanımlar ve bu akışta yolcularınızın kişisel verilerini saklamaz. Yolcu ile eSIM arasındaki bağı korumak sizin görevinizdir ve PHPTRAVELS bunu rezervasyonda yapar.

  1. Müşteri
  2. PHPTRAVELS rezervasyonu
  3. Airalo siparişi
  4. ICCID

Bu zincir desteği kolaylaştırır:Destek talepleriKurulum sorunlarıSipariş sorgulamaRezervasyon geçmişieSIM durumu

Adım 7 · Fiyatınız

Satış fiyatınızı belirleyin ve her eSIM'den kazanın

Airalo size ticari sözleşmenizdeki paket maliyetini yansıtır. Yolcunun ne ödeyeceğine, Airalo ile yaptığınız sözleşme çerçevesinde siz karar verirsiniz.

  • Sabit kâr payı

    Her paketin üzerine aynı tutar.

  • Yüzdesel kâr payı

    Net fiyatın bir yüzdesi. Büyük paketlerde kâr marjı da büyür.

  • Hizmet bedeli

    Ödeme adımında gösterilen, sipariş başına ayrı bir ücret.

  • Pakete dahil

    Bir tatil paketine dahil edilen veya uçuşla hediye verilen eSIM.

Çapraz satış örneği
  1. Dubai uçuşu
  2. Dubai'de otel
  3. Havalimanı transferi
  4. BAE eSIM

Acenteler neden eSIM ekliyor

  • Rezervasyon başına daha fazla gelir
  • Neredeyse her uluslararası yolcunun ihtiyaç duyduğu ek hizmet
  • Anında dijital teslimat, stok yok
  • Yolcular bir sonraki seyahatleri için geri gelir

Voucher seçeneği. Airalo eSIM voucherları da satar: aktivasyon kodlarını satın alır ve sitenizde, uygulamanızda, CRM'inizde veya e-postayla dağıtırsınız. Airalo sözleşmenize uyan yöntemi seçin.

Sorun giderme

Bir şey çalışmadığında önce bunları kontrol edin

Sorunların çoğu kimlik bilgilerinden, ortamdan veya cihazdan kaynaklanır. Gördüğünüz sorunun listesini sırayla kontrol edin.

Bağlantı testi başarısız
Client IDClient Secretiş ortağı hesabı aktifAPI erişimi açıkSandbox veya Productionsunucunuzdan giden HTTPSSSL
eSIM paketi görünmüyor
API bağlantısıpaket uygunluğuortamdestinasyon filtreleriAPI yanıtıPHPTRAVELS önbelleği
Sipariş başarısız
Geçersiz veya mevcut olmayan paketAiralo bakiyesitoken hatasıağ hatasıyanlış ortamgeçici Airalo sorunu
QR kod görünmüyor
Sipariş tamamlandıeSIM sağlandıICCID kaydedildikurulum verisi döndüAPI yanıtında QR alanları
Yolcu kurulum yapamıyor
Telefon eSIM destekliyortelefon kilitsizdoğru QR kodeSIM daha önce kurulmamışdolaşım açıkgerekirse APN

Kim ne yapar

Yazılımı PHPTRAVELS, eSIM'leri Airalo yönetir

Airalo harici bir tedarikçidir. Ticari ilişki seyahat işletmeniz ile Airalo arasındadır.

PHPTRAVELS

  • Airalo bağlayıcısı ve ayarları
  • eSIM sayfaları, arama ve ödeme
  • Kâr payınız ve ödeme altyapılarınız
  • Voucherlar, e-postalar ve rezervasyondaki ICCID
  • Entegrasyonun kendisi için destek

Airalo

  • İş ortağı onayı ve API kimlik bilgileri
  • Paket fiyatları, komisyonlar ve bakiye kuralları
  • Kapsama, şebekeler ve paket uygunluğu
  • API çalışma süresi ve eSIM sağlama
  • Ticari sözleşmeniz

Güvenlik

Airalo kimlik bilgilerinizi koruyun

  • Kimlik doğrulamayı yalnızca sunucudan yapın, asla tarayıcı JavaScript'inde değil
  • Siteniz ve yönetim paneliniz için HTTPS kullanın
  • Yönetim panelini güvenceye alın ve sunucu erişimini kısıtlayın
  • PHPTRAVELS'ı güncel tutun
  • Olağandışı API etkinliğini izleyin
  • Airalo

Entegrasyon için yardıma mı ihtiyacınız var?

Airalo hesabınız onaylı olduğu halde entegrasyon hata veriyorsa, PHPTRAVELS hesabınızda şu bilgilerle bir destek talebi açın: PHPTRAVELS sürümünüz, Airalo ayarlarının ekran görüntüsü, test sonucu, örnek bir destinasyon ve paket, rezervasyon referansı ve hata mesajı. Client Secret'ın tamamını asla eklemeyin.

Destek talebi açınFiyatları görünDemo planlayın

Okuyun: seyahat acenteleri eSIM'i online nasıl satarAiralo geliştirici dokümantasyonu

SSS

Airalo API entegrasyonu: acentelerin sorduğu sorular

Satış ekibiyle görüşün

Hayır. Kendi onaylı Airalo iş ortağı hesabınız olmalıdır. PHPTRAVELS yazılımı ve hazır Airalo bağlayıcısını sağlar.

Airalo, iş ortağı hesabınızı onayladıktan sonra Client ID ve Client Secret'ı gönderir. PHPTRAVELS bunları vermez.

PHPTRAVELS müşterileri, Airalo İş Ortaklıkları Müdürü Rao Suhaib Khan'a rao.khan@airalo.com adresinden yazabilir ve PHPTRAVELS kullandıklarını belirtebilir.

Evet. Onaylı bir Airalo iş ortağı hesabı ve PHPTRAVELS bağlayıcısıyla desteklenen Airalo paketleri kendi sitenizde görünür ve rezervasyon sitenizde kalır.

Evet. Airalo ile ticari sözleşmenize uyduğu sürece sabit veya yüzdesel kâr payı ya da hizmet bedeli ekleyebilirsiniz.

Evet. Airalo'nun test siparişlerinin gerçek eSIM sağlamadığı bir Sandbox modu vardır. Tüm akış çalıştıktan sonra Production'a geçin.

Evet. Airalo, her destinasyon için mevcut envantere bağlı olarak yerel, bölgesel ve küresel paketler sunar.

QR kodla, aktivasyon kodu ve SM-DP+ adresini girerek, Airalo'nun adım adım talimatlarıyla, bir eSIM Cloud bağlantısı veya PDF ile ya da uyumlu iPhone'larda doğrudan kurulum bağlantısıyla.

Hayır. Airalo'nun PHP, Node.js ve Python için SDK'ları var, ancak bağlayıcı PHPTRAVELS'ta zaten hazır. Yalnızca kimlik bilgilerinizi eklersiniz.

Keşfetmeye devam edin

Platform hakkında daha fazlası