eSIM API-integratie: eSIMs automatisch aanmaken

2 jul 2026·8 min leestijd·Door eSIM Tech
Code-editor met een request en response van een eSIM-provisioning-API

Een eSIM API integreren is een van de features met de grootste hefboom die een reis- of telecomproduct kan uitbrengen: met een paar endpoints wordt je checkout een connectiviteitswinkel. Deze gids behandelt de volledige integratie vanuit het perspectief van een developer: provisioning, aflevering, webhooks en de randgevallen die je wilt afvangen.

De basisflow

Elke integratie voor een eSIM reseller komt neer op drie stappen:

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

Provisioning

Zodra de betaling gelukt is, doet je backend één call:

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"
  }'

De response komt direct terug, met alles wat je nodig hebt:

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

De LPA-code staat in de response zelf, dus je hoeft niet te pollen en niet te wachten op een e-mail of async job. Met zo’n 120 ms van begin tot eind kun je de call synchroon binnen de checkout doen. Bij lokale eSIMs komt het telefoonnummer in dezelfde response mee. Je kunt de klant dus zijn nieuwe lokale nummer laten zien nog voordat hij de QR-code heeft gescand.

Aflevering

Zet de LPA-string om in een QR-code (elke QR-library werkt, want de string is de payload) en:

  • Toon hem op de bevestigingspagina
  • Stuur hem ook per e-mail als vangnet (klanten installeren vaak later, op wifi)
  • Bied op mobiel ook de installatie via een universal link aan, zodat wie op hetzelfde toestel koopt geen tweede scherm nodig heeft om te scannen

Lifecycle-webhooks

Registreer een webhook-endpoint en je ontvangt events zoals:

{ "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 }

Gebruik het event balance.low om een e-mail te sturen waarmee de klant met één klik kan opwaarderen. Die komt binnen op het moment dat de klant het meest geneigd is te kopen. Resellers die dit automatiseren, zien doorgaans 20 tot 30% extra omzet per klant.

Ontwerpkeuzes die je goed wilt maken

Idempotentie. Geef je order-ID mee als reference en probeer veilig opnieuw bij netwerkfouten. Zo maak je (en betaal je) nooit twee eSIMs voor één order.

Maak de eSIM aan bij de betaling. eSIMs worden gefactureerd zodra ze aangemaakt zijn. Maak ze dus niet vooraf aan voor verlaten winkelmandjes.

Sla de ICCID op. Dat is de vaste identifier die je gebruikt voor support, opwaarderingen en verbruiksopvragingen.

Beantwoord de vraag “kan mijn telefoon dit?” vroeg. Controleer in je UI vóór de checkout of het toestel eSIM ondersteunt, in plaats van achteraf in een terugbetalingsmail.

Producttypen die je kunt aanmaken

Met één integratie heb je de hele catalogus:

  • Pay As You Go: afgerekend per MB, opwaarderen via de API, 190+ landen
  • Lokale eSIMs: echt lokaal telefoonnummer + bellen + sms + (onbeperkt) data in 25+ landen
  • EU-databundels: tot 500 GB voor routers, campers en wagenparken in de hele EU
  • 5G-back-up: failover-connectiviteit voor vaste locaties

Ze gebruiken allemaal dezelfde API-structuur. Alleen de product-identifier verandert, dus je aanbod later uitbreiden is een configuratiewijziging en geen nieuw project. Wil je eerst de zakelijke kant bekijken? Begin dan bij eSIM reseller worden.

Live gaan

  1. Maak je account aan op resellers.esim.tech
  2. Integreer provisioning en QR-weergave tegen de sandbox
  3. Koppel het webhook-endpoint (minimaal activatie en laag tegoed)
  4. Test de volledige installatie op een echte iPhone en een echt Android-toestel
  5. Schakel over op live keys en ga live

Authenticatie gaat met een standaard Bearer-token, de API is gewone REST/JSON en er zijn geen minimale volumes. Je eerste aangemaakte eSIM kan dus naar een echte klant.

Veelgestelde vragen

Wat is een LPA-code?

De LPA-code (Local Profile Assistant) is de activatiestring waarmee een toestel met eSIM-ondersteuning zijn simprofiel downloadt. Meestal krijg je hem te zien als QR-code. Formaat: LPA:1$smdp.example.com$ACTIVATION-CODE. Geeft je API hem direct terug, dan kun je de QR-code meteen in je checkout tonen.

Hoe snel is eSIM-provisioning via een API?

Bij eSIM.tech geeft een POST /v1/esims-call de LPA-code en ICCID in ongeveer 120 milliseconden terug, van begin tot eind. Dat is snel genoeg om synchroon tijdens de checkout aan te maken.

Heb ik speciale telecomkennis nodig om een eSIM API te integreren?

Nee. Kun je een betaal-API integreren, dan kun je ook een eSIM API integreren. De telecomcomplexiteit (SM-DP+-servers, operatorafspraken, profielgeneratie) zit verborgen achter de REST-interface.

Hoe installeren klanten de eSIM?

Ze scannen de QR-code die je toont (of tikken op een universal link op hetzelfde toestel). iOS en Android downloaden en installeren dan het profiel. Een duidelijke installatiegids per platform scheelt flink wat supporttickets.