Código de activación eSIM (LPA)
El QR en el correo de activación de eSIM de un operador es un código de activación LPA (Local Profile Assistant) según GSMA SGP.22. El teléfono lo escanea, contacta con el servidor SM-DP+ (Subscription Manager, Data Preparation Plus), descarga el perfil eSIM cifrado y lo instala, todo sin que el cliente escriba nada.
Canonical spec:GSMA SGP.22, Remote SIM Provisioning Architecture for Consumer Devices v3.0 (current, 2024). The activation-code format is defined in §4.1.1.
Native support: iOS 17.4+ (2024) and Android 13+ (2022) scan these directly from the camera app to provision eSIM profiles.
Native support: iOS 17.4+ (2024) and Android 13+ (2022) scan these directly from the camera app to provision eSIM profiles.
Qué es
El payload del código de activación es una cadena de formato fijo con 3 o 4 partes separadas por $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, el identificador del esquema URI LPA + versión del código de activación. Literal obligatorio.
- Dirección SM-DP+, el FQDN del servidor de aprovisionamiento del operador (ej.
rsp.example.com). Sin prefijohttps://, solo el nombre de host. - Matching ID, un ID único (normalmente 16–32 caracteres alfanuméricos) que vincula el código de activación a un perfil eSIM específico en el servidor SM-DP+.
- Código de confirmación (opcional), un secreto adicional que el usuario debe escribir para autorizar la descarga. Usado por algunos operadores como segundo factor en el flujo de activación.
Vectores de prueba canónicos
Son ejemplos de forma únicamente, un código de activación LPA real se vincula a un perfil específico en un SM-DP+ específico. Los vectores de prueba codifican el formato, no un flujo de escaneo para instalar.
| Caso | Entradas | Cadena codificada esperada |
|---|---|---|
| Mínimo (sin código de confirmación) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Con código de confirmación | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operador con subdominio | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Flujo MSISDN portado | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Errores comunes
- Prefijo https:// en el campo SM-DP+. SGP.22 §4.1.1 quiere el FQDN sin formato. Los teléfonos que ven
https://rsp.example.comen ese campo tratan el código de activación como malformado y se niegan a descargar. - Caracteres $ en el Matching ID. El Matching ID es alfanumérico. Un
$dentro de él colisiona con el separador de campo. Los operadores que auto-generan Matching IDs deben excluir$del alfabeto. - Expectativa de uso único. La mayoría de los servidores SM-DP+ invalidan el Matching ID después de la primera descarga de perfil exitosa. Compartir el QR de nuevo después de que el cliente lo ha escaneado fallará, y el cliente pensará que le diste un QR roto.
- Re-descarga del perfil. Si el cliente restablece de fábrica o cambia de teléfono, no puede volver a escanear el QR antiguo. Debe contactar al operador, quien emite un nuevo Matching ID y un nuevo QR. Construye tu flujo de soporte al cliente en torno a eso.
- Aprovisionamiento de SIM dual. iOS 17.4+ puede albergar 8 perfiles eSIM pero solo usar dos de forma concurrente. Al escanear, el SO pregunta al usuario qué ranura SIM física reemplazar. Los operadores empresariales a menudo escanean en un ranura secundaria por defecto.
- Teléfonos gestionados por MDM. Apple Business Manager y Android Enterprise pueden aprovisionar eSIMs de forma programática sin el paso QR. Si tu flota está gestionada por MDM, usa la API en lugar de entregar QRs a los usuarios.
Compatibilidad de escáneres
| Dispositivo / OS | Soporte | Notas |
|---|---|---|
| iOS 17.4+ | Nativo | La app Cámara reconoce payloads LPA y ofrece instalar el perfil eSIM inline. |
| iOS 16.x–17.3 | Nativo vía Ajustes > Red Móvil | Escanea desde Ajustes > Red Móvil > Añadir eSIM en lugar de desde la Cámara. El soporte de escaneo desde la cámara llegó en 17.4. |
| Android 13+ | Nativo | Ajustes > Red e internet > SIMs > Añadir eSIM > Escanear QR. |
| Android 9–12 | Específico del fabricante | Samsung Galaxy, Google Pixel y algunos dispositivos OnePlus tienen soporte de escaneo desde la cámara. Otros fabricantes requieren entrada manual vía Ajustes. |
| Apps de cámara de terceros | No de forma nativa | Decodifican el QR pero no activan la instalación eSIM. Los usuarios deben copiar la cadena en Ajustes manualmente. |
| Teléfonos más antiguos / sin eSIM | N/A | Sin hardware eSIM físico; el payload se decodifica pero no ocurre nada. |
Ver también
- /esim-qr-code/, el generador con el formato LPA prerellenado.
- /standards/, volver al índice de estándares.
- GSMA SGP.22, la especificación de referencia.