Projete passes da Carteira Google no construtor de passes

O construtor de passes da Carteira Google é 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é-visualização ao vivo e cria o passe. Quando você gera o passe, o Pushwoosh cria o objeto do passe na Carteira Google e retorna um link para salvar “Adicionar à Carteira Google”.

Criar um passe

Requer configuração prévia

O construtor está disponível apenas após a Carteira Google ser configurada 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 passe da Carteira Google para Android.

No Painel de Controle, vá para Campanhas → Passes da Carteira, abra a aba Carteira Google e clique em Criar passe.

Configurar o passe

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

• A partir de um modelo: clique em Carregar modelo, escolha um passe integrado em Selecionar Modelo (genérico, oferta, fidelidade, ingresso para evento, cartão-presente, voo ou transporte) e confirme. O formulário preenche previamente o tipo de passe, os campos, as cores e o código de barras. Edite qualquer valor ou altere o tipo conforme necessário.

Escolha um tipo de passe

Em TIPO DE PASSE, escolha um dos sete tipos de passe da Carteira Google. 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.
• Cartão-presente: cartões-presente e pré-pagos.
• Voo: cartões de embarque.
• Transporte: bilhetes de trem, ônibus, bonde e balsa.

Preencha os campos do passe

Os campos que você vê dependem do tipo de passe. Os campos obrigatórios estã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
Cartão-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
Transporte	Tipo de transporte* (ônibus / trem / bonde / balsa / outro), Operadora*, Passageiro*, Tipo de viagem, trechos da viagem (origem*, destino*, horários, plataforma, vagão, assento)

* Obrigatório pelo Google.

Datas e horários

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 ID de Usuário. Use placeholders 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 cartão-presente. Emita um passe por ID de Usuário para que cada destinatário receba seus próprios valores.

Para inserir um placeholder 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 (colocar a primeira letra em maiúscula).
4. Em FALLBACK, opcionalmente, insira um texto para ser exibido 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 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

Hospede imagens em uma URL HTTPS pública

A Carteira Google não armazena seu logotipo ou imagem principal. Hospede cada arquivo em uma URL HTTPS pública que permaneça online e acessível, e cole o link no construtor de passes. Se a URL quebrar ou o arquivo for removido, a imagem deixará de carregar no passe.

Cole um link HTTPS público em URL do logotipo. Obrigatório para passes de fidelidade e de transporte.

Opcionalmente, cole um link em URL da imagem principal para um banner largo abaixo dos detalhes do cartão na frente do passe. O tamanho recomendado é 1032×336 px.

URLs da galeria de mídia

Você pode colar uma URL de imagem pública da Galeria de mídia, incluindo uma variante dimensionada para o local.

Nota: Se você excluir a imagem na Galeria de mídia, ela deixará de carregar no passe.

Quem pode salvar o passe

Em Quem pode salvar o passe, selecione quem pode adicionar o passe à Carteira Google:

• Um usuário, todos os seus dispositivos (padrão): o passe é vinculado a uma conta Google e sincronizado entre os dispositivos dessa conta.
• Um usuário, um dispositivo: o passe é salvo em um único dispositivo apenas.
• Qualquer pessoa com o link: cada conta 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 para um evento público sem assento marcado. Evite para cartões de fidelidade, cartões-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 de transporte.
   • CODE_128 / EAN_13: códigos de barras 1D. Escolha estes apenas se o 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 placeholder 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 do pacote Android, ou ambos.

Se você definir apenas a URL, o botão abrirá esse endereço da web em qualquer dispositivo. Se você definir apenas um nome de pacote, o botão funcionará em dispositivos Android que tenham o aplicativo instalado, sem um fallback para a web.

Adicionar locais (opcional)

Em Relevância baseada na 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, exiba 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 na Carteira Google

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

Insira um ID de Usuário

Insira o ID de Usuário 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 enquanto você edita, para que você possa ver aproximadamente como o passe ficará na Carteira Google.

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

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 и o cria na Carteira Google. Você recebe um link para salvar Adicionar à Carteira Google 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, consulte Gerenciar passes existentes.

Gerenciar passes via API

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

API da Carteira Google