A maioria das pessoas entende essa parte ao contrário. Você não manda uma atualização. Você edita o passe, e os celulares vêm até você.
Muda um saldo de pontos, um nível, uma data de validade, um código de barras. Você muda uma vez, do seu lado. Todo cartão que já está na Apple Wallet ou no Google Wallet de um cliente se redesenha sozinho com a informação nova. Ninguém reinstala nada, ninguém baixa o cartão de novo, e na maioria dos casos ninguém nem recebe um aviso. Esse é o truque todo, e vale entender o mecanismo antes de construir qualquer coisa em cima dele — inclusive um push confirmando um pagamento via PIX que acabou de creditar pontos.
O mecanismo de push silencioso por trás de cada atualização
Um wallet pass não é uma imagem estática. É um pacote de dados pequeno com o endereço de um servidor de origem embutido nele, então ele sempre sabe onde checar a própria versão mais recente.
Quando você edita um passe, a sequência é essa. Sua plataforma de passes manda um push silencioso para os servidores da Apple ou do Google. Silencioso é isso mesmo: sem banner, sem som, sem notificação visível ao cliente. O push só acorda a carteira no aparelho e avisa uma coisa, que um passe guardado ali mudou.
O celular então busca no servidor de origem do passe, baixa o arquivo atualizado e troca. O cliente abre a carteira depois e o cartão está simplesmente… correto. Ele nunca viu a conversa que deixou tudo certo.
Apple e Google diferem no encanamento, mas o formato é o mesmo. A Apple usa o PassKit web service e o APNs para o push silencioso; o Google usa sua Wallet API e atualiza o objeto do lado do servidor, que depois propaga para o aparelho. De qualquer forma, você mexe em um registro e a atualização se espalha para todo celular com aquele passe.
O que dispara uma atualização no celular do cliente
Nem toda mudança precisa vir de você apertando um botão. Algumas atualizações disparam por dado, outras por contexto. As mais comuns:
Mudança de pontos ou nível
Um cliente ganha pontos, cruza um limite, sobe de Prata para Ouro. Sua regra de fidelidade atualiza o registro dele, o passe reflete o novo saldo ou nível, e o push silencioso leva isso até o celular. Não precisa de e-mail dizendo “parabéns, você é Ouro agora”, embora você ainda possa mandar um se quiser marcar o momento.
Relevância por localização
Essa nem é uma edição de dado. Um passe pode carregar coordenadas de localização, e quando o celular percebe que o cliente está perto de uma delas, ele mesmo mostra o passe na tela de bloqueio. O cliente passa perto da loja, o cartão de café aparece. Você define a localização uma vez, ao emitir o passe; o celular cuida do resto sem nenhum push da sua parte.
Expiração e efeito acinzentado
Um cupom acaba. A data de um ingresso passa. Você envia uma atualização que marca o passe como expirado, e a carteira deixa ele acinzentado, visivelmente encerrado em vez de silenciosamente quebrado. É um detalhe pequeno que evita um chamado de suporte, porque o cliente vê que a oferta venceu em vez de ficar se perguntando por que o código de barras não é lido.
O que acontece se o cliente estiver offline
Hora da parte honesta, porque é aqui que prometer demais gera problema.
Se o celular do cliente estiver offline quando você envia uma atualização, ela não chega naquele momento. Não existe mágica aqui. O push silencioso não acorda um aparelho inalcançável.
O que salva é que o passe sabe onde mora seu servidor de origem. Na próxima vez que o celular ficar online e a carteira checar, ou na próxima vez que o cliente abrir o passe, o aparelho busca a versão atual e se atualiza. Então a atualização não se perde, só fica adiada até o celular poder recebê-la.
A regra prática: atualizações de wallet pass são confiáveis, mas não são uma garantia instantânea contra um celular no modo avião. Planeje para “eventualmente correto”, não para “sempre instantâneo”. Para qualquer coisa urgente, como um desconto relâmpago que expira em uma hora, combine o passe com um canal que confirme a entrega em vez de depender só da atualização silenciosa.
Por que isso importa para o time de marketing, não só para desenvolvedores
Tire o encanamento técnico e sobra isso: o cartão no bolso do seu cliente é uma superfície viva que você controla, não um impresso que envelhece assim que sai do forno.
Pense no que isso elimina. Nenhuma campanha para reemitir cartões depois de uma mudança de preço. Nenhum e-mail de “apague o cupom antigo e baixe o novo” que metade da sua lista ignora. Nenhuma leva de notificação toda vez que um saldo sobe, que é exatamente o tipo de ruído que ensina o cliente a te silenciar. Você edita a origem, os bolsos se atualizam, e você não gastou nada da paciência do seu cliente para isso.
Essa é a diferença entre um wallet pass e um material estático. Um é um canal. O outro é um PDF.
Avisar cada portador de cartão na mão sobre uma mudança de preço ou pontos não escala. A Pushwoosh envia a atualização de forma silenciosa, sem app e sem fadiga de notificação. Veja como funciona com Wallet Passes.
