Cartões no telemóvel

As medidas do passe do Apple Wallet, numa tabela

A Apple não publica uma tabela única com tudo, e as medidas mudam consoante o tipo de passe. Estas são as de um cartão de fidelização (storeCard), que é o que usa um bar ou um café.

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

A Apple espalha estas medidas por várias páginas e muda-as consoante o tipo de passe, por isso quase tudo o que se encontra por aí mistura as de um bilhete de concerto com as de um cartão de carimbos. Esta tabela é a de um cartão de fidelização (storeCard), e vem com as letras pequenas que quase ninguém conta: no strip circulam duas medidas e ambas se podem defender.

A tabela de medidas

Imagem	Ficheiro	Em pontos	2x (px)	3x (px)	Obrigatória?
Ícone	`icon.png`	38 × 38	76 × 76	114 × 114	Sim
Logótipo	`logo.png`	50–160 largura × 50 altura	até 320 × 100	até 480 × 150	Não, mas convém
Strip	`strip.png`	375 × 144	750 × 288	1125 × 432	Não

As medidas do logótipo são um máximo, não uma tela: a imagem ajusta-se dentro dessa caixa mantendo a proporção. Um logótipo quadrado vai acabar por ocupar 50 × 50 dos 160 disponíveis de largura, e isso está bem — o que não podes é esticá-lo.

E um cartão de fidelização não leva as outras três imagens que vais ver mencionadas por aí: thumbnail.png é de bilhetes e passes genéricos, background.png de bilhetes e footer.png de cartões de embarque. Se as encontrares num tutorial, esse tutorial não está a falar do teu caso.

Atenção ao strip: vais encontrar duas medidas, e ambas são «da Apple». A documentação arquivada do PassKit dividia o strip em três alturas —98 pt para bilhetes, 144 pt para cartões-presente e cupões e 123 pt «nos restantes casos»— e é daí que vem o 375 × 123 que circula por meia internet. As diretrizes de design atuais indicam o strip em 375 × 144 para cupão e cartão de fidelização. Como um storeCard é precisamente o cartão-presente/de fidelização, 144 é a que lhe cabe — e é a que recomendamos.

O que fazer com isto na prática: desenha a 1125 × 432 e deixa o conteúdo importante na faixa central. Se o sistema cortar, corta em cima e em baixo, que é onde não tens nada. Ao contrário —desenhar na baixa e que ta estiquem— nota-se sempre.

Nota de transparência: este sistema gera hoje os seus strips a 1125 × 369 (a altura baixa), e num iPhone a sério veem-se sem faixas, sem esticar e sem cortes. Por isso, se vens procurar qual das duas «funciona»: as duas. A diferença prática é outra — com a altura alta os carimbos ficam 17 % maiores e preenchem melhor o espaço. É uma melhoria, não uma reparação.

Como tirar a dúvida no teu caso, em dois minutos. Abre um passe teu e olha só para a faixa dos carimbos. Se os círculos aparecerem ovais, estão a esticá-la. Se os das pontas aparecerem comidos dos lados, estão a cortá-la. E se vires uma faixa em cima e em baixo, sobra-te altura. Atenção a este último caso: se o fundo do teu strip for da mesma cor que o do passe, a faixa existe mas não se vê — e só a denuncia o facto de os carimbos parecerem pequenos para o espaço que têm.

O strip, que é o que importa a sério

O strip é a faixa larga que atravessa o passe por baixo do cabeçalho. Num cartão de fidelização é toda a cara do produto: é onde se desenham os espaços dos carimbos, as ofertas e a foto da tua loja. Se só vais cuidar de uma imagem, cuida desta.

A proporção anda pelos 2,6 : 1 (uma faixa muito alongada). Duas consequências práticas:

Uma foto vertical não serve. Vai ser cortada em cima e em baixo. Escolhe fotos horizontais, e com o motivo ao centro.
Não ponhas texto pequeno dentro do strip. Com 144 pontos de altura, qualquer frase se lê mal. O texto vai nos campos do passe, que são texto a sério e se adaptam ao idioma do telemóvel.

O strip muda consoante o que acontece

O strip não tem de ser uma imagem fixa. Num cartão de carimbos o normal é haver uma imagem para cada estado: 0 carimbos, 1 carimbo, 2 carimbos… Com um cartão de 10 são onze imagens. É aí que está o trabalho a sério de montar isto à mão, e é exatamente o que um sistema como este faz sozinho: gerar as onze, para cada nível, para cada estabelecimento.

Logótipo e ícone não são a mesma coisa (e o ícone vê-se mais)

É o erro mais comum: carregar a mesma imagem nos dois sítios.

	Ícone	Logótipo
Onde se vê	Nas notificações e na lista de passes	Em cima à esquerda do passe
Forma	Quadrado, cortado com cantos arredondados	Alongado, ajusta-se à caixa
O que pôr	O símbolo da tua marca, sem texto	O teu logótipo completo
Se te enganares	Um logótipo alongado dentro de um quadrado fica ilegível na notificação	Um símbolo quadrado vê-se pequeníssimo em cima

