Passes para a carteira do telemóvel

Além do bilhete no e-mail de confirmação, o visitante pode guardar o bilhete na Apple Wallet ou no Google Wallet. Para muitas pessoas, é o único sítio onde ainda o encontram quando chegam à porta. Este artigo explica o que são essas carteiras, porque é que um passe funciona melhor do que um pdf, e o que tem de ser configurado uma única vez para que os botões funcionem.

O que é uma carteira do telemóvel?

Qualquer telemóvel moderno tem uma app de carteira integrada. Num iPhone chama-se Wallet (o ícone com os cartões coloridos), num dispositivo Android Google Wallet. É o mesmo sítio onde as pessoas guardam o cartão de embarque do avião, o cartão de cliente do supermercado, o passe do comboio e, por vezes, o cartão bancário.

Não é preciso instalar essa app: já lá está. Um "passe Wallet" é simplesmente mais um cartão que se junta aos outros. Neste caso: o bilhete para o seu evento, com o nome da sua organização.

O visitante só tem de tocar uma vez. Da sua parte, não há nada a fazer — os botões já estão no e-mail e na página de confirmação.

Porque é que um passe funciona melhor do que um pdf

Um pdf numa caixa de correio parece a mesma coisa, mas à porta a diferença é grande.

Um passe Wallet	Um pdf no e-mail
Aparece sozinho no ecrã de bloqueio pouco antes do seu evento	É preciso procurar o e-mail
Um toque e o ecrã fica automaticamente mais brilhante	O brilho tem de ser aumentado à mão, ou fica esquecido
Funciona sem internet, o passe está no telemóvel	Um pdf que ainda tem de ser descarregado numa tenda cheia não abre
Está entre os cartões de embarque e os cartões de cliente, sempre no mesmo sítio	Está algures numa caixa de correio com outros trezentos e-mails

A segunda linha é a que mais se nota à porta. A Apple e a Google aumentam o brilho do ecrã assim que o código QR é mostrado, e um ecrã brilhante é lido quase sempre à primeira.

O que precisa antes de começar

• Nada por encomenda: os botões aparecem sozinhos em cada bilhete válido.
• Uma única vez, de forma centralizada: uma conta na Apple e na Google, mais o certificado da Apple. Consulte "O que tem de ser configurado uma única vez" mais abaixo.
• Um visitante com smartphone. Quem não tiver, imprime simplesmente o bilhete; é lido igualmente bem.
• Para o cartaz e os botões por baixo: o plano Início ou superior. No plano gratuito, os seus passes de carteira continuam a funcionar como sempre funcionaram.

---

O que o visitante vê

No e-mail de confirmação e na página do bilhete há dois botões: Adicionar à Apple Wallet e Adicionar à Google Wallet. Um toque e o passe fica no telemóvel, com o nome da sua organização, o produto, o local e — quando existe — o horário.

Os mesmos botões aparecem na página de confirmação que o visitante vê depois de pagar:

E também estão no próprio e-mail, para que quem fechou a janela ainda lhes possa aceder mais tarde:

O que aparece no passe

Na frente	No verso
O produto, o local e o horário ou o dia de validade	A morada do local
O código QR	A referência da encomenda e o nome do emissor
	O seu texto no verso, e os dados que não colocou na frente, como o nome do visitante

O que aparece na frente é escolhido por si; consulte "O que aparece na frente" mais adiante.

Num iPhone, vira-se um passe tocando nos três pontos no canto superior direito. É útil saber isto quando um visitante pergunta ao telefone onde está a morada.

Atenção: um bilhete normal e um passe anual recebem, de propósito, um tipo de passe diferente. Um bilhete pertence a uma data e, depois desse dia, passa discretamente para trás na carteira. Um passe anual fica à frente durante toda a temporada, porque o visitante precisa dele de cada vez que vem. Consulte Passes anuais.

---

O bilhete como cartaz

Num iPhone recente, o bilhete já não é um pequeno cartão, mas sim um cartaz: a fotografia do seu evento ocupa quase todo o ecrã, os dados aparecem por cima e, por baixo, surge uma fila de botões.

Isto acontece sozinho. É um único bilhete que se adapta ao telemóvel do visitante — um iPhone mais recente mostra mais, um mais antigo mostra o cartão habitual. Não é preciso configurar nada à parte e não há nada que possa avariar.

