Primeiros passos
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.
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.
- 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 de 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.
- Um 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 alta
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
Como 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?
Use o GroupingID para facilitar 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 um limite de taxa de 20 solicitações por segundo.
Qual é o tempo limite recomendado para solicitações enviadas à API Google Wallet?
A API Google Wallet não tem um SLA oficial, mas recomendamos um tempo limite de 10 segundos, com base em uma latência do 99º percentil de cerca de 5 segundos. Além disso, a latência geralmente depende de fatores externos, como o tempo necessário para buscar uma imagem hospedada em um servidor externo ao inserir um objeto com essa imagem, já que isso depende da latência do servidor externo.
Por que as imagens pessoais não podem ser usadas em cartões na Carteira do Google?
A Carteira do Google não aceita imagens pessoais em cartões porque as regulamentações atuais afirmam que todos os consumidores têm o direito de recusar a coleta ou o tratamento de dados sensíveis. Ao ter dados sensíveis (imagens pessoais) como parte do objeto valioso (em um JWT), pode haver problemas de hospedagem em que os dados podem se tornar públicos, o que está fora do contrato de consentimento original. Para garantir a confidencialidade dos dados, não é permitido usar imagens pessoais. Estamos trabalhando para oferecer suporte a imagens pessoais no futuro.
Quais códigos de erro são retornados pela API Google Wallet?
Para conferir uma lista de códigos de erro e exceções retornados 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 envia notificações oportunas para os seguintes cartões: 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 | 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 |
Os IDs do comerciante podem ser excluídos?
No momento, os IDs de comerciante não podem ser excluídos ou arquivados no Console do Google Pay e da Carteira.
Como usar o recurso de vinculação de apps?
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 à fronteira geográfica virtual?
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 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. Esse método 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 de NFC especial para os cartões com Toque inteligente do Google?
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?
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?
É possível 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 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.
Meu logotipo não é renderizado nos cartões que eu 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. 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.
Suporte e feedback
Como entro em contato com o suporte técnico?
Se precisar de 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 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 faço para enviar 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".