E se vens de um tutorial antigo: o ícone cresceu. Durante anos o mínimo foi 29 pt (29/58/87 px) e assim continua em meia internet. Desde o iOS 15 as notificações mostram o ícone maior e a Apple subiu o mínimo para 38 pt. Com o tamanho antigo o ícone fica desfocado precisamente onde mais se olha: no aviso que chega ao teu cliente. Nós tínhamo-lo em 29 e subimo-lo quando o descobrimos ao escrever este guia.

O ícone é obrigatório. Sem icon.png, o passe não é adicionado ao Wallet. E como é o que aparece nas notificações, é a imagem do teu negócio que o teu cliente vai ver mais vezes.

Formato, e os erros que estragam o passe

PNG. Todas as escalas, sempre PNG. As diretrizes atuais da Apple pedem 2x e 3x; a de 1x já não faz falta para ecrãs modernos.
Cuidado com o WebP disfarçado. Muitos programas exportam um ficheiro chamado .png que por dentro é WebP. O Wallet não o abre e o passe falha sem dizer porquê. Se um passe «não é adicionado» e não encontras o motivo, começa por aqui.
Transparência no ícone e no logótipo: sim, e convém, porque o fundo do passe defines tu com uma cor. No strip, não: o que ficar transparente vai ver-se da cor de fundo e costuma ficar estranho.
Peso. Não há um número mágico, mas o .pkpass inteiro viaja para o telemóvel sempre que é atualizado. Um strip de 2 MB vezes onze estados é um passe lento.

Os campos de texto

O texto do passe não vai dentro das imagens: são campos, e por isso são lidos por um leitor de ecrã, podem ser alterados a partir do servidor e aparecem no idioma do telemóvel.

Linha	Quantos cabem	Para que serve
Cabeçalho	1	O dado que se vê com o passe fechado. Num cartão de carimbos: «7/10».
Principal	1	O mais importante. Num storeCard costuma ficar por trás do strip.
Secundários e auxiliares	4 entre os dois	Nome do sócio, nível, próximo prémio. Não são 4 de cada: são 4 no total, numa só linha.
Verso	Muitos	Condições, morada, telefone, cancelar a adesão. Aí só olha quem procura.

Regra prática: três dados na frente e nem um a mais. Quem é, quanto já tem e o que ganha. Tudo o resto, no verso.

E cuidado com os textos longos: se não couberem, o Wallet não dá erro nenhum — simplesmente não os mostra. Um campo que no teu teste se vê inteiro pode desaparecer no telemóvel de um cliente com o texto em alemão.

Os campos traduzem-se; as imagens, não. Se escreveres «PRÓXIMO PRÉMIO» dentro do strip, um cliente alemão vai vê-lo em português para sempre. Se o puseres como etiqueta de campo, vê-o no idioma dele.

Cores e contraste

O passe tem três cores: fundo, texto e etiquetas. Declaram-se como tripleto rgb(23, 187, 82), ao estilo CSS — o hexadecimal não está documentado, por isso, se a tua ferramenta te deixa pôr #17bb52, estás fora do que a Apple descreve. Mais dois avisos que poupam dissabores:

O contraste importa mais do que parece. Amarelo sobre branco fica lindo no teu ecrã e não se lê ao sol, que é precisamente onde o teu cliente tira o telemóvel numa esplanada.
A cor do fundo e a do strip têm de conviver. Se o strip leva uma foto escura e o fundo do passe é preto, o passe parece um buraco. Pinta-os com a mesma família de cores.

Um pormenor que quase ninguém aproveita: a cor pode mudar consoante o nível do cliente. O mesmo cartão em azul para quem está a começar e em preto para quem já cá anda há um ano é o sinal de estatuto mais barato que existe — anda com ele no bolso e vê-o todos os dias.

Perguntas frequentes

Que tamanho tem o strip de um passe do Apple Wallet?

Vais encontrar duas respostas: 375 × 123 pt e 375 × 144 pt. A documentação arquivada da Apple indicava 375 × 144 para cartões-presente e cupões e 375 × 123 para os restantes; as diretrizes atuais indicam 375 × 144 para cupão e cartão de fidelização. Em píxeis: 750 × 288 a 2x e 1125 × 432 a 3x para a medida alta, e 750 × 246 / 1125 × 369 para a baixa. Se desenhares na alta e sobrar, é cortado em cima e em baixo, que é a falha menos visível.

É preciso carregar as três escalas do strip?

As diretrizes atuais da Apple pedem só 2x e 3x. O mais prático é desenhar uma única imagem à escala 3x e gerar a de 2x reduzindo-a; a de 1x já não faz falta para ecrãs modernos.

Que formato devem ter as imagens do passe?

PNG. O ícone é obrigatório: sem icon.png o passe não é adicionado. E atenção aos ficheiros que se chamam .png mas por dentro são WebP: é preciso recodificá-los para PNG a sério, senão o passe falha.

Quantos campos de texto cabem num passe de fidelização?

Num storeCard: 1 campo de cabeçalho, 1 principal e até 4 entre secundários e auxiliares na frente. No verso cabem mais, mas aí só olha quem os vai procurar.

Se além disso vais dar suporte a Android —e vais ter de dar—, continua em o cartão de fidelização no Google Wallet, onde as medidas e a forma de montar o cartão são diferentes.