Construtor de passes do Google Wallet

O construtor de passes do Google Wallet é um designer visual no Painel de Controle. Você escolhe um tipo de passe, preenche a marca, os campos e um código de barras, assiste a uma prévia ao vivo e cria o passe. Quando você gera o passe, o Pushwoosh cria o objeto do passe no Google Wallet e retorna um link para salvar “Adicionar ao Google Wallet”.

Criar um passe

Configuração necessária primeiro

O construtor está disponível apenas após o Google Wallet ser configurado para o aplicativo (ID do Emissor, com a conta de serviço do Pushwoosh convidada para o seu emissor). Se ainda não estiver configurado, configure-o primeiro: Configuração de passes do Google Wallet para Android.

No Painel de Controle, vá para Campanhas → Wallet Passes, abra a aba Todos os passes, selecione Google Wallet e clique em Criar passe.

Configurar o passe

• Do zero: comece com um passe vazio. Escolha um tipo de passe, depois defina os campos, a aparência, um código de barras e outras opções você mesmo nas seções abaixo.

• A partir de um modelo: clique em Carregar modelo, escolha um passe pré-definido em Selecionar Modelo (genérico, oferta, fidelidade, ingresso para evento, vale-presente, voo ou trânsito). O modelo é aplicado assim que você clica nele. O formulário preenche previamente o tipo de passe, campos, cores e código de barras e define um logotipo provisório. Substitua o logotipo pelo seu antes de gerar o passe; caso contrário, o logotipo provisório irá no passe. Edite qualquer valor ou mude o tipo conforme necessário.

Escolha um tipo de passe

Em TIPO DE PASSE, escolha um dos sete tipos de passe do Google Wallet. O tipo controla o layout do cartão e quais campos estão disponíveis. Passes tipificados usam o layout nativo do Google. O passe genérico é de formato livre. Não é possível alterar o tipo depois de criar o passe.

• Genérico: cartão de formato livre com seus próprios campos.
• Oferta: cupons e descontos.
• Cartão de fidelidade: cartões de fidelidade e de membro.
• Ingresso para evento: ingressos para eventos.
• Vale-presente: vales-presente e cartões pré-pagos.
• Voo: cartões de embarque.
• Trânsito: bilhetes de trem, ônibus, bonde e balsa.

Preencha os campos do passe

Os campos que você vê dependem do tipo de passe. O construtor não marca os campos obrigatórios, mas Validar passe e Gerar informam os que estiverem vazios. Campos comuns por tipo:

Tipo de passe	Campos principais
Genérico	Título do cartão*, Cabeçalho*, Subcabeçalho, até 6 campos no cartão
Oferta	Título*, Provedor*, Detalhes, Letras miúdas, Canal de resgate (BOTH, INSTORE, ONLINE ou TEMPORARY_PRICE_REDUCTION), Nome do emissor
Fidelidade	Nome do programa*, Nome do membro, ID do membro, Saldo de pontos, Rótulo de pontos, Nível de recompensas, Rótulo de nível, Nome do emissor
Ingresso para evento	Nome do evento*, Local, Endereço, Início, Término, Portador do ingresso, Número do ingresso, Tipo de ingresso, Seção, Fila, Assento, Portão
Vale-presente	Comerciante*, Número do cartão*, PIN, Saldo + moeda
Voo	Companhia aérea (código IATA), Número do voo, De*, Para*, Partida*, Nome do passageiro*, Horário de embarque, Assento, Classe, Grupo de embarque, Código de confirmação
Trânsito	Tipo* (ônibus / trem / bonde / balsa / outro), Operadora* (a menos que o Nome do emissor esteja definido), Passageiro*, Tipo de viagem, trechos da viagem (origem*, destino*, horários, plataforma, vagão, assento), Nome do emissor

* Obrigatório pelo Google.

Datas e horas

A maioria dos tipos de passe usa o formato ISO 8601 com um deslocamento UTC (por exemplo, 2026-07-01T19:30:00+02:00). Passes de voo são uma exceção: o Google exige que os horários de partida, embarque e chegada estejam no horário local do aeroporto, sem um deslocamento (por exemplo, 2026-09-01T06:30:00).

