Guias
Cartões no telemóvel

Google Wallet para um cartão de fidelização

O Google Wallet monta o cartão de outra forma que a Apple e, se desenhares a pensar só no iPhone, no Android fica mal. Aqui vão as duas.

Atualizado a 10 de agosto de 2026 · mantemo-lo porque somos nós que o usamos.

A diferença de fundo em relação à Apple

Antes das medidas, convém perceber porque não dá para «exportar o mesmo» para os dois sistemas:

Apple WalletGoogle Wallet
O que é o cartãoUm ficheiro .pkpass assinado que se descarrega para o telemóvelUm objeto que vive nos servidores da Google; ao telemóvel chega um link
As imagensVão dentro do ficheiroSão ligadas por URL: têm de estar publicadas no teu servidor
Para o atualizarAvisas e o telemóvel descarrega o passe novoAtualizas o objeto na API da Google
Autorização préviaCertificado da Apple, pago anualmenteConta de emissor e revisão da Google
A consequência prática que apanha toda a gente. Na Google, as tuas imagens têm de estar acessíveis publicamente por URL. Se as guardares numa pasta privada, ou se o URL mudar a cada deploy, o cartão fica sem imagem no telemóvel do cliente — e tu nem dás por isso, porque no teu iPhone aparece perfeito.

As duas imagens

Um cartão de fidelização do Google Wallet mostra duas imagens:

ImagemMedidaOnde apareceO que pôr
Logótipo do programa
programLogo
660 × 660 px
mínimo, 1:1
Em cima, junto ao nome, na ficha e na lista. Recortado em círculo. O teu símbolo, centrado, sobre um quadrado com fundo a toda a área.
Imagem de cabeçalho
heroImage
1032 × 812 px
recomendada
Faixa na frente do cartão. Mostrada a 100 % da largura. Num cartão de carimbos, os espaços dos carimbos. Se não, uma foto da tua loja.

Ambas em PNG. E no logótipo há um pormenor que a Google põe mesmo por escrito e que estraga metade dos que são carregados: deixa uma margem de segurança de 15 % à volta. O que tocar nesse limite é comido pelo recorte circular.

O cabeçalho da Google NÃO tem a forma do strip da Apple. A Apple pede uma faixa muito alongada (cerca de 2,6:1). A Google recomenda 1032 × 812, que é quase quadrada. Ainda assim, a referência da API só diz que a imagem «é mostrada a 100 % da largura»: uma faixa alongada também cabe, e é o que fazemos aqui — a mesma imagem de carimbos que vai dentro do passe da Apple é ligada como heroImage na Google. Funciona; simplesmente não é a proporção que eles recomendam para um hero desenhado de propósito. Se vais cuidar das duas em separado, é esta que tens de refazer.

O logótipo é recortado em círculo (e é aí que o teu logótipo morre)

Este é o pormenor que estraga mais designs. Na Apple, o logótipo vai numa caixa alongada e o teu logótipo comprido cabe inteiro. Na Google, é recortado em redondo.

Se envias o mesmo ficheiro para os dois sítios, no Android o teu logótipo perde as pontas e fica só com as três letras do meio. A solução não é técnica, é de design:

  • Prepara uma versão quadrada do logótipo só para a Google.
  • Centra-a e deixa-lhe espaço à volta: o que tocar no limite do quadrado perde-se no recorte.
  • Se a tua marca é um texto comprido, usa o símbolo ou a inicial, não o logótipo completo.

Os campos que se veem

A Google organiza o cartão de outra maneira: não há «linhas» como na Apple, há campos com nome próprio.

