Adicionar cartões a Apple Wallet: Guia de negócios
Tudo o que você precisa saber sobre a emissão de cartões para Apple Wallet como empresa. Noções básicas de PassKit, métodos de distribuição e o caminho mais rápido da decisão à produção.
Adicionar placas ao Apple Wallet requer a estrutura PassKit da Apple (técnica) ou uma plataforma como 7Konto (chave na mão). Este guia cobre ambas as abordagens para que você possa tomar uma decisão informada. TL;DR: para a maioria das empresas, usar uma plataforma é 10 a 100 vezes mais rápido do que construir do zero.
O que você precisa
- Para PassKit personalizado: conta de desenvolvedor Apple, equipe de engenharia, capacidade de manutenção contínua
- Para abordagem de plataforma: ativos da marca, informações comerciais, disposição para configurar
- iPhones reais para teste (simuladores são inadequados)
Processo passo a passo
Entenda o que é Apple Wallet
Apple Wallet é o aplicativo da Apple para armazenar cartões digitais: cartões de embarque, ingressos, cartões de fidelidade, cartões-presente, cartões de associação, cartões de pagamento e muito mais.
- Disponível em todos os iPhone (pré-instalado desde iOS 6)
- Os usuários podem adicionar passes de e-mails, sites, aplicativos, códigos QR ou toques NFC
- Os passes podem ser atualizados em tempo real (alterações de saldo, atribuições de portões, atualizações de assentos)
- Os cartões podem enviar notificações push
- Os passes podem ser acionados geograficamente (aparecem na tela de bloqueio perto do local relevante)
- Google Wallet é equivalente no Android — a maioria das plataformas suporta ambos
Escolha sua abordagem
Dois caminhos para adicionar cartões ao Apple Wallet: construir personalizado com PassKit ou usar uma plataforma como 7konto.
- Abordagem PassKit: técnica, flexível, requer de 4 a 12 semanas de desenvolvimento, conta de desenvolvedor Apple, manutenção contínua
- Abordagem de plataforma (7Konto ou similar): baseada em configuração, mais rápida, não requer código, inclui manutenção contínua da plataforma
- Para a maioria das empresas, a abordagem de plataforma é significativamente mais rápida e tem custo total mais baixo
Dica profissional
Mesmo as grandes empresas estão migrando para plataformas, a menos que tenham necessidades de personalização muito específicas. O tempo de colocação no mercado geralmente vence.
Configure sua conta de desenvolvedor Apple (abordagem PassKit)
Se escolher a abordagem PassKit, você precisará de uma conta de desenvolvedor Apple. Os usuários da plataforma ignoram isso: a plataforma gerencia as credenciais da Apple para você.
- Inscreva-se em developer.apple.com (US$ 99/ano)
- Crie um ID de tipo de passe em sua conta de desenvolvedor Apple
- Gerar certificados para assinatura de passes
- Configurar webhooks para atualizações de passes
- Estabeleça sua infraestrutura para geração de passes
Dica profissional
Relevante apenas se você estiver criando algo personalizado. As plataformas cuidam de tudo isso para você.
Crie seu cartão
As passagens Apple Wallet têm restrições de design específicas. Projete seu cartão para funcionar dentro deles.
- A Apple oferece 6 tipos de passes: boardingPass, cupom, eventTicket, genérico, storeCard, thirdPartyReceipt
- Para cartões-presente e fidelidade: use o tipo storeCard
- Para cupons: use o tipo de cupom
- Para tickets: use o tipo eventTicket
- Incluir: logotipo, cores da marca, campos de informações primárias e secundárias, imagem, código de barras/QR
- Teste no iPhone real — os designs são renderizados de forma diferente no simulador
Dica profissional
Menos é mais. Os passes da carteira ficam pequenos na tela de bloqueio. Projetos desordenados tornam-se ilegíveis.
Escolha seu método de distribuição
Como os clientes receberão o passe?
- Código QR (eles digitalizam para adicionar) — mais comum, funciona em qualquer câmera
- Link de URL (eles tocam para adicionar) — bom para distribuição por e-mail/SMS
- Anexo de e-mail (arquivo .pkpass) — download direto
- NFC (eles conectam o telefone a um leitor físico) — para distribuição física de alto volume
- Baseado em aplicativo (eles tocam em "Adicionar a Apple Wallet" no seu aplicativo)
Dica profissional
Os códigos QR são a escolha universal. Imprima-os em recibos, exiba-os nos terminais POS, incorpore-os em e-mails, coloque-os em cartões de visita. Funciona em qualquer lugar.
Configurar atualizações de passes (se aplicável)
Para passes dinâmicos (saldos, ingressos, assinaturas) — configure atualizações em tempo real.
- Abordagem personalizada: implementar integração de APNs (Apple Push Notification Service)
- Configurar a infraestrutura de webhook para enviar atualizações
- Tratar tokens de autenticação e passar lógica de atualização
- Abordagem de plataforma: automática — você apenas atualiza os dados, a plataforma trata das atualizações de passes
Dica profissional
Atualizações em tempo real são o que torna os passes da Wallet poderosos. Um vale-presente que sempre mostra o saldo atual é uma experiência muito melhor do que um código QR estático.
Teste em dispositivos reais
Teste o fluxo completo em iPhones reais antes de lançá-lo aos clientes.
- Teste a adição de QR, URL e e-mail
- Teste em diversas versões do iOS (atualmente compatível: iOS 14+)
- Teste em modelos de iPhone nos últimos anos
- Testar notificações push e passar atualizações
- Casos extremos de teste: sem Internet, bateria fraca, iPhone mais antigo
Iniciar e iterar
Coloque em operação, avalie a adoção, repita o design e o fluxo.
- Rastrear: taxa de instalação de passes, passes ativos, taxa de engajamento
- Teste A/B em diferentes designs de cartão para descobrir o que repercute
- Otimize o "momento de adição" — quão fácil é para um cliente adicionar o cartão?
- Iterar com base em dados reais de uso
Problemas e soluções comuns
Problemas reais que observamos quando as empresas passam por esse processo e como resolvê-los.
A implementação do PassKit está demorando mais que o esperado
Comum. O PassKit personalizado leva de 4 a 12 semanas para a maioria das equipes. Se o cronograma for crítico, mude para uma abordagem de plataforma para uma implantação de uma a duas semanas.
Os cartões não são atualizados na Wallet
As notificações push da Apple precisam de configuração adequada. Verifique certificados, assinatura de webhook e endpoints de APNs. As plataformas lidam com isso automaticamente.
Os cartões parecem diferentes no simulador e no dispositivo real
Sempre teste em dispositivos reais. Os simuladores são aproximados, mas não correspondem exatamente. Pequenas diferenças na renderização, nas notificações e no comportamento são comuns.
Ignore o guia — nós faremos isso por você
O piloto gratuito de 30 dias inclui implementação completa por nossa equipe. Você obtém o resultado sem fazer o trabalho.