QR Code para Apple Wallet e Google Wallet: Como Funciona

A maioria dos artigos sobre QR codes para Apple Wallet descreve a relação ao contrário. Dizem para "gerar um QR code e adicioná-lo à Carteira" — mas não é assim que nenhuma das duas plataformas funciona. No Apple Wallet e no Google Wallet, o QR code fica dentro do passe, não o contrário: o passe é o documento, o QR code é o código de barras escaneável que ele contém, e não é possível adicionar uma imagem QR bruta ao Wallet sem antes envolvê-la em um arquivo de passe estruturado.

O que são realmente os passes do Apple Wallet e Google Wallet

Um passe do Apple Wallet é um arquivo .pkpass — um arquivo ZIP assinado contendo uma definição JSON dos campos do passe, imagens (logotipo, fundo, miniatura) e um descritor de código de barras. O código de barras pode ser um QR code, Aztec, PDF417 ou Code 128. O passe é assinado criptograficamente com um certificado Pass Type ID emitido para sua conta de desenvolvedor Apple, que é como o iOS verifica que o passe não foi adulterado.

Os passes do Google Wallet (chamados de Wallet Objects) seguem uma estrutura semelhante, mas vivem na nuvem do Google. Você define uma Classe de Passe (o template), cria Objetos de Passe (um por cliente) e os emite por meio de um JWT assinado que o cliente toca para salvar. Ambas as plataformas suportam notificações baseadas em localização, datas de expiração e atualizações em tempo real enviadas do seu backend.

O QR code em ambos os sistemas é o código de barras de resgate — a parte que um funcionário ou scanner automatizado lê no ponto de uso. Ele codifica uma string: um ID de ingresso, número de membro de fidelidade, código de cupom ou qualquer identificador que seu sistema de validação reconheça.

Como o QR code funciona dentro de um passe de wallet

Quando um cliente apresenta seu passe em uma cafeteria, portão de evento ou balcão de embarque, o scanner lê o QR code exibido na tela. O scanner envia essa string para seu backend. Seu backend verifica: esse ID de ingresso é válido e não foi usado? Esse número de membro está ativo? Esse cupom ainda pode ser resgatado? A exibição do passe é o frontend; seu banco de dados é a autoridade.

Isso significa que o QR code dentro de um passe não precisa ser um QR code dinâmico — ele não redireciona para uma URL. Ele codifica um identificador fixo. O comportamento "dinâmico" (atualizar o design do passe, enviar notificações push, invalidar ingressos usados) é gerenciado pela API do PassKit ou Google Wallet enviando atualizações para o passe no dispositivo, não alterando o QR code.

Cinco casos de uso onde QR codes em passes de wallet entregam valor real

1. Cartões de fidelidade

Uma cafeteria emite um cartão digital de selos de fidelidade. O cliente o adiciona ao Apple Wallet ou Google Wallet via QR code no cupom fiscal ou link "Salvar no Wallet" em um e-mail de confirmação. O passe exibe a contagem atual de selos. Em cada visita, o barista escaneia o QR code na tela; o backend incrementa a contagem e envia uma atualização para o passe. Sem download de aplicativo. Sem cartão de papel para perder.

2. Ingressos para eventos

Um organizador de eventos gera um passe por ingresso. Cada passe contém um QR code único codificando o ID do ingresso. Na entrada, os scanners verificam o ID na base de dados de ingressos e o marcam como usado — evitando entrada duplicada. O passe pode incluir detalhes do evento (local, horário, número do assento) e atualizar automaticamente se o evento for remarcado.

3. Cupons e ofertas promocionais

Um varejista emite um cupom de 20% de desconto como oferta do Google Wallet. O passe mostra o valor do desconto e a data de expiração. No checkout, o cliente aproxima o celular e o caixa escaneia o QR code. O backend valida que o cupom não foi usado e aplica o desconto. O passe pode ser atualizado — por exemplo, estendendo a expiração — com um push para todos os passes daquela classe.

4. Cartões de membros

Uma academia, museu ou clube emite um passe de membro digital. O QR code codifica o ID do membro. A equipe o escaneia na entrada. O passe exibe o nível de membros (básico, premium), data de expiração e foto do membro. Comparado com cartões plásticos, os passes de membro digitais eliminam custos de reimpressão quando o nível de um membro muda — o passe se atualiza no dispositivo do cliente.

5. Cartões de embarque e passes de transporte

Companhias aéreas e autoridades de transporte foram os primeiros grandes adotantes. Um cartão de embarque armazenado no Apple Wallet ou Google Wallet exibe o QR code (ou código Aztec — as companhias aéreas geralmente preferem Aztec pela maior tolerância a danos) que os scanners das portões leem. O mesmo modelo se aplica a passes de ônibus e trem.

