Live-Demo

eSIM API Integration

Airalo API Integration: eSIMs zu jeder Reise verkaufen

Verbinden Sie Ihr Airalo-Partnerkonto mit PHPTRAVELS und verkaufen Sie lokale, regionale und globale eSIMs auf Ihrer eigenen Website, neben Flügen, Hotels und Touren. Der Connector ist fertig: Client ID und Client Secret eintragen, in der Sandbox testen, Pakete synchronisieren, Preis festlegen und live gehen.

  • Fertiger Airalo-Connector
  • Airalo Partner API v2
  • QR-Code und Installationsschritte
  • Ihr eigener Verkaufspreis

Der Anbieter

Was Airalo ist und warum Reisebüros seine eSIMs verkaufen

Airalo verkauft eSIMs: digitale SIM-Pakete, die Reisende auf dem Smartphone installieren, ohne die physische SIM zu entfernen. Statt am Flughafen eine lokale SIM zu kaufen, bucht der Reisende das Datenvolumen vor der Reise und installiert es in wenigen Minuten.

Über die Airalo Partner API kann ein Reiseunternehmen dieses Angebot auf der eigenen Website oder in der eigenen App verkaufen. PHPTRAVELS liefert im eSIM-Modul einen Airalo-Connector mit. So wird die eSIM zu einem weiteren Produkt im selben Warenkorb wie Flug, Hotel, Transfer, Visum oder Tour.

Verwandte Themen:eSIMReise-APIsReise-API-Integration

Anbieter-Steckbrief
Unternehmen
Airalo, Anbieter für eSIM-Konnektivität
Abdeckung
200+ Reiseziele, laut Airalo
Pakete
Lokale, regionale und globale eSIMs
API
Partner API v2 · REST · Bearer-Token
SDKs
PHP · Node.js · Python
In PHPTRAVELS
Fertiger Connector im eSIM-Modul

Schritt 1 · Partnerkonto

Beantragen Sie ein Airalo-Partnerkonto

Für den Zugang zur Airalo API brauchen Sie eine Partnervereinbarung mit Airalo. PHPTRAVELS vergibt keine Airalo-Konten oder Schlüssel: Sie stellen den Antrag, Airalo prüft Ihr Unternehmen und sendet Ihnen die Zugangsdaten.

Was Sie Airalo senden

  • Firmenname und Website
  • Land und Geschäftsart
  • Erwartetes eSIM-Verkaufsvolumen
  • Zielmärkte und Reiseziele
  • B2C, B2B oder beides
  • Dass Sie PHPTRAVELS nutzen

Schritt 2 · Zugangsdaten

Client ID, Client Secret und das Access Token

Sobald Airalo Ihr Konto freigibt, erhalten Sie eine Client ID und ein Client Secret. PHPTRAVELS sendet beide von Ihrem Server an den Token-Endpunkt, erhält ein Bearer Access Token und nutzt es für jede Anfrage zu Paketen, Bestellungen und eSIMs.

Token-Anfrage (Beispiel)
 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
Nur serverseitig
Das Token fordert Ihr PHPTRAVELS-Server an. Das Client Secret gelangt nie in den Browser.
Token-Wiederverwendung
Der Connector behält das Token bis zum Ablauf. So fordert er nicht bei jeder Suche ein neues an.
Secret vertraulich halten
Setzen Sie das Client Secret nie in öffentliches JavaScript, HTML, ein öffentliches Git-Repository, einen Screenshot oder einen Forenbeitrag.
Ein Konto, zwei Modi
In der Airalo-Konfiguration wählen Sie Sandbox oder Production. Testen Sie zuerst alles in der Sandbox.

Der Ablauf der Partner API

Fünf Airalo API-Aufrufe hinter jedem eSIM-Verkauf

