Wat is een LPA-code? Activatiecodes voor eSIMs uitgelegd
Als je eSIMs verkoopt, is de LPA-code het product dat je klant echt ontvangt. Al het andere (de netwerkafspraken, de databundel, het telefoonnummer) komt binnen via één korte tekststring. In dit artikel lees je wat er in die string staat en hoe je hem aan klanten geeft zonder dat er supporttickets van komen.
Wat is een LPA-code?
LPA staat voor Local Profile Assistant: het deel van het besturingssysteem van een telefoon dat eSIM-profielen downloadt en installeert. Een LPA-code (ook wel eSIM-activatiecode genoemd) is de instructie die je aan de LPA geeft: ga naar deze server en download dit profiel.
Klanten zien de ruwe code zelden. Ze zien een QR-code, en dat is dezelfde string als afbeelding. Of je de QR-code scant of de string met de hand intypt, het resultaat is hetzelfde.
Wat staat er in een LPA-code?
Een activatiecode volgt een formaat dat de GSMA, de brancheorganisatie van de mobiele sector, heeft vastgelegd. Zo ziet hij eruit:
LPA:1$smdp.example.com$K9MX-4F2A-77QB-0C3D
De code bestaat uit drie delen, gescheiden door $:
| Deel | Voorbeeld | Betekenis |
|---|---|---|
| Prefix en formaat | LPA:1 |
Vertelt het toestel dat dit een eSIM-activatiecode is |
| SM-DP+-adres | smdp.example.com |
De server waarop het eSIM-profiel staat |
| Matching ID | K9MX-4F2A-… |
Bepaalt welk profiel gedownload wordt |
Sommige codes hebben een optioneel vierde deel, waarmee de klant vóór het downloaden een bevestigingscode moet invoeren. De meeste consumenten-eSIMs slaan dat over.
Hoe de installatie werkt
- De klant scant de QR-code, of opent de installatielink op hetzelfde toestel.
- De LPA van de telefoon leest het SM-DP+-adres en neemt contact op met die server.
- De server controleert de matching ID en stuurt het versleutelde eSIM-profiel.
- De telefoon installeert het profiel. Vanaf dat moment gedraagt hij zich als een simkaart van die operator.
Het hele proces duurt een paar seconden en vraagt om een internetverbinding, meestal wifi, omdat de nieuwe eSIM van de klant nog niet actief is.
Waarom een LPA-code meestal maar één keer werkt
Een activatiecode verwijst naar één eSIM-profiel. Is dat profiel eenmaal op een toestel gedownload, dan is de code normaal gesproken verbruikt. Houd daar rekening mee:
- Verwijdert een klant de eSIM van zijn telefoon, dan installeert dezelfde QR-code hem meestal niet opnieuw. Er is dan een nieuw profiel nodig.
- Screenshots worden gedeeld, dus behandel de code als een tegoedbon: wie hem als eerste installeert, krijgt het profiel.
- Een eSIM naar een nieuwe telefoon overzetten betekent meestal een nieuw profiel uitgeven in plaats van de oude code opnieuw te gebruiken.
Vertel klanten dit vooraf, het liefst op het scherm waar ze de QR-code zien. Zo voorkom je het meest voorkomende supportticket over eSIMs.
Hoe resellers LPA-codes het best aanleveren
De meeste installatieproblemen ontstaan door de manier waarop de code wordt aangeleverd, niet door de code zelf. Een paar werkwijzen die goed werken:
- Toon de QR-code direct na de betaling. Als je platform de code meteen teruggeeft, hoeven klanten niet op een e-mail te wachten.
- Stuur hem ook per e-mail, want veel reizigers kopen vóór de reis en installeren later op de hotelwifi.
- Bied handmatige invoer aan. Laat het SM-DP+-adres en de activatiecode ook als tekst zien, voor klanten die geen QR-code kunnen scannen met de telefoon waarop ze installeren.
- Zet er korte installatiestappen per platform bij. De menu’s van iPhone en Android verschillen, en één screenshot per platform scheelt veel heen-en-weer.
- Controleer vóór de checkout of het toestel geschikt is, niet erna. Een LPA-code installeert niet op een telefoon die geen eSIM ondersteunt of aan een andere provider vastzit.
LPA-codes bij eSIM.tech
Bij eSIM.tech geeft één provisioning-call de LPA-activatiecode terug in dezelfde API-response, in ongeveer 120 ms. In de response staan ook de ICCID, een QR-code als base64-PNG en, bij lokale eSIMs en eSIMs voor de VS, het telefoonnummer. Je hoeft niet te pollen of op een e-mail te wachten: je toont de QR-code op je bevestigingspagina binnen hetzelfde request waarin de betaling binnenkwam.
De volledige integratie, van provisioning tot webhooks voor verbruik en een laag tegoed, staat in onze gids voor eSIM API-integratie.
Veelgestelde vragen
Waar staat LPA voor?
LPA staat voor Local Profile Assistant: de software op een telefoon of tablet die eSIM-profielen downloadt en installeert. De 'LPA-code' is de activatiecode die je aan die software geeft, meestal als QR-code.
Is een LPA-code hetzelfde als een eSIM-QR-code?
In de praktijk wel. De QR-code is gewoon de LPA-activatiestring als afbeelding. Of je de QR-code scant of de string met de hand intypt, het resultaat is hetzelfde.
Kun je een LPA-code meer dan één keer gebruiken?
Meestal niet. Een activatiecode hoort normaal bij één eSIM-profiel, en zodra dat profiel op een toestel is gedownload, is de code verbruikt. Verwijdert een klant de eSIM, dan heeft hij meestal een nieuwe nodig.
Hoe kom ik als reseller aan LPA-codes?
Bij eSIM.tech geeft elke provisioning-call de LPA-activatiecode terug in dezelfde API-response, samen met de ICCID en, bij lokale eSIMs, het telefoonnummer. De QR-code zit erbij als base64-PNG, zodat je hem meteen in je checkout kunt tonen.
