Primeiros passos
O que é a API Google Wallet?
A API Google Wallet permite que os desenvolvedores criem cartões digitais no Carteira do Google. No momento, a API Google Wallet oferece suporte a 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.
Como posso configurar meu ambiente de desenvolvimento com base nos requisitos e na complexidade dos negócios?
Abaixo estão 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.
- Essa opção permite uma abordagem gerenciada centralmente usando uma conta principal com nenhuma ou muitas subempresas/emissores.
- 1 Projeto do Google Cloud.
- 1 credencial da conta de serviço.
- Conjunto único de usuários.
Complexidade de configuração média
De uma conta principal a várias contas de emissor.
- Essa opção permite uma abordagem gerenciada centralmente 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.
Complexidade de configuração complexa
De uma conta principal a várias contas de emissor.
- Essa opção permite uma abordagem gerenciada centralmente 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.
Entrar em contato com o suporte
Trabalhar com cartões
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 faço para agrupar vários cartões?
O uso de GroupingID facilita o agrupamento de cartões.
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.
Dúvidas gerais
Qual é o limite de taxa para solicitações enviadas à API Google Wallet?
As chamadas para a API Google Wallet têm taxa limitada a 20 solicitações por segundo.
Quais códigos de erro são retornados pela API Google Wallet?
Para conferir uma lista de códigos de erro e exceções retornadas pela API Google Wallet, consulte Códigos de erro.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 fornece notificações oportunas para os cartões abaixo. No momento, a Carteira do Google não oferece suporte a notificações push criadas pelo desenvolvedor.
| Vertical | Notificação | Acionado | Documentação |
|---|---|---|---|
| Evento | Lembrete programado | 3 horas antes do evento | documentos |
| Cartão de embarque | Lembrete programado | 3 horas antes da partida do voo | documentos |
| Cartão de embarque | Atualização do cartão | Alteração do terminal de origem, portão, horário de embarque ou horário da partida | documentos |
| Card de oferta | Lembrete de vencimento | 48 horas antes do vencimento do cartão de oferta | documentos |
| Genérico | Lembrete programado | 24 horas antes do início do "intervalo" | documentos |
| Genérico | Lembrete de vencimento | 48 horas antes do término do "intervalo" | documentos |
É possível excluir IDs de comerciante?
No momento, não é possível excluir ou arquivar IDs de comerciante nas APIs Google Pay e Console da Carteira.
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.
A Carteira do Google oferece suporte a fronteiras geográficas virtuais?
No momento, não há suporte para a fronteira geográfica virtual.
Como faço para configurar um programa de fidelidade?
Siga este guia para configurar um programa de inscrição e fidelidade.
Como envio 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.
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. Isso corresponde à seção 4 do RFC 3548.
Como faço para criar contas de emissor programaticamente?
Consulte este guia para criar contas de emissor usando a API.
Toque inteligente
Preciso de um leitor NFC especial para 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 a NFC?
Siga esta configuração para permitir que seu cartão seja resgatável usando o Toque inteligente.
JSON Web Tokens (JWTs)
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.
O URL do meu link JWT excede a restrição de navegador de 1.800 caracteres. O que devo fazer?
Você pode criar previamente classes e objetos usando a API antes de criar o link do salvamento de cartões (JWT).
Solução de problemas
Por que minha configuração de hora exibe o horário errado para o evento?
O horário exibido no passaporte é o horário local do evento, diferente do horário em que ele ocorre.
Meu logotipo não está renderizado nos cartões que criei. O que pode estar errado?
- 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. As imagens precisam ser hospedadas em um local HTTPS. Caso contrário, elas não ficarão visíveis na Carteira do Google.
- Verifique se todos os campos marcados como obrigatórios na API estão definidos no cartão.
Suporte e comentários
Como entro em contato com o suporte técnico?
Para receber mais ajuda, clique no botão "Entrar em contato com o suporte" na barra lateral esquerda do console do Google Pay e da Carteira.
Como envio feedback sobre o produto?
Para enviar feedback sobre o produto, clique em "Enviar feedback". no canto 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 em "Enviar feedback". no canto 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".