Como criar um QR code para passe de wallet: o caminho prático

Não existe um único botão que diga "gerar QR code para Apple Wallet". O processo tem três componentes: construir o passe, assiná-lo e distribuí-lo.

Opção A: Usar uma plataforma de criação de passes (sem código)

Plataformas como WalletThat, Passtastic e Walletwallet gerenciam criação, assinatura e hospedagem de passes. O processo:

1. Escolha um tipo de passe (fidelidade, ingresso, cupom, genérico).
2. Envie seu logotipo e configure os campos do passe (nome do membro, valor do desconto, data do evento).
3. Insira o valor do código de barras — a string que será codificada no QR code. Pode ser gerada automaticamente por passe ou importada de um CSV para emissão em massa.
4. A plataforma gera um arquivo .pkpass assinado e um link "Adicionar ao Apple Wallet" / "Salvar no Google Wallet".
5. Distribua o link por e-mail, SMS ou um QR code impresso em embalagens ou cupons fiscais.

O passo 5 é onde um QR code comum — gerado com uma ferramenta como o gerador gratuito do QR Nova — se torna útil: você gera um QR code que aponta para a URL de download do passe, imprime em materiais físicos e os clientes o escaneiam para adicionar o passe ao Wallet. O QR code impresso e o QR code do passe são duas coisas diferentes com duas funções diferentes.

Opção B: Usar a API do PassKit ou Google Wallet diretamente

Para desenvolvedores integrando passes de wallet em um backend existente, o framework PassKit da Apple e a API do Google Wallet oferecem controle programático completo. A Apple exige uma assinatura no Apple Developer Program (US$ 99/ano) para obter um certificado Pass Type ID. O Google exige uma conta de comerciante na API do Wallet (gratuita para criar, sujeita a aprovação).

O que o iOS 27 muda (setembro de 2026)

A Apple confirmou que o iOS 27 incluirá um recurso nativo "Criar Passe" no aplicativo Wallet. Os usuários poderão escanear qualquer QR code e criar um passe Wallet personalizado a partir de três templates (Padrão, Membros, Evento). Esse recurso é voltado para usuários individuais e casos de uso informais, não para emissão de passes profissionais em escala com validação de backend.

Quando usar um QR code dinâmico junto com passes de wallet

Um QR code dinâmico tem um papel no fluxo de trabalho de passes de wallet: distribuir o passe. Se você está imprimindo o link "Adicionar ao Wallet" em embalagens, cartazes ou cupons fiscais, codificar essa URL como QR code dinâmico significa que você pode atualizar a URL da versão do passe sem reimprimir. Se um novo design de passe substituir o antigo, você atualiza o destino do redirecionamento e os materiais impressos existentes apontam automaticamente para o novo passe.

Para esse QR code de distribuição, usar um QR code permanente do QR Nova garante que o redirecionamento continue ativo independentemente de você estar em um plano pago — o código impresso na sua embalagem hoje ainda funcionará daqui a três anos, mesmo que sua plataforma de passes mude.

Como o QR Nova se encaixa no fluxo de trabalho de passes de wallet

O QR Nova não gera arquivos .pkpass nem Google Wallet Objects — essa é uma função das plataformas de passes. O que o QR Nova fornece é a camada de distribuição: o QR code que você imprime em materiais físicos e que os clientes escaneiam para chegar ao link "Adicionar ao Wallet".

Esse QR code de distribuição é onde a maioria das empresas cria uma fragilidade não intencional. Se o QR code de distribuição for gerado em uma plataforma que desativa códigos quando as assinaturas vencem, a embalagem — com uma tiragem finita e vida física longa — fica inerte no momento em que a cobrança falha. Com o gerador gratuito do QR Nova, o código estático que você cria nunca expira e não tem limite de escaneamentos.

Erros comuns das empresas com QR codes de passes de wallet

Confundir o QR code de distribuição com o QR code do passe. São dois códigos diferentes com dois propósitos distintos. O código de distribuição é impresso em materiais físicos e aponta para o download do passe. O QR code do passe fica dentro do aplicativo Wallet e é escaneado no ponto de uso.

Usar um QR code de conta de avaliação para o link de distribuição. Se o QR code impresso em 10.000 unidades de embalagem aponta por um serviço de redirecionamento pago de uma plataforma, e essa assinatura vencer, cada unidade em circulação vira um beco sem saída. Use um código que não dependa de uma relação de cobrança recorrente.

Gerar um único QR code para toda a base de clientes em vez de objetos de passe por cliente. Para que a validação funcione corretamente, especialmente para ingressos de eventos e cupons de uso único, cada cliente precisa de um objeto de passe único com um valor de código de barras único. Um único QR code compartilhado não pode ser validado de forma confiável nem marcado como usado.