A partir de que plano? O cartaz, o guia do local, as próximas datas e os botões no topo fazem parte do plano Início e superiores. No plano gratuito, os seus passes de carteira continuam a funcionar como sempre funcionaram: o mesmo QR, os mesmos campos, igualmente válidos à porta. Consulte O seu plano, as suas faturas e pausar.

Num iPhone com iOS 18 ou mais recente

É o que a maioria dos visitantes vê hoje:

• a fotografia do seu evento em quase todo o ecrã, com a data, a hora, a sala e o nome do visitante por cima;
• "abertura de portas às ...", quando indica quantos minutos antes do início deixa entrar o público;
• uma fila de botões por baixo do passe: Como chegar, Estacionamento, Acessibilidade, Transportes públicos, Encomendar comida e O que pode levar para dentro. Cada botão só aparece quando preencheu alguma coisa para ele;
• o passe aparece sozinho no ecrã de bloqueio quando o visitante se aproxima do seu local. Para isso, o local tem de ter os seus dois números no mapa — veja mais abaixo.

Num iPhone com iOS 26 ou mais recente

Se o visitante tiver um passe anual ou uma série — uma assinatura, um festival de três dias, um curso de oito noites — as próximas datas aparecem no próprio passe. Assim, deixa de ter de procurar quando é esperado da próxima vez.

Num iPhone com iOS 27 ou mais recente

No topo do passe surgem dois botões: Como chegar e Ver encomenda. Nunca passam de dois; esse limite é da Apple, não nosso.

Num iPhone mais antigo (iOS 17 e anteriores)

Mostra o bilhete habitual: a sua cor, o seu logótipo, os dados e o código QR. Nada se perde e nada avaria — o telemóvel simplesmente omite o que ainda não conhece.

Não é, portanto, preciso criar um segundo bilhete para dispositivos mais antigos, nem perguntar alguma vez ao visitante que iPhone tem.

Num dispositivo Android (Google Wallet)

A Google mostra os mesmos dados, onde tiver lugar para eles: a imagem no topo do passe, a sala, a data e a hora e, na parte de baixo do passe, os links do seu guia do local.

A Google não tem a fila de botões da Apple. Não se trata de uma definição errada: essa forma de apresentação simplesmente não existe lá. O que preencher segue na mesma — apenas aparece noutro sítio.

---

O que preenche, e onde

Tudo o que se segue é opcional. Preenche uma vez e passa a aparecer em todos os bilhetes que vender.

Produtos → um produto → secção Imagem e portas

Esta secção aparece fechada; clique para a abrir.

• Cartaz deste evento. Uma fotografia vertical funciona melhor: é o formato de um ecrã de telemóvel. Uma fotografia horizontal é recortada.
• Abertura de portas, em minutos antes do início. Se indicar 30 para um espetáculo às 20h00, o visitante lê "abertura de portas às 19h30".

A secção não aparece num passe anual nem num vale-oferta: não se referem a um único momento, por isso um cartaz e uma hora de abertura de portas não fazem sentido aí.

Locais → um local

Na secção O local:

• Foto do local. A fachada, a sala, o recinto. Entra em cena quando o próprio produto não tem cartaz.
• Entrada, tal como deve aparecer no passe: "Porta A", "Entrada lateral".
• Latitude e Longitude: os dois números que indicam o seu local no mapa do mundo. Não precisa de os procurar — o botão Procurar coordenadas obtém-nos a partir da morada. São eles que dão origem ao botão Como chegar e que fazem o passe aparecer sozinho no ecrã de bloqueio.

Na secção Guia do local (também fechada): Telefone, E-mail, Website, Acessibilidade, Estacionamento, Transportes públicos, Encomendar comida e O que se pode levar para dentro. Cada campo preenchido torna-se um botão por baixo do passe.

Definições → Organização → separador Passes de carteira

Aqui define o que se aplica a todos os seus eventos em conjunto:

• na secção Bilhetes-cartaz: Imagem para o bilhete-cartaz, usada quando nem o produto nem o local têm fotografia, e Abertura de portas como valor predefinido para quem não a quer indicar produto a produto;
• na secção Guia do local: os mesmos links para todos os seus locais em conjunto (Website, Acessibilidade, Estacionamento, Transportes públicos, Encomendar comida e O que se pode levar para dentro; o telefone e o e-mail são preenchidos por local). Um local que preencha o seu próprio link substitui o da organização.

Que fotografia prevalece

Há três sítios que podem fornecer uma imagem, e são usados por esta ordem:

1. o cartaz do produto;
2. caso contrário, a fotografia do local;
3. caso contrário, a imagem para o bilhete-cartaz em Passes de carteira e, se estiver vazia, a sua imagem de capa nesse mesmo separador.