Vom ersten Preis auf dem Bildschirm bis zum QR-Code im Posteingang des Reisenden nutzt der Connector dieselben fünf Aufrufe. Zu jedem sehen Sie, was PHPTRAVELS mit der Antwort macht.

  1. 01Token abrufenPOST/v2/token

    PHPTRAVELSMeldet sich mit Ihrer Client ID und Ihrem Client Secret an und speichert das Bearer-Token auf dem Server.

  2. 02Pakete auflistenGET/v2/packages

    PHPTRAVELSSynchronisiert lokale, regionale und globale Pakete mit Datenvolumen, Gültigkeit, Abdeckung und Nettopreis und wendet dann Ihren Preis an.

  3. 03Bestellung sendenPOST/v2/orders

    PHPTRAVELSBestellt nach der Zahlung die gewählte Paket-ID und Menge und speichert die Airalo-Bestellung in der Buchung.

  4. 04eSIM auslesenGET/v2/sims/{sim_iccid}

    PHPTRAVELSLiest die eSIM über ihre ICCID aus: QR-Code, Aktivierungscode, SM-DP+ Adresse und den direkten iOS-Installationslink.

  5. 05InstallationsschritteGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSHolt die Installationsanleitung von Airalo für Gerät und Sprache des Reisenden und fügt sie dem Voucher hinzu.

Schritte 3 bis 5 · PHPTRAVELS Admin

Airalo im Admin konfigurieren, testen und synchronisieren

Alles geschieht in den Einstellungen des eSIM-Moduls in Ihrem PHPTRAVELS Admin. Die genauen Felder hängen von Ihrer PHPTRAVELS-Version ab.

  1. 01eSIM-Modul aktivierenÖffnen Sie die Moduleinstellungen und schalten Sie die Airalo eSIM-Integration ein.
  2. 02Zugangsdaten eingebenFügen Sie Client ID und Client Secret von Airalo ein, wählen Sie Sandbox und speichern Sie.
  3. 03Verbindung testenKlicken Sie auf Testen. PHPTRAVELS meldet sich bei Airalo an und zeigt den Status Verbunden oder den zu behebenden Fehler.
  4. 04Pakete synchronisierenLaden Sie die Airalo-Pakete und prüfen Sie, ob Reiseziele, Datenvolumen, Gültigkeit und Preise auf Ihrer Website stimmen.
eSIM-Modul · AiraloAiralo

Umgebung

Testbestellungen: es wird keine echte eSIM bereitgestelltLive-Bestellungen: echte eSIMs, abgerechnet über Ihr Airalo-Guthaben

Client ID7f3c…a91e
Client Secret••••••••••••••••
Aufschlag15 % auf den Nettopreis
StatusVerbunden

Beispielansicht. Die Felder können in Ihrer Version abweichen.

Schritt 5 · eSIM-Pakete

Lokale, regionale und globale eSIMs aus einem Feed

Airalo liefert drei Arten von Paketen. So passen Sie die eSIM an die Reiseroute an. Pakete, Preise und Verfügbarkeit kommen immer live von Airalo.

  • Lokale eSIM

    Ein Reiseziel, für eine Reise in ein einzelnes Land.

    BeispielUSA eSIM

  • Regionale eSIM

    Mehrere Länder einer Region, für Reisen durch mehrere Länder.

    BeispielEuropa eSIM

  • Globale eSIM

    Länder in mehreren Regionen, für lange Reisen oder Weltreisen.

    BeispielGlobale eSIM

Für Reisende sichtbar
Reiseziel · Paketname · Datenvolumen · Gültigkeit · Netz · Abdeckung · Preis
Übliche Datenvolumen: 1 GB, 3 GB, 5 GB und 10 GB, jeweils mit eigener Gültigkeit.

Schritte 6 bis 9 · Der Verkauf

So kauft ein Reisender eine Airalo eSIM auf Ihrer Website

Der Reisende verlässt Ihre Website nie. PHPTRAVELS übernimmt Buchung und Zahlung, Airalo stellt die eSIM bereit.

  1. 01Reisender

    Öffnet den eSIM-Bereich Ihrer Website

  2. 02Reisender

    Wählt ein Reiseziel

  3. 03PHPTRAVELS

    Zeigt die Airalo-Pakete mit Ihrem Preis

  4. 04Reisender

    Wählt ein Paket

  5. 05Reisender

    Bucht und zahlt über Ihr Zahlungsgateway

  6. 06PHPTRAVELS

    Sendet die Bestellung an die Airalo API

  7. 07Airalo

    Stellt die eSIM bereit

  8. 08Airalo

    Liefert QR-Code und Installationsdaten

  9. 09PHPTRAVELS

    Sendet dem Reisenden die eSIM per E-Mail und ins Kundenkonto