CampoO que éO que convém pôr
issuerNameQuem emiteO nome do clube, não só o do negócio
programNameO título do passeO nome do cliente, se o tiveres
accountNameO titularNome e apelido do membro
loyaltyPointsO contador grande«7/10» num cartão de carimbos, o saldo se fores por pontos
textModulesDataBlocos de texto livresNível, próximo prémio, condições curtas
hexBackgroundColorA cor do cartãoUm hex #rrggbb. Se o deixares vazio, é tirada da cor dominante do teu cabeçalho (e, se não houver, do logótipo)
Se não puseres cor, a Google inventa uma — e acerta menos do que pensas. Na Apple defines o fundo e o texto em separado. Na Google dás hexBackgroundColor no formato #rrggbb, e se o deixares vazio o sistema vai buscar a cor dominante da tua imagem de cabeçalho; se também não houver cabeçalho, a cor dominante do teu logótipo. Uma foto com muito castanho deixa-te o cartão castanho. Põe-na tu.

O código de leitura

O cartão leva um código para a tua equipa o ler. O habitual, e o que funciona melhor num balcão, é um QR: lê-se com qualquer telemóvel, aguenta que o ecrã esteja sujo ou com pouco brilho, e não obriga a comprar um leitor.

Um pormenor pequeno com consequências: o texto que vai por baixo do código. Se deixares lá o identificador do membro, o cliente vê uma salganhada de letras por baixo do cartão. É preferível deixá-lo vazio ou pôr algo que signifique alguma coisa para ele.

As mensagens

Para avisar o cliente no Android, adiciona-se uma mensagem ao cartão dele. É uma forma diferente da da Apple, onde o aviso é a própria atualização do passe.

Isto tem duas consequências que tens de ter em mente:

  • O mesmo aviso vê-se de forma diferente em cada sistema. Testa sempre num iPhone e num Android antes de enviar o que quer que seja para toda a tua base.
  • As mensagens acumulam-se no cartão. Não são notificações que desaparecem: ficam lá. Enviar uma por semana transforma o cartão num quadro de avisos velhos.

Sobre o que escrever e quando, temos um guia inteiro: as notificações do passe.

A revisão da Google

Ao contrário da Apple — onde, com o certificado, já podes emitir — no Google Wallet as classes de passe passam por uma revisão antes de poderem ser emitidas em grande escala. Não é instantâneo e convém contar com isso nos prazos: se prometes a um cliente que o cartão dele fica pronto «amanhã», que seja amanhã no iPhone e daqui a uns dias no Android.

Os dois sistemas, ou nenhum. Em Portugal e Espanha, o Android é mais de metade dos telemóveis. Montar só a Apple porque «é mais fácil» significa deixar de fora metade dos teus clientes — e são precisamente os que não vão perceber porque é que ao amigo funciona e a eles não.

Perguntas frequentes

Posso ter o mesmo cartão de fidelização no iPhone e no Android?

Sim, mas não é o mesmo ficheiro. A Apple usa um pacote .pkpass que se descarrega; o Google Wallet usa um objeto que vive nos servidores da Google e para o qual se envia um link. É preciso montar os dois, e o design não passa tal e qual de um para o outro.

Que imagem aparece num cartão do Google Wallet?

Duas: o logótipo do programa (programLogo), no mínimo 660 × 660 px e quadrado, que aparece em cima recortado em círculo; e a imagem de cabeçalho (heroImage), que a Google recomenda a 1032 × 812 px e mostra a 100 % da largura do cartão. Ambas em PNG.

Porque é que o meu logótipo aparece cortado no Android?

Porque a Google lhe aplica uma máscara circular. Um logótipo comprido perde as pontas. Tens de carregar uma versão quadrada de pelo menos 660 × 660 px, centrada e com uma margem de segurança de 15 % à volta: o que tocar no limite é comido pelo recorte.

Como se avisa o cliente no Google Wallet?

Adiciona-se uma mensagem ao objeto do cartão. É diferente da Apple, onde o aviso é a própria atualização do passe. Por isso, o mesmo aviso pode aparecer de forma diferente em cada telemóvel e tens de o testar nos dois.

Se vens da Apple ou vais para lá, a tabela de medidas está em medidas do passe do Apple Wallet.

E se preferires não montar nada disto

Tudo o que está nesta página, a etlas faz sozinha: gera as imagens na medida certa, monta o passe para a Apple e para a Google e atualiza-o no telemóvel do teu cliente sempre que ganha um carimbo. Tu escolhes as cores e os prémios.