Médio ⏱ Leitura: 15 minutos. Implementação: 1 a 4 semanas Para: proprietários de empresas, gestores de produto, engenheiros de integração

Adicionar cartões a Apple Wallet: Guia de negócios

Tudo o que precisa de saber sobre a emissão de cartões para a 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.

A adição de placas ao Apple Wallet requer a estrutura PassKit da Apple (técnica) ou uma plataforma como a 7Konto (chave na mão). Este guia cobre ambas as abordagens para que possa tomar uma decisão informada. TL;DR: para a maioria das empresas, utilizar uma plataforma é 10 a 100 vezes mais rápido do que construir de raiz.

O que precisa

  • Para PassKit personalizado: conta de programador Apple, equipa de engenharia, capacidade de manutenção contínua
  • Para abordagem de plataforma: ativos da marca, informação comercial, disponibilidade para configurar
  • iPhones reais para teste (os simuladores são inadequados)

Processo passo a passo

1

Perceba o que é o Apple Wallet

Apple Wallet é a aplicação da Apple para armazenar cartões digitais: cartões de embarque, bilhetes, cartões de fidelização, cartões-presente, cartões de membro, cartões de pagamento e muito mais.

  • Disponível em todos os iPhone (pré-instalado desde o iOS 6)
  • Os utilizadores podem adicionar passes de e-mails, sites, aplicações, 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 lugares)
  • Os cartões podem enviar notificações push
  • Os passes podem ser acionados geograficamente (aparecem no ecrã de bloqueio perto do local relevante)
  • Google Wallet é equivalente no Android — a maioria das plataformas suporta ambos
2

Escolha a sua abordagem

Dois caminhos para adicionar cartões ao Apple Wallet: construir personalizado com o PassKit ou utilizar uma plataforma como o 7konto.

  • Abordagem PassKit: técnica, flexível, requer 4 a 12 semanas de desenvolvimento, conta de programador Apple, manutenção contínua
  • Abordagem de plataforma (7Konto ou similar): baseada na 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 um custo total mais baixo

Dica profissional

Mesmo as grandes empresas estão a mudar para as plataformas, a menos que tenham necessidades de personalização muito específicas. O tempo de colocação no mercado geralmente vence.

3

Configure a sua conta de programador Apple (abordagem PassKit)

Se escolher a abordagem PassKit, necessitará de uma conta de programador Apple. Os utilizadores da plataforma ignoram isto: a plataforma gere as credenciais da Apple por si.

  • Subscrever developer.apple.com (99 dólares/ano)
  • Crie um ID de tipo de passe na sua conta de programador Apple
  • Gerar certificados para assinatura de passes
  • Configurar webhooks para atualizações de passes
  • Estabeleça a sua infraestrutura para a geração de passes

Dica profissional

Relevante apenas se estiver a criar algo personalizado. As plataformas tratam de tudo isso por si.

4

Crie o seu cartão

As passagens Apple Wallet têm restrições de design específicas. Desenhe o seu cartão para funcionar dentro deles.

  • A Apple disponibiliza 6 tipos de passes: boardingPass, cupão, eventTicket, genérico, storeCard, thirdPartyReceipt
  • Para cartões-presente e fidelização: utilize o tipo storeCard
  • Para cupões: utilize o tipo de cupão
  • Para tickets: utilizar o tipo eventTicket
  • Incluir: logótipo, cores da marca, campos de informação primária e secundária, 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 no ecrã de bloqueio. Projetos desordenados tornam-se ilegíveis.

5

Escolha o seu método de distribuição

Como é que os clientes vão receber o passe?

  • Código QR (digitalizam para adicionar) — mais comum, funciona em qualquer câmara
  • Link URL (tocam para adicionar) — bom para distribuição por e-mail/SMS
  • Anexo de e-mail (ficheiro . pkpass) — download direto
  • NFC (ligam o telefone a um leitor físico) — para distribuição física de grande volume
  • Baseado na aplicação (tocam em "Adicionar a Apple Wallet" na sua aplicação)

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.

6

Configurar atualizações de passes (se aplicável)

Para passes dinâmicos (saldos, bilhetes, assinaturas) — configure atualizações em tempo real.

  • Abordagem personalizada: implementar a 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 — apenas atualiza os dados, a plataforma trata das atualizações de passes

Dica profissional

As atualizações em tempo real são o que torna os passes Wallet poderosos. Um cartão presente que mostre sempre o saldo atual é uma experiência muito melhor do que um código QR estático.

7

Teste em dispositivos reais

Teste o fluxo completo em iPhones reais antes de o lançar aos clientes.

  • Teste a adição de QR, URL e e-mail
  • Teste em várias 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
8

Iniciar e iterar

Coloque em funcionamento, avalie a adoção, repita o design e o fluxo.

  • Rastrear: taxa de instalação de passes, passes ativos, taxa de envolvimento
  • Teste A/B em diferentes designs de cartões para descobrir o que tem repercussões
  • Otimizar o "momento de adição" — quão fácil é para um cliente adicionar o cartão?
  • Iterar com base em dados reais de utilização
Resolução de problemas

Problemas e soluções comuns

Problemas reais que observamos quando as empresas passam por este processo e como resolvê-los.

A implementação do PassKit está a demorar mais tempo do que o esperado

Comum. O PassKit personalizado demora 4 a 12 semanas para a maioria das equipas. Se o cronograma for crítico, mude para uma abordagem de plataforma para uma implementação de uma a duas semanas.

Os cartões não são atualizados na Wallet

As notificações push da Apple necessitam de uma configuração adequada. Verifique os certificados, a assinatura de webhook e os endpoints de APNs. As plataformas tratam disso automaticamente.

Os cartões têm um aspeto diferente no simulador e no dispositivo real

Teste sempre 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 fazemos isso por si

O piloto gratuito de 30 dias inclui a implementação completa pela nossa equipa. Obtém o resultado sem fazer o trabalho.