eSIM-Auslieferung

Fünf Wege, wie Reisende die eSIM installieren

Airalo unterstützt für API-Partner mehrere Installationswege. PHPTRAVELS zeigt die Daten auf dem Buchungsvoucher, in der Bestätigungs-E-Mail und im Konto des Reisenden.

  • QR-Code

    Der Reisende scannt den QR-Code in den eSIM-Einstellungen des Smartphones.

  • Manuelle Eingabe

    Aktivierungscode und SM-DP+ Adresse, für Smartphones, die nicht scannen können.

  • Airalo-Anleitung

    Schrittweise Installationsanleitung aus der API, je nach Gerät und Sprache.

  • eSIM Cloud-Link oder PDF

    Ein Freigabelink oder PDF von Airalo mit der vollständigen Installationsanleitung.

  • Direkte iOS-Installation

    Ein Installationslink mit einem Tipp für kompatible iPhones mit unterstützten iOS-Versionen.

Kundendaten

Jeden Kunden einer ICCID zuordnen

Airalo erkennt jede eSIM an ihrer ICCID und speichert bei diesem Ablauf keine personenbezogenen Daten Ihrer Reisenden. Die Verbindung zwischen Reisendem und eSIM halten Sie selbst. PHPTRAVELS erledigt das in der Buchung.

  1. Kunde
  2. PHPTRAVELS-Buchung
  3. Airalo-Bestellung
  4. ICCID

Diese Kette erleichtert den Support:SupportanfragenInstallationsproblemeBestellsucheBuchungshistorieeSIM-Status

Schritt 7 · Ihr Preis

Legen Sie Ihren Verkaufspreis fest und verdienen Sie an jeder eSIM

Airalo berechnet Ihnen die Paketkosten gemäß Ihrer Handelsvereinbarung. Was der Reisende zahlt, entscheiden Sie im Rahmen Ihrer Vereinbarung mit Airalo.

  • Fester Aufschlag

    Derselbe Betrag zusätzlich auf jedes Paket.

  • Prozentualer Aufschlag

    Ein Prozentsatz vom Nettopreis. So wächst die Marge mit größeren Paketen.

  • Servicegebühr

    Eine separate Gebühr pro Bestellung, angezeigt an der Kasse.

  • Im Paket enthalten

    Eine eSIM als Teil einer Pauschalreise oder als Geschenk zum Flug.

Beispiel für Cross-Selling
  1. Flug nach Dubai
  2. Hotel in Dubai
  3. Flughafentransfer
  4. VAE eSIM

Warum Reisebüros eSIMs anbieten

  • Mehr Umsatz pro Buchung
  • Eine Zusatzleistung, die fast jeder internationale Reisende braucht
  • Sofortige digitale Auslieferung, kein Lager
  • Reisende kommen für die nächste Reise zurück

Die Voucher-Option. Airalo verkauft auch eSIM-Voucher: Sie kaufen Aktivierungscodes und geben sie über Ihre Website, App, Ihr CRM oder per E-Mail aus. Wählen Sie den Weg, der zu Ihrer Airalo-Vereinbarung passt.

Fehlerbehebung

Wenn etwas nicht funktioniert, prüfen Sie zuerst diese Punkte

Die meisten Probleme betreffen Zugangsdaten, Umgebung oder Gerät. Gehen Sie die Liste für Ihr Problem von oben nach unten durch.

Der Verbindungstest schlägt fehl
Client IDClient SecretPartnerkonto aktivAPI-Zugang freigeschaltetSandbox oder Productionausgehendes HTTPS von Ihrem ServerSSL
Es werden keine eSIM-Pakete angezeigt
API-VerbindungPaketverfügbarkeitUmgebungReisezielfilterdie API-AntwortPHPTRAVELS-Cache
Eine Bestellung schlägt fehl
Ungültiges oder nicht verfügbares PaketAiralo-GuthabenToken-FehlerNetzwerkfehlerfalsche Umgebungvorübergehendes Problem bei Airalo
Der QR-Code wird nicht angezeigt
Bestellung abgeschlosseneSIM bereitgestelltICCID gespeichertInstallationsdaten geliefertQR-Felder in der API-Antwort
Der Reisende kann nicht installieren
Smartphone unterstützt eSIMSmartphone ohne SIM-Lockder richtige QR-CodeeSIM nicht bereits installiertRoaming anAPN, falls nötig