Se não houver fotografia em lado nenhum, o visitante recebe o bilhete habitual em vez do cartaz. Não é um erro nem uma avaria: sem imagem não há cartaz possível, e um cartão bem arranjado é melhor do que um cartaz com um retângulo cinzento.

A mesma ordem aplica-se à hora de abertura de portas e aos links do guia do local: prevalece o mais específico.

Um campo vazio não gera botão

Se não preencher uma página de estacionamento, também não aparece o botão Estacionamento no passe. É intencional.

Um botão que não leva a lado nenhum é pior do que nenhum botão: o visitante toca nele enquanto está na fila, recebe uma página vazia e liga-lhe. Mais vale preencher bem três campos do que oito pela metade.

---

Comece por aqui

Se quiser gastar pouco tempo com isto, faça estas três coisas. São as que dão mais resultado:

1. Uma fotografia vertical por evento. Sem fotografia não há cartaz; com uma fotografia, o bilhete torna-se um cartaz no ecrã do visitante.
2. A sua morada com os dois números do mapa. Um clique no botão que os procura. Assim obtém o botão Como chegar e o passe que aparece sozinho no ecrã de bloqueio quando o visitante está por perto.
3. A hora de abertura de portas. Um número, e o visitante sabe a que horas pode chegar. Poupa a maior parte dos telefonemas na própria noite.

---

O que explicar a um visitante ao telefone

Esta conversa acontece mais vezes do que se pensa. Um guião que funciona:

1. "Tem um iPhone ou um telemóvel Android?" — assim sabe de qual dos dois botões precisa.
2. "Abra o e-mail de confirmação que lhe enviámos. Desça até ver o bilhete."
3. "Por baixo do bilhete há dois botões. Toque em Adicionar à Apple Wallet" (ou Google Wallet).
4. "Aparece uma pré-visualização do cartão. Toque em Adicionar, no canto superior direito."
5. "Está feito. A partir de agora encontra-o na app Wallet e, no próprio dia, aparece sozinho no ecrã de bloqueio."

Se não quiser, ou se não conseguir: não insista. O bilhete no e-mail funciona igualmente bem, e uma folha impressa é a que se lê mais depressa.

---

O código QR é o mesmo

No passe está exatamente o mesmo código que no bilhete normal. A app de leitura não precisa, portanto, de saber nada sobre carteiras: vê simplesmente mais um bilhete válido.

É também por isso que não se deve mexer nele: quem alterasse o código no passe tornaria inutilizável qualquer passe que já esteja num telemóvel.

Na prática, isto significa também que o visitante pode perfeitamente ter o passe e o bilhete em papel. É um único bilhete com um único código; quem o apresentar duas vezes recebe "duplicado" à segunda.

---

Um bilhete que já não é válido

Um bilhete cancelado ou reembolsado deixa de gerar passes, e um passe existente deixa de funcionar. Caso contrário, ficaria um QR com ar de válido no telemóvel de alguém que já recebeu o dinheiro de volta.

No passe anual há uma exceção deliberada. Um passe anual cancelado ou bloqueado deixa de gerar passes. Um que simplesmente expirou continua a gerar: fica no telemóvel como lembrete de que tem de ser renovado e, à entrada, a leitura recusa-o com "fora do período". É uma resposta mais clara do que um passe que desaparece de repente.

---

O que tem de ser configurado uma única vez

Os passes de carteira exigem uma conta na Apple e na Google. É um trabalho da plataforma — configurado de forma centralizada e não por organização. Enquanto não estiver configurado, tudo funciona exceto os dois botões Wallet, e quem clicar neles recebe uma mensagem clara em vez de meio passe.

No caso da Apple, isto inclui um certificado que expira todos os anos. Um certificado é uma espécie de selo digital com o qual a Apple consegue verificar que um passe vem mesmo do emissor. Se expirar, os passes existentes continuam a funcionar, mas deixam de ser criados passes novos.

Atenção: é exatamente o tipo de avaria que só se nota quando um visitante telefona. Se o botão deixou de funcionar quando ainda funcionava no mês passado, avise-nos de imediato em vez de esperar — é quase sempre isto.

---

Personalizar o seu passe

O passe de um visitante é muitas vezes a única coisa sua que ele tem no telemóvel, durante meses, entre o cartão bancário e o bilhete de comboio. Por isso, pode personalizá-lo. Faz-se em Definições → Organização → separador Passes de carteira.

