Por que não dá só para salvar uma imagem de QR na Apple Wallet
Se você já tentou tirar print de um QR code e arrastar para a Apple Wallet, já sabe que não funciona. A Apple Wallet não guarda imagens soltas — ela guarda passes. Um pass é um arquivo assinado (um .pkpass) que agrupa seu código de barras ou QR code junto com título, cores da marca e campos extras. Segundo a documentação de desenvolvedores da Apple, um pass precisa ser assinado criptograficamente por um emissor com um Apple Pass Type ID antes de a Wallet aceitá-lo. Essa assinatura é o ponto central: é como o iPhone sabe que o pass é legítimo.
Ou seja, "adicionar um QR code à Apple Wallet" na prática significa gerar um pass que contém seu QR code. Existem duas formas honestas de fazer isso: tocar num botão "Adicionar à Apple Wallet" que um serviço já oferece, ou criar o pass você mesmo com uma ferramenta que consiga assiná-lo.
Carteiras digitais deixaram de ser nicho. A Juniper Research estimou cerca de 4,4 bilhões de usuários de carteira digital em 2025 — cerca de 55% da população mundial — e crescendo[^1]. Estar presente onde as pessoas já guardam cartões de embarque e fidelidade é o motivo pelo qual vale o esforço extra de um QR code pronto para wallet.
Como adicionar um QR code à Apple Wallet com o CodeQR
- Gere seu QR code. Use o gerador desta página, ou abra o gerador de QR code completo, e crie um QR code do tipo URL apontando para o seu destino. Escolha um link dinâmico se puder mudar o destino depois.
- Salve no seu workspace. Crie uma conta gratuita e salve o QR code no seu painel. Um wallet pass empacota um QR salvo, então o código precisa estar na sua conta primeiro.
- Escolha Adicionar à Apple Wallet. Num plano Pro ou superior, abra o QR salvo e selecione o botão oficial Adicionar à Apple Wallet. O CodeQR monta o
.pkpassassinado para você — sem precisar gerenciar certificados. - Confirme no seu iPhone. Pré-visualize o pass, toque em Adicionar, e seu QR está na Apple Wallet, pronto para quando você precisar.
Você pode ler como o recurso funciona na página de wallet passes, e a página de planos mostra quais incluem esse recurso.
Um exemplo concreto
Uma academia de bairro imprime um QR code de "Escaneie para fazer check-in" na recepção, mas os alunos ficavam perdendo o cartão de papel. O dono criou um QR de URL dinâmico no CodeQR, salvou e adicionou à Apple Wallet como pass com a marca da academia. Agora os alunos abrem a Wallet, mostram o pass, e o leitor da recepção lê o mesmo código de sempre. Como o link é dinâmico, quando a academia depois mudou o fluxo de check-in para uma nova URL, o pass continuou funcionando — ninguém precisou reemitir nada.
Boas práticas
- Use um link dinâmico. Um pass que não pode ser atualizado é um pass que precisa ser reemitido. Um QR dinâmico mantém a versão impressa e a versão na wallet sempre apontando para onde você precisa.
- Mantenha o destino compatível com celular. As pessoas abrem wallet passes no telefone, então garanta que a página carregue rápido no mobile.
- Ofereça suporte à Google Wallet também. Usuários Android vivem na Google Wallet, que trata passes de QR de um jeito um pouco diferente — veja nosso guia de Google Wallet.
- Teste antes de lançar. Adicione o pass ao seu próprio iPhone e escaneie uma vez para confirmar que o código resolve corretamente.
Quer testar? Gere um QR code agora, depois crie sua conta para salvar e adicionar à Apple Wallet.
[^1]: Digital Wallet Users to Surpass Three-Quarters of Global Population by 2030 — https://www.juniperresearch.com/press/digital-wallet-users-to-surpass-three-quarters-of-global-population-by-2030/, Juniper Research, verificado em 2026-07-07