Wer macht was

PHPTRAVELS betreibt die Software, Airalo die eSIMs

Airalo ist ein externer Anbieter. Die Geschäftsbeziehung besteht zwischen Ihrem Reiseunternehmen und Airalo.

PHPTRAVELS

  • Der Airalo-Connector und seine Einstellungen
  • Die eSIM-Seiten, Suche und Checkout
  • Ihr Aufschlag und Ihre Zahlungsgateways
  • Voucher, E-Mails und die ICCID in der Buchung
  • Support für die Integration selbst

Airalo

  • Partnerfreigabe und API-Zugangsdaten
  • Paketpreise, Provisionen und Guthabenregeln
  • Abdeckung, Netze und Paketverfügbarkeit
  • API-Verfügbarkeit und eSIM-Bereitstellung
  • Ihre Handelsvereinbarung

Sicherheit

Schützen Sie Ihre Airalo-Zugangsdaten

  • Authentifizierung nur über den Server, nie im Browser-JavaScript
  • Nutzen Sie HTTPS für Website und Admin
  • Sichern Sie das Admin-Panel und beschränken Sie den Serverzugang
  • Halten Sie PHPTRAVELS aktuell
  • Achten Sie auf ungewöhnliche API-Aktivität
  • Airalo

Brauchen Sie Hilfe bei der Integration?

Wenn Ihr Airalo-Konto freigegeben ist, die Integration aber einen Fehler zeigt, eröffnen Sie ein Support-Ticket in Ihrem PHPTRAVELS-Konto mit: Ihrer PHPTRAVELS-Version, einem Screenshot der Airalo-Einstellungen, dem Testergebnis, einem Beispiel für Reiseziel und Paket, der Buchungsnummer und der Fehlermeldung. Senden Sie nie das vollständige Client Secret.

Support-Ticket eröffnenPreise ansehenDemo buchen

Lesen: So verkaufen Reisebüros eSIMs onlineAiralo-Entwicklerdokumentation

FAQ

Airalo API Integration: Fragen von Reisebüros

Vertrieb kontaktieren

Nein. Sie brauchen Ihr eigenes, freigegebenes Airalo-Partnerkonto. PHPTRAVELS liefert die Software und den fertigen Airalo-Connector.

Airalo sendet Client ID und Client Secret, nachdem es Ihr Partnerkonto freigegeben hat. PHPTRAVELS vergibt sie nicht.

PHPTRAVELS-Kunden können Rao Suhaib Khan, Head of Partnerships bei Airalo, unter rao.khan@airalo.com schreiben und erwähnen, dass sie PHPTRAVELS nutzen.

Ja. Mit einem freigegebenen Airalo-Partnerkonto und dem PHPTRAVELS-Connector erscheinen unterstützte Airalo-Pakete auf Ihrer eigenen Website, und die Buchung bleibt bei Ihnen.

Ja, einen festen oder prozentualen Aufschlag oder eine Servicegebühr, sofern dies zu Ihrer Handelsvereinbarung mit Airalo passt.

Ja. Airalo hat einen Sandbox-Modus, in dem Testbestellungen keine echten eSIMs bereitstellen. Wechseln Sie erst zu Production, wenn der gesamte Ablauf funktioniert.

Ja. Airalo bietet lokale, regionale und globale Pakete an, je nach verfügbarem Angebot für das jeweilige Reiseziel.

Per QR-Code, durch Eingabe von Aktivierungscode und SM-DP+ Adresse, mit der schrittweisen Anleitung von Airalo, über einen eSIM Cloud-Link oder ein PDF oder mit einem direkten Installationslink auf kompatiblen iPhones.

Nein. Airalo bietet SDKs für PHP, Node.js und Python, aber der Connector ist bereits in PHPTRAVELS enthalten. Sie tragen nur Ihre Zugangsdaten ein.

Weiter entdecken

Mehr zur Plattform