eSIM-API-Integration: eSIMs per API bereitstellen

2. Juli 2026·8 Min. Lesezeit·Von eSIM Tech
Code-Editor mit Anfrage und Antwort einer eSIM-Bereitstellungs-API

Eine eSIM-API gehört zu den Funktionen mit der größten Hebelwirkung, die ein Reise- oder Telekommunikationsprodukt einbauen kann: Mit ein paar Endpunkten wird Ihr Checkout zum Shop für Konnektivität. Dieser Leitfaden beschreibt die komplette Integration aus Entwicklersicht, von der Bereitstellung über die Auslieferung und Webhooks bis zu den Sonderfällen, um die Sie sich kümmern sollten.

Der Kernablauf

Jede eSIM-Reseller-Integration lässt sich auf drei Schritte reduzieren:

1. Customer pays          →  your checkout
2. Provision the eSIM     →  POST /v1/esims
3. Deliver the QR code    →  confirmation page + email

Bereitstellung

Ist die Zahlung erfolgreich, macht Ihr Backend einen einzigen Aufruf:

curl -X POST https://api.esim.tech/v1/esims \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "product": "local-nl-unlimited",
    "reference": "order_8412"
  }'

Die Antwort kommt sofort und enthält alles, was Sie brauchen:

{
  "id": "esim_L4nX...",
  "iccid": "8931089...",
  "lpa": "LPA:1$smdp.esim.tech$K9MX-....",
  "phone_number": "+31612345678",
  "status": "ready",
  "created_at": "2026-07-02T09:41:12Z"
}

Der LPA-Code steckt direkt in der Antwort. Sie müssen also weder pollen noch auf eine E-Mail oder einen asynchronen Job warten. Bei rund 120 ms von Anfang bis Ende können Sie den Aufruf synchron im Checkout ausführen. Bei lokalen eSIM-Produkten kommt die Telefonnummer in derselben Antwort, sodass Sie dem Kunden seine neue lokale Nummer zeigen können, bevor er den QR-Code überhaupt gescannt hat.

Auslieferung

Wandeln Sie die LPA-Zeichenfolge in einen QR-Code um (jede QR-Bibliothek reicht, die Zeichenfolge ist der Inhalt) und

  • zeigen Sie ihn auf der Bestätigungsseite,
  • schicken Sie ihn zusätzlich per E-Mail (Kunden installieren oft später im WLAN),
  • bieten Sie auf Mobilgeräten auch die Installation per Universal Link an, damit Nutzer auf demselben Gerät keinen zweiten Bildschirm zum Scannen brauchen.

Webhooks für den Lebenszyklus

Registrieren Sie einen Webhook-Endpunkt, dann erhalten Sie Ereignisse wie diese:

{ "type": "esim.activated",   "esim": "esim_L4nX", "at": "..." }
{ "type": "usage.threshold",  "esim": "esim_L4nX", "used_mb": 4096, "threshold": 0.8 }
{ "type": "balance.low",      "esim": "esim_L4nX", "remaining_mb": 512 }

Lösen Sie mit dem Ereignis balance.low eine E-Mail mit Aufladung per Klick aus. Sie erreicht den Kunden genau dann, wenn er am ehesten kauft. Reseller, die das automatisieren, erzielen typischerweise 20 bis 30 % mehr Umsatz pro Kunde.

Designentscheidungen, die Sie richtig treffen sollten

Idempotenz. Übergeben Sie Ihre Bestellnummer als reference und wiederholen Sie Aufrufe bei Netzwerkfehlern gefahrlos. So stellen Sie nie zwei eSIMs für eine Bestellung bereit (und bezahlen sie auch nicht doppelt).

Erst bei Zahlung bereitstellen. eSIMs werden bei der Bereitstellung abgerechnet. Erzeugen Sie sie nicht vorab für abgebrochene Warenkörbe.

Die ICCID speichern. Sie ist die stabile Kennung, die Sie für Support, Aufladungen und Verbrauchsabfragen nutzen.

Die Frage „Kann mein Telefon das?“ früh klären. Prüfen Sie die eSIM-Kompatibilität des Geräts in Ihrer Oberfläche vor dem Checkout und nicht erst hinterher in einer Erstattungs-E-Mail.

Produkttypen, die Sie bereitstellen können

Eine Integration gibt Ihnen Zugriff auf den gesamten Katalog:

  • Pay As You Go: Abrechnung pro MB, Aufladungen per API, über 190 Länder
  • Lokale eSIMs: echte lokale Telefonnummer, Telefonie, SMS und (unbegrenzte) Daten in über 25 Ländern
  • EU-Datenpakete: bis 500 GB für Router, Wohnmobile und Flotten in der ganzen EU
  • 5G-Backup: Ausfallsicherung für feste Standorte

Alle haben dieselbe API-Struktur, nur die Kennung product ändert sich. Eine spätere Erweiterung Ihres Angebots ist damit eine Konfigurationsänderung und kein neues Projekt. Wenn Sie zuerst die geschäftliche Seite prüfen möchten, beginnen Sie mit eSIM-Reseller werden.

Live gehen

  1. Legen Sie Ihr Konto unter resellers.esim.tech an
  2. Integrieren Sie Bereitstellung und QR-Darstellung gegen die Sandbox
  3. Binden Sie den Webhook-Endpunkt an (mindestens Aktivierung und niedriges Guthaben)
  4. Testen Sie den kompletten Installationsablauf auf einem echten iPhone und einem echten Android-Gerät
  5. Wechseln Sie zu den Live-Schlüsseln und gehen Sie online

Die Authentifizierung läuft über einen normalen Bearer-Token, die API ist schlichtes REST/JSON, und es gibt keine Mindestmengen. Ihre erste bereitgestellte eSIM kann also direkt an einen echten Kunden gehen.

Häufige Fragen

Was ist ein LPA-Code?

Der LPA-Code (Local Profile Assistant) ist die Aktivierungszeichenfolge, mit der ein eSIM-fähiges Gerät sein SIM-Profil herunterlädt. Meist wird er als QR-Code angezeigt. Format: LPA:1$smdp.example.com$ACTIVATION-CODE. Liefert Ihre API ihn sofort zurück, können Sie den QR-Code direkt im Checkout zeigen.

Wie schnell ist die eSIM-Bereitstellung per API?

Bei eSIM.tech liefert ein Aufruf von POST /v1/esims den LPA-Code und die ICCID in rund 120 Millisekunden von Anfang bis Ende zurück. Das reicht, um synchron während des Checkouts bereitzustellen.

Brauche ich spezielles Telekommunikationswissen für eine eSIM-API?

Nein. Wer eine Zahlungs-API anbinden kann, kann auch eine eSIM-API anbinden. Die Komplexität der Telekommunikation (SM-DP+-Server, Verträge mit Netzbetreibern, Profilerzeugung) steckt hinter der REST-Schnittstelle.

Wie installieren Kunden die eSIM?

Sie scannen den angezeigten QR-Code (oder tippen auf demselben Gerät auf einen Universal Link). iOS und Android laden das Profil dann herunter und installieren es. Eine klare Installationsanleitung pro Plattform senkt die Zahl der Support-Tickets deutlich.