Was ist ein LPA-Code? eSIM-Aktivierungscodes erklärt
Wenn Sie eSIMs verkaufen, ist der LPA-Code das Produkt, das Ihr Kunde tatsächlich erhält. Alles andere (die Verträge mit den Netzen, der Datentarif, die Telefonnummer) kommt über eine kurze Zeichenfolge beim Kunden an. Dieser Artikel erklärt, was in dieser Zeichenfolge steckt und wie Sie sie an Kunden übergeben, ohne Support-Tickets zu produzieren.
Was ein LPA-Code ist
LPA steht für Local Profile Assistant: der Teil des Betriebssystems eines Smartphones, der eSIM-Profile herunterlädt und installiert. Ein LPA-Code (auch eSIM-Aktivierungscode genannt) ist die Anweisung an den LPA: Geh zu diesem Server und lade dieses Profil herunter.
Den rohen Code sehen Kunden selten. Sie sehen einen QR-Code, also dieselbe Zeichenfolge als Bild. Ob man den QR-Code scannt oder die Zeichenfolge von Hand eintippt, das Ergebnis ist dasselbe.
Was in einem LPA-Code steht
Ein Aktivierungscode folgt einem Format, das die GSMA festgelegt hat, der Branchenverband der Mobilfunkindustrie. Er sieht so aus:
LPA:1$smdp.example.com$K9MX-4F2A-77QB-0C3D
Er besteht aus drei Teilen, getrennt durch $:
| Teil | Beispiel | Bedeutung |
|---|---|---|
| Präfix und Format | LPA:1 |
Sagt dem Gerät, dass es sich um einen eSIM-Aktivierungscode handelt |
| SM-DP+-Adresse | smdp.example.com |
Der Server, auf dem das eSIM-Profil liegt |
| Matching ID | K9MX-4F2A-… |
Legt fest, welches Profil heruntergeladen wird |
Manche Codes haben einen optionalen vierten Teil, der den Kunden vor dem Download nach einem Bestätigungscode fragt. Die meisten eSIMs für Endkunden verzichten darauf.
So läuft die Installation ab
- Der Kunde scannt den QR-Code oder öffnet den Installationslink auf demselben Gerät.
- Der LPA des Smartphones liest die SM-DP+-Adresse und kontaktiert diesen Server.
- Der Server prüft die Matching ID und schickt das verschlüsselte eSIM-Profil.
- Das Smartphone installiert das Profil. Ab dann verhält es sich wie eine SIM-Karte dieses Netzbetreibers.
Das Ganze dauert Sekunden und braucht eine Internetverbindung, meist WLAN, weil die neue eSIM des Kunden noch nicht aktiv ist.
Warum ein LPA-Code meist nur einmal funktioniert
Ein Aktivierungscode verweist auf genau ein eSIM-Profil. Ist dieses Profil einmal auf ein Gerät geladen, ist der Code in der Regel verbraucht. Darauf sollten Sie sich einstellen:
- Entfernt ein Kunde die eSIM von seinem Smartphone, lässt sie sich mit demselben QR-Code meist nicht erneut installieren. Er braucht ein neues Profil.
- Screenshots werden weitergegeben. Behandeln Sie den Code deshalb wie einen Gutschein: Wer ihn zuerst installiert, bekommt das Profil.
- Wer eine eSIM auf ein neues Smartphone umziehen will, bekommt in der Regel ein neues Profil, statt den alten Code wiederzuverwenden.
Sagen Sie das Ihren Kunden vorab, am besten auf dem Bildschirm mit dem QR-Code. Damit fällt das häufigste eSIM-Support-Ticket weg.
Wie Reseller LPA-Codes ausliefern sollten
Die meisten Installationsprobleme entstehen durch die Art der Auslieferung, selten durch den Code selbst. Einige Vorgehensweisen, die sich bewährt haben:
- Zeigen Sie den QR-Code direkt nach der Zahlung an. Wenn Ihre Plattform den Code sofort liefert, gibt es keinen Grund, Kunden auf eine E-Mail warten zu lassen.
- Schicken Sie ihn zusätzlich per E-Mail, denn viele Reisende kaufen vor der Reise und installieren später im Hotel-WLAN.
- Bieten Sie die manuelle Eingabe an. Zeigen Sie SM-DP+-Adresse und Aktivierungscode auch als Text, für Kunden, die keinen QR-Code scannen können, der auf genau dem Smartphone angezeigt wird, auf dem sie installieren.
- Ergänzen Sie kurze Installationsschritte je Plattform. Die Menüs von iPhone und Android unterscheiden sich, und ein Screenshot pro Plattform erspart viel Hin und Her.
- Prüfen Sie die Gerätekompatibilität vor dem Checkout, nicht danach. Ein LPA-Code lässt sich nicht auf einem Smartphone installieren, das keine eSIM unterstützt oder an einen anderen Netzbetreiber gebunden ist.
LPA-Codes bei eSIM.tech
Bei eSIM.tech liefert ein einziger Bereitstellungsaufruf den LPA-Aktivierungscode in derselben API-Antwort, in rund 120 ms. Die Antwort enthält außerdem die ICCID, einen QR-Code als Base64-PNG und bei lokalen eSIMs und USA-eSIMs die Telefonnummer. Kein Polling, kein Warten auf eine E-Mail: Sie können den QR-Code auf Ihrer Bestätigungsseite anzeigen, im selben Request, der die Zahlung abgeschlossen hat.
Den kompletten Integrationsablauf, von der Bereitstellung bis zu Webhooks für Verbrauch und niedriges Guthaben, finden Sie in unserem Leitfaden zur eSIM-API-Integration.
Häufige Fragen
Wofür steht LPA?
LPA steht für Local Profile Assistant: die Software auf Smartphone oder Tablet, die eSIM-Profile herunterlädt und installiert. Der „LPA-Code“ ist der Aktivierungscode, den Sie dieser Software übergeben, meist als QR-Code.
Ist ein LPA-Code dasselbe wie ein eSIM-QR-Code?
In der Praxis ja. Der QR-Code ist einfach der LPA-Aktivierungscode als Bild. Ob man den QR-Code scannt oder den Code von Hand eintippt, das Ergebnis ist dasselbe.
Kann man einen LPA-Code mehrmals verwenden?
In der Regel nicht. Ein Aktivierungscode gehört normalerweise zu genau einem eSIM-Profil. Sobald dieses Profil auf ein Gerät geladen wurde, ist der Code verbraucht. Löscht ein Kunde die eSIM, braucht er meist eine neue.
Wie bekomme ich als Reseller LPA-Codes?
Bei eSIM.tech liefert jeder Bereitstellungsaufruf den LPA-Aktivierungscode in derselben API-Antwort, zusammen mit der ICCID und bei lokalen eSIMs der Telefonnummer. Der QR-Code ist als Base64-PNG enthalten, sodass Sie ihn sofort im Checkout anzeigen können.