Personalize o conteúdo do passe

Cada passe está vinculado a um User ID. Use marcadores de Tag para mostrar dados exclusivos daquele usuário, por exemplo, um saldo de pontos em um cartão de fidelidade ou o nome do destinatário em um vale-presente. Emita um passe por User ID para que cada destinatário receba seus próprios valores.

Para inserir um marcador de Tag:

1. Ao lado de um campo de texto compatível (por exemplo, Comerciante, Título do cartão ou Cabeçalho), clique em {} para inserir uma Tag.
2. Em TAG, selecione a Tag para inserir no campo.
3. Em FORMATO, escolha como exibir o valor da Tag: Como está (usar o valor armazenado), Inteiro (arredondar para um número inteiro), Preço (0.00) (mostrar duas casas decimais), Capitalizar primeira letra, Data (5 Aug 1980), Data e hora (5 Aug 1980 14:30) ou Hora (14:30).
4. Em Fallback (se estiver vazio), opcionalmente, insira um texto para mostrar quando o destinatário não tiver um valor para a Tag.
5. Clique em Inserir.

O Pushwoosh preenche os valores das Tags quando você cria o passe e os atualiza a cada atualização.

Definir a aparência

Em APARÊNCIA, configure cores, imagens, quem pode salvar o passe e a expiração.

Cores

Clique em Cor de Fundo e escolha uma cor no seletor de cores.

Imagens

Clique em Escolher uma imagem ao lado de Logo para escolher uma imagem do Armazenamento de mídia do aplicativo, enviar uma nova ou obter uma de fotos de banco de imagens ou por geração com IA. O seletor aceita arquivos PNG e JPEG. O logotipo é obrigatório para passes de fidelidade e trânsito.

Opcionalmente, clique em Escolher uma imagem ao lado de Imagem hero para um banner largo mostrado abaixo dos detalhes do cartão na frente do passe. O tamanho recomendado é 1032×336 px.

Se o Armazenamento de mídia do aplicativo tiver um recorte já dimensionado para o local, escolha esse recorte.

Excluindo a imagem no Armazenamento de mídia

O Armazenamento de mídia bloqueia a exclusão de uma imagem somente enquanto uma campanha de passes da Wallet a usa. Uma imagem escolhida para um único passe não fica protegida, então mantenha-a no Armazenamento de mídia enquanto o passe estiver em uso.

Quem pode salvar o passe

Em Quem pode salvar o passe, selecione quem pode adicionar o passe ao Google Wallet. Não é possível alterar essa configuração depois que o passe é criado.

• Um usuário, todos os seus dispositivos (padrão): o passe está vinculado a uma conta do Google e sincroniza entre os dispositivos dessa conta.
• Um usuário, um dispositivo: o passe é salvo em um único dispositivo apenas.
• Qualquer pessoa com o link: toda conta do Google que abrir o link de salvamento recebe o mesmo objeto de passe compartilhado. Quando você atualiza o passe, o Google entrega a alteração a todos os portadores automaticamente.

Qualquer pessoa com o link

Use isso para passes onde todos os portadores veem o mesmo conteúdo, por exemplo, uma oferta para toda a loja ou um ingresso de evento público sem assento marcado. Evite para cartões de fidelidade, vales-presente ou qualquer passe onde o conteúdo deva ser personalizado por usuário. O Pushwoosh rastreia apenas um dispositivo para o objeto compartilhado, então os portadores individuais não são visíveis e não podem ser segmentados separadamente.

Expiração

Defina a Data de expiração para quando o Google deve expirar o passe, ou deixe em branco para não expirar.

Adicionar um código de barras

Em CÓDIGO DE BARRAS, escolha um formato e insira o valor a ser codificado:

1. Formato: escolha como o código de barras se parece e que tipo de scanner pode lê-lo.
   • QR_CODE: código quadrado que a maioria dos telefones e scanners lê facilmente. Melhor para a maioria dos passes.
   • PDF_417: código de barras largo feito de várias fileiras de linhas. Frequentemente exigido para cartões de embarque.
   • AZTEC: código quadrado compacto, semelhante ao QR. Comum em ingressos de eventos e trânsito.
   • CODE_128 / EAN_13: códigos de barras 1D. Escolha estes apenas se seu scanner ou sistema de PDV os exigir.
2. Valor: os dados codificados no código de barras (por exemplo, um número de ingresso ou de membro). Para usar um valor único por usuário, clique em {} ao lado do campo e insira um marcador de Tag.
3. Texto alternativo: texto mostrado abaixo do código de barras no passe.

Adicionar campos de detalhes e links

Na frente do passe, os usuários veem o cartão principal. Quando abrem os detalhes do passe (o verso), eles podem ler seções extras e tocar nos links que você adicionar aqui.

• Campos nos detalhes: texto extra no verso do passe. Clique em + Adicionar campo e defina um Rótulo e um Valor. Use-os para termos, instruções ou outras informações que não cabem na frente.
• Links: links tocáveis no verso do passe. Clique em + Adicionar link e defina uma URL e um Rótulo do link curto (por exemplo, “Localizador de lojas” ou “Termos e condições”).

Adicionar um link de aplicativo (opcional)

Em LINK DO APLICATIVO, adicione um botão na frente do passe que abre uma página da web ou seu aplicativo Android quando tocado. Você pode definir uma URL, um nome de pacote Android, ou ambos.

Se você definir apenas a URL, o botão abre esse endereço da web em qualquer dispositivo. Se você definir apenas um nome de pacote, o botão funciona em dispositivos Android que têm o aplicativo instalado, sem um fallback para a web. A URL deve começar com https://.

Depois que o passe é criado, você pode alterar o link do aplicativo, mas não removê-lo.

Adicionar locais (opcional)

Em Relevância baseada em localização, adicione pontos de interesse. O Google mostra uma notificação geocercada quando o usuário está perto de um local que você adiciona. Por exemplo, mostre um cartão de fidelidade perto da sua loja, um ingresso de evento perto do local, ou um cartão de embarque perto do aeroporto.

Você pode adicionar até 10 locais. Para adicionar um, clique no mapa, pesquise um endereço, cole coordenadas ou importe uma geozona.

Locais no Google Wallet

O Google controla o raio da geocerca e decide quando mostrar a notificação. Você não pode definir uma distância máxima por local.

Insira um User ID

Insira o User ID do Pushwoosh para a pessoa que receberá este passe.

O Pushwoosh emite o passe para esse usuário e o lista em USUÁRIO em Todos os passes.

Pré-visualizar e validar

Uma pré-visualização ao vivo é atualizada conforme você edita, para que você possa ver aproximadamente como o passe ficará no Google Wallet.

A pré-visualização pode ser diferente em um dispositivo

A pré-visualização é uma aproximação. Passes tipificados usam o layout nativo do Google, então o passe pode parecer diferente em um dispositivo real. Um QR code na pré-visualização codifica o valor real, enquanto outros formatos de código de barras são mostrados como marcadores.

Para verificar o passe em relação aos requisitos do Google sem criá-lo, clique em Validar passe. O construtor sinaliza campos obrigatórios ausentes e outros problemas.

Gerar o passe

Clique em Gerar. O Pushwoosh verifica o passe e o cria no Google Wallet. Você recebe um link para salvar Adicionar ao Google Wallet para compartilhar com os usuários. Em poucos segundos, o passe aparece em Todos os passes.

Para editar, obter o link de salvamento, invalidar e excluir passes após a criação, veja Gerenciar passes existentes. Para enviar o passe aos usuários, veja Compartilhar passes da Wallet.

Para emitir um mesmo design para muitos usuários e atualizar de uma só vez os campos compartilhados em todos os passes emitidos, crie uma campanha de passes da Wallet. Uma campanha usa as mesmas seções de design que este construtor.

Gerenciar passes via API

Tudo o que o construtor de passes faz também está disponível através da API do Google Wallet: criar, atualizar, listar, obter um link de salvamento, definir estado e excluir passes.

API do Google Wallet