Tudo nesse separador pode ficar vazio. Se não preencher nada, o passe segue a cor da sua identidade visual e o logótipo da loja do separador Identidade visual — e, na falta destes, as cores da plataforma. Não é preciso fazer nada para ter um passe cuidado.

Cores

Três cores, cada uma com a sua função:

Cor	Onde aparece
Fundo	toda a superfície do passe
Texto	os valores: a data, o nome, o produto
Etiquetas	as palavrinhas por cima de cada valor

Na pré-visualização, no fundo do separador, aparece um aviso quando uma combinação tem pouco contraste, acompanhado do valor. Esse valor vai de 1 (duas vezes a mesma cor) a 21 (preto sobre branco); abaixo de 4,5 o texto pequeno torna-se difícil de ler. Tenha em conta que um passe é lido numa fila, num telemóvel com o brilho baixo e o sol a bater no ecrã.

Atenção sobretudo às etiquetas: são pequenas, por isso precisam de mais contraste do que o próprio texto — exatamente o contrário do que a maioria das pessoas espera.

Não o impedimos. Um passe nas suas cores que achamos feio é uma escolha sua; um passe que ninguém consegue ler é algo de que preferimos avisar.

Logótipo e imagem de capa

Carrega um único logótipo; nós criamos a partir dele os seis ficheiros que a Apple e a Google pedem em separado. A Apple coloca-o no topo do passe e como ícone no ecrã de bloqueio; a Google recorta dele um logótipo redondo.

A que deve prestar atenção:

• png com fundo transparente. O logótipo fica diretamente sobre a cor de fundo. Um png com um retângulo branco à volta resulta num selo branco sobre um passe colorido — o clássico. A pré-visualização no fundo do separador avisa-o disso;
• pelo menos 480 píxeis de largura, senão fica desfocado num ecrã nítido;
• no máximo 2 MB. Ficheiros maiores são recusados.

A imagem de capa é opcional: uma fotografia larga por cima dos dados, com cerca de 3 por 1 e pelo menos 1125 píxeis de largura. Se a deixar vazia, obtém um passe numa só cor — muitas vezes mais sóbrio. Uma fotografia do seu edifício ou da sua sala resulta geralmente melhor do que uma fotografia com texto: o passe é recortado e o texto fica cortado a meio.

Um svg não serve. A Apple só aceita png, e nós criamo-los a partir do que carregar. Se só tiver o logótipo em svg, exporte-o uma vez como png.

Textos

Nome no passe é o nome tal como aparece no topo. A Apple mostra-o pequeno e corta-o; se o nome oficial for longo ("Real Círculo de História Local vzw"), coloque aqui a versão curta. O nome na fatura não muda.

Texto no verso são as informações práticas que o visitante passa a ter consigo: como entrar, onde estacionar, que um bilhete não é reembolsado. É preenchido por idioma. Se só tiver preenchido o neerlandês, um visitante francófono recebe esse texto em neerlandês — melhor do que um verso vazio.

O que aparece na frente

Para cada tipo de passe — bilhete, bilhete com horário, passe anual, vale-oferta — escolhe os dados que o visitante vê sem virar o passe: data e hora, nome do titular, tipo de bilhete, local.

Duas coisas a saber:

1. a ordem conta. O primeiro campo aparece em grande, os dois seguintes numa linha por baixo, o resto em pequeno. Mais de três na frente não cabem na largura de um ecrã;
2. o que não escolher não desaparece. Passa para o verso do passe. Uma escolha infeliz nunca faz perder uma morada.

Por predefinição, o produto aparece primeiro. Num bilhete com horário, a data e hora vêm logo a seguir, antes do local — é o que alguém numa fila procura.

Ver primeiro, guardar depois

No fundo do separador, em É assim que vai ficar, há uma pré-visualização em direto: a versão Apple e a versão Google, que se atualizam à medida que preenche. Com Mostrar como escolhe que tipo de passe está a ver. As duas plataformas tratam a mesma cor de forma realmente diferente, por isso veja ambas.

A pré-visualização é sempre uma aproximação — a Apple e a Google desenham o passe real com os seus próprios tipos de letra. Para o ter na mão, clique em Enviar um passe de teste para o meu e-mail. Recebe um e-mail no endereço com que tem sessão iniciada, com os mesmos dois botões que o visitante. Abra-os no telemóvel: o passe tem o seu design e dados fictícios. O código não dá acesso: à entrada é recusado.

O passe de teste usa o design tal como está guardado. Por isso, guarde primeiro e envie depois.

