Código de ativação eSIM (LPA)
O QR no e-mail de ativação de eSIM de uma operadora é um código de ativação LPA (Local Profile Assistant) conforme GSMA SGP.22. O telefone o escaneia, contata o servidor SM-DP+ (Subscription Manager, Data Preparation Plus), baixa o perfil eSIM criptografado e o instala, tudo sem que o cliente precise digitar 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.
O que é
O payload do código de ativação é uma string de formato fixo com 3 ou 4 partes separadas por $:
LPA:1$<SM-DP+ address>$<Matching ID>[$<Confirmation Code>]- LPA:1, o identificador do esquema URI LPA + versão do código de ativação. Literal obrigatório.
- Endereço SM-DP+, o FQDN do servidor de provisionamento da operadora (ex.
rsp.example.com). Sem prefixohttps://, apenas o hostname. - Matching ID, um ID único (normalmente 16–32 caracteres alfanuméricos) que vincula o código de ativação a um perfil eSIM específico no servidor SM-DP+.
- Código de confirmação (opcional), um segredo adicional que o usuário deve digitar para autorizar o download. Usado por algumas operadoras como segundo fator no fluxo de ativação.
Vetores de teste canônicos
Estes são exemplos de forma apenas, um código de ativação LPA real está vinculado a um perfil específico em um SM-DP+ específico. Os vetores de teste codificam o formato, não um fluxo de scan para instalar.
| Caso | Entradas | String codificado esperado |
|---|---|---|
| Mínimo (sem código de confirmação) | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T |
| Com código de confirmação | smdp=rsp.example.com | LPA:1$rsp.example.com$K2-LM3N4P5Q-R6S7T$1234 |
| Operadora com subdomínio | smdp=esim.carrier.com | LPA:1$esim.carrier.com$ABCDEFGH12345678 |
| Fluxo MSISDN portado | smdp=rsp.smdpplus.example | LPA:1$rsp.smdpplus.example$PORT-MSISDN-0123456789$99 |
Armadilhas comuns
- Prefixo https:// no campo SM-DP+. SGP.22 §4.1.1 quer o FQDN nu. Telefones que veem
https://rsp.example.comnesse campo tratam o código de ativação como malformado e se recusam a baixar. - Caracteres $ no Matching ID. O Matching ID é alfanumérico. Um
$dentro dele colide com o separador de campo. Operadoras que auto-geram Matching IDs devem excluir$do alfabeto. - Expectativa de uso único. A maioria dos servidores SM-DP+ invalida o Matching ID após o primeiro download de perfil bem-sucedido. Compartilhar novamente o QR depois que o cliente o escaneou falhará, e o cliente pensará que você deu a ele um QR quebrado.
- Re-download do perfil. Se o cliente fizer reset de fábrica ou trocar de telefone, ele não poderá escanear novamente o QR antigo. Ele precisa contatar a operadora, que emite um novo Matching ID e um novo QR. Construa seu fluxo de suporte ao cliente em torno disso.
- Provisionamento de SIM duplo. iOS 17.4+ pode armazenar 8 perfis eSIM mas usar apenas dois simultaneamente. Ao escanear, o SO pergunta ao usuário qual slot SIM físico substituir. Operadoras empresariais geralmente escaneiam em um slot secundário por padrão.
- Telefones gerenciados por MDM. Apple Business Manager e Android Enterprise podem provisionar eSIMs programaticamente sem a etapa QR. Se sua frota for gerenciada por MDM, use a API em vez de entregar QRs aos usuários.
Compatibilidade de scanners
| Dispositivo / SO | Suporte | Notas |
|---|---|---|
| iOS 17.4+ | Nativo | App Câmera reconhece payloads LPA e oferece instalar o perfil eSIM inline. |
| iOS 16.x–17.3 | Nativo via Ajustes > Celular | Escaneie em Ajustes > Celular > Adicionar eSIM em vez de pela Câmera. Suporte a scan pela câmera chegou no 17.4. |
| Android 13+ | Nativo | Configurações > Rede e internet > SIMs > Adicionar eSIM > Escanear QR. |
| Android 9–12 | Específico do fabricante | Samsung Galaxy, Google Pixel e alguns dispositivos OnePlus têm suporte a scan pela câmera. Outros fabricantes requerem entrada manual via Configurações. |
| Apps de câmera de terceiros | Não nativamente | Decodificam o QR mas não ativam a instalação eSIM. Usuários devem copiar a string em Configurações manualmente. |
| Telefones mais antigos / sem eSIM | N/A | Sem hardware eSIM físico; o payload é decodificado mas nada acontece. |
Veja também
- /esim-qr-code/, o gerador com o formato LPA pré-preenchido.
- /standards/, voltar ao índice de padrões.
- GSMA SGP.22, a especificação de referência.