Criar um passe da Apple Wallet na mão significa escrever um arquivo pass.json, pedir um Pass Type ID e um certificado para a Apple, adicionar o certificado WWDR, assinar o pacote como .pkpass e ainda subir um servidor só para enviar atualizações depois. Para a maioria dos times de marketing e produto no Brasil, isso não é um fluxo de trabalho — é uma parede.
Existe um caminho mais rápido. Um construtor de passes sem código cuida da assinatura e das atualizações por você, então você desenha o cartão no painel e compartilha um link de instalação. Este guia mostra o que você precisa antes de começar, os dois jeitos de montar um passe, o que “grátis” realmente significa aqui, e o passo a passo para publicar o primeiro. Vamos usar o construtor de passes da Pushwoosh como exemplo prático.
Que tipo de passe você está construindo?
Antes do passo a passo, defina o tipo de passe, porque ele determina os campos e o código de barras. O Apple Wallet suporta cinco estilos, e quatro deles cobrem quase todo caso de uso de negócio:
Fidelidade ou cartão de loja: um saldo de pontos ou um cartão de carimbo digital. Uma padaria que registra visitas até um café grátis, ou uma loja mostrando o saldo de pontos atual do cliente.
Cupom: um desconto ou promoção escaneável. Um passe de “15% na próxima compra” que troca para uma nova oferta depois de resgatado.
Ingresso de evento: entrada para show, congresso ou jogo, com o assento ou a sessão na frente do passe.
Cartão de embarque: check-in de viagem com portão e detalhes do voo que atualizam em tempo real.
Associação: acesso a academia, clube ou assinatura, escaneável na entrada.
Escolha o que combina com seu caso de uso; o construtor tem um modelo pronto para cada um.
O que você precisa antes de criar um passe personalizado da Apple Wallet
Para criar um passe personalizado da Apple Wallet, você precisa de três coisas, não importa qual método escolher.
Primeiro, uma conta de desenvolvedor Apple. A Apple exige que todo passe seja assinado com um certificado de Pass Type ID vinculado à sua conta de desenvolvedor, e não existe atalho para isso mesmo usando uma ferramenta sem código. A conta custa 99 dólares por ano, algo em torno de R$ 500 dependendo da cotação do dia. Segundo, seus materiais de marca: logo, ícone, cores e os campos que você quer no cartão. Terceiro, um valor de código de barras ou QR, caso o passe seja escaneado no balcão.
Com um construtor, você adiciona o certificado de Pass Type ID uma única vez, para que a plataforma assine os passes em seu nome. Depois disso, a parte técnica está resolvida e você trabalha só visualmente.
Dois jeitos de fazer um passe da Apple Wallet: pass.json manual vs. construtor
A escolha depende de você ter tempo de desenvolvimento disponível e de quanto controle de baixo nível você precisa.
Opção 1: montar o pass.json e assinar você mesmo
Você escreve um pass.json descrevendo o estilo do passe, os campos, as cores e o código de barras, empacota tudo com suas imagens e assina o pacote com seus certificados de Pass Type ID e WWDR para gerar um .pkpass. Para enviar atualizações depois que o passe é instalado, você também mantém no ar um servidor web que registra os aparelhos e conversa com o serviço de push da Apple. Esse caminho dá controle máximo e serve para times com integração de backend específica ou volume muito grande, mas exige programação e manutenção contínua.
Opção 2: usar um construtor de passes sem código
Um construtor gera e assina o .pkpass para você. Você escolhe um estilo, define marca e campos, adiciona um código de barras, confere a prévia e clica em gerar. As atualizações saem do mesmo painel por número de série, então não existe servidor web para construir. Esse é o caminho prático para times de marketing e produto, e o resto deste guia segue por ele.
Criar um passe da Apple Wallet de graça: o que é realmente grátis
Algumas ferramentas anunciam criação de passe de graça, então vale detalhar de onde vem o custo.
O construtor de passes em si costuma estar incluído no plano da plataforma, e gerar um passe não tem taxa por unidade. O que não é grátis é a conta de desenvolvedor Apple, 99 dólares por ano (cerca de R$ 500, variando com o câmbio), que a Apple exige para assinar qualquer passe. Então “criar passe da Apple Wallet de graça” é verdade para o design e a geração — o certificado da Apple é um custo fixo que não dá para pular. Planeje o orçamento para a conta, não para o construtor.
Passo a passo: montando seu primeiro passe
Estes passos levam você do certificado até um link de instalação pronto para compartilhar.
-
Conecte sua conta de desenvolvedor Apple
No portal Apple Developer, registre um Pass Type ID em Certificates, Identifiers & Profiles, depois crie o certificado de Pass Type ID correspondente. Adicione esse certificado na configuração do seu aplicativo em Pushwoosh Wallet Passes para que a plataforma assine os passes por você. Isso você faz uma única vez.
-
Desenhe o cartão e defina os campos
No Painel de Controle, vá em Campanhas → Apple Wallet e clique em Criar passe. Comece do zero ou carregue um modelo (cartão de embarque, cupom, ingresso de evento, genérico ou cartão de loja). Escolha um estilo de passe e defina cores, logo e imagens. Uma prévia ao vivo atualiza conforme você edita. Algumas regras de design mantêm o passe usável. Coloque a única coisa que o cliente realmente quer ver no campo principal, grande e legível: «500 pontos» ou «20% OFF». Use campos secundários para detalhes de apoio, como data de validade ou número de sócio. Reserve o verso do passe para termos, contato e um link para seu site ou a loja mais próxima. Mantenha a marca consistente com seu app para que o passe seja reconhecido na hora, mesmo numa carteira cheia.
-
Adicione um código de barras ou QR
Adicione o código de barras que o passe vai mostrar para ser escaneado. O Wallet suporta QR, Aztec e PDF417. Defina o valor que seu ponto de venda ou sistema de check-in vai ler, e opcionalmente o texto exibido abaixo, caso o leitor falhe.
-
Configure a relevância por localização (opcional)
Você pode fazer o passe aparecer na tela de bloqueio quando o cliente estiver perto de um lugar escolhido por você: sua loja, um evento, um aeroporto. Adicione até 10 locais, defina o texto da tela de bloqueio para cada um («Você está perto da nossa loja, mostre este passe para ganhar pontos») e uma distância máxima em metros. Isso transforma um passe salvo em um empurrão no momento certo, sem precisar disparar nenhum push.
-
Publique e compartilhe o link de instalação
Clique em Validar passe para pegar imagens ou campos faltando de acordo com as regras da Apple, depois em Gerar. O construtor processa suas imagens e assina o .pkpass em poucos segundos. Compartilhe como link de instalação ou QR code no cupom fiscal, na sinalização da loja, no site ou por e-mail, e o cliente toca para adicionar ao Apple Wallet.
Mantenha o passe atualizado depois do lançamento
Um passe não é um arquivo de uma vez só. Pontos mudam, ofertas expiram, detalhes de evento mudam de lugar, e cada uma dessas mudanças é uma atualização num cartão vivo, guardado na carteira de alguém.
Fazer isso na mão significa manter aquele servidor web no ar e gerenciar o cadastro de aparelhos a cada mudança. Com o construtor de passes da Pushwoosh você atualiza o passe por número de série direto do painel, e a mudança chega em todo aparelho que adicionou o cartão. Você pula o pass.json e o servidor de atualização por completo.
Crie e atualize passes da Apple Wallet com a Pushwoosh
Pule o pass.json e o servidor de assinatura. O Pushwoosh Wallet Passes deixa você desenhar um passe, gerar um .pkpass assinado, compartilhar um link de instalação e enviar atualizações por número de série a partir de um único painel.
