Criar passes do Google Wallet no construtor de passes

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 e chave da conta de serviço). 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 → Passes da Carteira, abra a aba 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) e confirme. O formulário preenche previamente o tipo de passe, campos, cores e código de barras. 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.

• 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. Campos obrigatórios são marcados. Campos comuns por tipo:

Tipo de passe	Campos principais
Genérico	Título do cartão*, Cabeçalho*, Subcabeçalho, campos do cartão
Oferta	Título*, Provedor*, Detalhes, Letras miúdas, Canal de resgate (na loja / online / ambos), 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, Data e hora de início/fim, Portador do ingresso, Número do ingresso, Tipo, Seção, Fila, Assento, Portão
Vale-presente	Nome do comerciante*, Número do cartão*, PIN, Saldo + moeda
Voo	Código IATA da companhia aérea*, Número do voo*, Origem*, Destino*, Partida*, Nome do passageiro*, Horário de embarque, Assento, Classe, Grupo de embarque, Código de confirmação
Trânsito	Tipo de trânsito* (ônibus / trem / bonde / balsa / outro), Operador*, Passageiro*, Tipo de viagem, trechos da viagem (origem*, destino*, horários, plataforma, vagão, assento)

* 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) ou Primeira letra maiúscula (capitalizar a primeira letra).
4. Em FALLBACK, 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

Insira um código hexadecimal em Cor de fundo, por exemplo, #FFFFFF para branco. Inclua o # inicial e seis caracteres.

Imagens

Clique em Escolher uma imagem ao lado de Logotipo para escolher ou enviar um arquivo da Loja de Mídia do aplicativo. Obrigatório para passes de fidelidade e trânsito.

Clique em Escolher uma imagem ao lado de Imagem principal (opcional) para um banner largo mostrado abaixo dos detalhes do cartão na frente do passe. O tamanho recomendado é 1032×336 px.

Variantes da Loja de Mídia

Escolha uma variante já dimensionada para o local, se a Loja de Mídia do aplicativo tiver uma.

Excluindo a imagem na Loja de Mídia

Se você excluir a imagem na Loja de Mídia, ela deixará de ser carregada no passe. Clique em Remover ao lado de um espaço para desmarcá-lo.

Quem pode salvar o passe

Em Quem pode salvar o passe, selecione quem pode adicionar o passe ao Google Wallet:

• 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.

• Módulos de texto: blocos de texto extras no verso do passe. Defina um cabeçalho (o título da seção) e um corpo (o texto). Use-os para termos, instruções ou outras informações que não cabem na frente.
• Links: links tocáveis no verso do passe. Defina uma URL e uma descrição curta (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.

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, cada um definido por latitude e longitude.

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. O código de barras mostrado é um marcador.

Para verificar o passe em relação aos requisitos do Google sem criá-lo, clique em Validar. 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.

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