Como começar
O que é a API Google Wallet?
A API Google Wallet permite que os desenvolvedores criem cartões digitais na Carteira do Google. No momento, a API Google Wallet tem suporte para cartões de embarque ingressos de eventos, cartões de fidelidade, ofertas e cartões de transporte público. Mais recentemente, um tipo de cartão genérico foi adicionado para atender a outros casos de uso.
Exceções de API e solução de problemas
- O que é uma exceção desse tipo?
-
Se você encontrar alguma exceção de API ao trabalhar com a API Google Wallet, consulte a tabela a seguir para conferir explicações e sugestões:
Exceção Exemplo de mensagem Sugestão 400 - BadRequestException A solicitação contém um argumento inválido. ID de recurso inválido: {1234567891234567899 - ABCD1234567}. Verifique o tipo, formato e comprimento da estrutura de dados e transmita o argumento correto. 403 - PermissionDeniedException Permissão recusada Verifique se o e-mail correto da conta de serviço é um usuário autorizado no seu console do Google Pay e da Carteira. 404 - NotFoundException Objeto da Carteira não encontrado: {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}. Use um comando GET no ID do objeto antes de tentar uma solicitação PATCH ou PUT para garantir que haja um objeto para atualizar e que esse seja o mais recente. 404 - IssuerClassNotFoundException Classe de objeto Carteira {1234567891234567899.ABCD.1234567} não encontrada. Ao realizar uma atualização, use o comando GET antes de fazer uma solicitação PATCH ou PUT para garantir que você tenha a classe mais recente para referenciar. Verifique também se o payload correto (objeto e classe) está sendo usado corretamente na solicitação. 409 - AlreadyExistsException A classe de objeto da Carteira já existe: {1234567891234567899.ABCD.1234567}. Use um comando GET no ID da classe antes de tentar criar esse mesmo ID. Se o recurso existir, use PATCH ou PUT. - Primeiro, verifique se o logotipo segue as diretrizes e se está salvo no formato PNG.
- Verifique se o logotipo está disponível com alta confiabilidade. Não redirecione para arquivos de imagem que possam causar erros 404. Suas imagens precisam ser hospedadas em um local HTTPS. Caso contrário, elas não serão exibidas na Carteira do Google.
- Verifique se todos os campos sinalizados como obrigatórios na API estão definidos no cartão.
- Essa opção permite uma abordagem gerenciada centralmente usando uma conta principal com nenhuma ou muitas subempresas/emissores.
- Um projeto do Google Cloud.
- 1 credencial da conta de serviço.
- Conjunto único de usuários.
- Essa opção permite uma abordagem centralmente gerenciada usando uma conta principal com muitas subempresas.
- 1 Projeto do Google Cloud.
- Usuários distintos do Business Console por emissor.
- De uma a várias credenciais da conta de serviço.
- Uma credencial por empresa/emissor.
- Acesso diferente às credenciais por empresa.
- Essa opção permite uma abordagem centralmente gerenciada usando uma conta principal com muitas subempresas.
- De um a muitos projetos do Google Cloud.
- Usuários distintos do Business Console por emissor.
- De uma a várias credenciais da conta de serviço.
- Uma credencial PROD por empresa/emissor.
- Uma credencial DEV por empresa/emissor.
Dúvidas gerais
Como faço para ativar as notificações push?
No momento, a Carteira do Google não oferece suporte a notificações push criadas pelo desenvolvedor. No entanto, a Carteira do Google conta com notificações tempestivas para os cartões a seguir. No momento, a Carteira do Google não oferece suporte a notificações push criadas pelo desenvolvedor.
| Indústria | Notificação | Acionada | Documentação |
|---|---|---|---|
| Evento | Lembrete programado | 3 horas antes do evento | docs |
| Cartão de embarque | Lembrete programado | 3 horas antes da partida do voo | docs |
| Cartão de embarque | Atualização do cartão | Alteração do terminal de origem, portão, horário de embarque ou hora da partida | docs |
| Cartão de oferta | Lembrete de vencimento | 48 horas antes do vencimento do cartão de oferta | docs |
| Genérico | Lembrete programado | 24 horas antes do início do "intervalo" | docs |
| Genérico | Lembrete de vencimento | 48 horas antes do término do "intervalo" | docs |
É possível excluir IDs de comerciante?
No momento, os IDs de comerciante não podem ser excluídos ou arquivados no Console do Google Pay e da Carteira.
Como faço para excluir classes ou objetos?
No momento, não é possível excluir classes ou objetos da Carteira do Google. No entanto, os usuários podem desvincular objetos da Carteira do Google.
Como usar o recurso de vinculação de aplicativos?
Para usar a vinculação de aplicativos, é necessário ter uma lista de permissões, que pode ser solicitada aqui.
Por que minha configuração de horário exibe a hora errada para o evento?
O horário exibido no passaporte é o horário local do evento, diferente do horário em que ele ocorre.
A Carteira do Google oferece suporte a fronteiras geográficas virtuais?
No momento, não.
Como faço para configurar um programa de fidelidade?
Siga este guia para configurar um programa de inscrição e fidelidade.
Como posso enviar ao Google meu logotipo para cartões de transporte público?
Use este formulário para enviar o logotipo ao Google para inclusão na lista de permissões.
Meu logotipo não está renderizando nos cartões que criei. O que pode estar errado?
Existem ferramentas que simplificam a implementação e a depuração de JWTs?
Sim, plataformas como www.jwt.io permitem decodificar e depurar os tokens durante o processo de desenvolvimento para verificar o conteúdo que está sendo enviado. O Google não tem afiliação e não recomenda nenhum desses terceiros especificamente.
Como processar corretamente os dados userProfile codificados em Base64?
Use a codificação UTF-8 em todo o processo. A string JSON é codificada primeiro em UTF-8 e, depois, em android.util.Base64 com as opções NO_WRAP e URL_SAFE. Esse método corresponde à seção 4 do RFC 3548.
Como faço para agrupar vários cartões?
Use o GroupingID para facilitar o agrupamento de cartões.
Como faço para criar contas de emissor de forma programática?
Consulte este guia para criar contas de emissor usando a API.
O URL do meu link JWT excede a restrição de 1.800 caracteres do navegador. O que eu faço?
É possível criar previamente classes e objetos usando a API, antes de criar o link do salvamento de cartões (JWT).
Como atualizar apenas parte de um cartão?
Siga nosso guia de desempenho para entender como fazer atualizações parciais usando solicitações PATCH.
Posso criar cartões em lote?
Siga nosso guia de desempenho para entender como realizar solicitações em lote usando a API.
Toque inteligente
Preciso de um leitor de NFC especial para os cartões do Google SmartTap?
Ele precisa ser um terminal compatível com SmartTap. Confira uma lista de fornecedores certificados aqui.
Como faço para que meus cartões funcionem com NFC?
Acompanhe esta configuração para permitir que seu cartão seja resgatável usando o Toque inteligente.
Configuração do desenvolvedor
Como posso configurar meu ambiente de desenvolvimento com base nos requisitos e na complexidade dos negócios?
Confira abaixo guias que podem ser usados para configurar um ambiente de desenvolvimento voltado para diferentes níveis de complexidade e segurança empresarial. O uso de várias contas de serviço permite que os desenvolvedores criem um ambiente de teste separado do ambiente PROD.
Complexidade de configuração básica
De uma conta do Business Console ou uma conta principal do Business Console a várias contas do emissor.
Complexidade de configuração média
De uma conta pai a várias contas de emissor.
Complexidade de configuração alta
De uma conta pai a várias contas de emissor.
Como entro em contato com o suporte técnico?
Se precisar de mais ajuda, entre em contato com a equipe de suporte usando o Console do Google Pay e da Carteira.
Entrar em contato com o suporte
Enviar feedback
Como envio feedback sobre o produto?
Para enviar feedback sobre o produto, clique no botão "Enviar feedback" no quadrante superior direito da página do site para desenvolvedores e selecione "Feedback sobre o produto". Em seguida, descreva seu feedback na área de texto e clique em "Enviar".
Como envio feedback sobre a documentação?
Para enviar feedback sobre a documentação, clique no botão "Enviar feedback" no quadrante superior direito da página do site para desenvolvedores e selecione "Feedback sobre a documentação". Em seguida, descreva seu feedback na área de texto e clique em "Enviar".