Passes anuais e vales-oferta

Um passe anual e um vale-oferta também podem ir para a carteira, com o mesmo design. Um vale-oferta mostra sempre o saldo no topo, seja qual for a sua escolha: é a única razão pela qual alguém abre um vale.

Um vale bloqueado deixa de gerar passe. Um vale vazio ou expirado continua a gerar — pode ficar no telemóvel, e na bilheteira "este vale está esgotado" é uma resposta mais clara do que um passe que desaparece de repente.

Dinheiro no bilhete

Se trabalhar com saldo do bar, esse saldo aparece no próprio passe. O visitante abre o bilhete e vê quanto ainda tem — sem app e sem iniciar sessão.

Atualiza-se sozinho: sempre que há um carregamento, um pagamento ou uma devolução, o passe no telemóvel atualiza-se. Não precisa de fazer nada.

Se não houver saldo, ou se a sua organização não trabalhar com saldo, a linha também não aparece. Um cartão que mostra "0,00 €" quando não há nada para comprar com ele confunde mais do que um cartão sem essa linha.

Consulte Saldo do bar para saber como carregar, cobrar e devolver.

Erros frequentes

• Oferecer o botão Wallet como única via. Nem toda a gente tem smartphone, e nem toda a gente quer usá-lo. O bilhete no e-mail e em papel continua igualmente válido.
• Pensar que um passe é algo diferente de um bilhete. É o mesmo código. Apresentá-lo duas vezes dá duas vezes o mesmo resultado.
• Reencaminhar um passe para outra pessoa. Tecnicamente é possível, mas continua a ser um único código: quem chegar à porta em segundo lugar não entra.
• Demorar a avisar quando o botão deixa de funcionar. Normalmente é o certificado da Apple que expirou, como acontece todos os anos, e isso resolvemos nós.
• Apagar o passe depois de uma alteração à encomenda. Não é necessário; um bilhete que deixou de ser válido é recusado à porta de qualquer forma.

---

E se …

E se o botão Wallet não fizer nada?

Há duas possibilidades. Ou o bilhete já não é válido — cancelado ou reembolsado — e nesse caso é normal que o botão não faça nada. Ou a configuração central não está em ordem, por exemplo porque o certificado da Apple expirou. Nesse caso, o visitante recebe uma mensagem e não uma página avariada. Avise-nos; entretanto, o bilhete no e-mail funciona normalmente.

E se o visitante tiver apagado o passe por engano?

Peça-lhe que volte a abrir o e-mail de confirmação e toque de novo no botão. Recebe o mesmo passe, e não um segundo. Se já não encontrar o e-mail, reenvie a confirmação a partir da encomenda.

E se não houver internet à porta?

O passe está no telemóvel e não precisa de ligação para ser mostrado. A sua app de leitura também continua a funcionar offline. Consulte App de leitura e equipa de controlo.

E se alguém tiver um dispositivo Android sem Google Wallet?

Acontece em dispositivos mais baratos e em dispositivos sem serviços Google. Nesse caso, use o bilhete normal do e-mail ou imprima-o. Nada se perde: o código é o mesmo.

E se o ecrã do visitante estiver demasiado escuro?

Um passe Wallet aumenta o brilho sozinho assim que o QR é mostrado. Se isso não acontecer, o que está aberto é provavelmente um pdf ou uma captura de ecrã e não o passe. Peça-lhe que abra a app Wallet.

---

Perguntas frequentes

O visitante tem de instalar alguma app? Não. A Wallet já existe em todos os iPhone e a Google Wallet em praticamente todos os dispositivos Android. Apenas se acrescenta um cartão.

Isto tem algum custo extra para o visitante ou para mim? Não. Faz parte do bilhete.

Posso alterar o passe mais tarde? O design sim, no separador Passes de carteira; os passes novos passam a usá-lo. O conteúdo acompanha o bilhete. Se algo mudar na encomenda, contacte-nos em vez de tentar resolver sozinho: o código no passe nunca pode mudar, senão deixam de funcionar todos os passes que já estão num telemóvel.

Funciona também num relógio inteligente? Os passes da Apple Wallet aparecem normalmente também num Apple Watch emparelhado. Não o podemos garantir para cada dispositivo — por isso não conte com isso à porta e mantenha o telemóvel como via normal.

O passe fica guardado depois do evento? Sim, até o visitante o apagar. Um passe de bilhete passa para o fundo da lista depois da data; um passe anual fica à frente até ao fim do seu período.