Perguntas frequentes sobre a API Google Wallet

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 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?

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

Complexidade de configuração alta

De uma conta mãe a várias contas de emissor.

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

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 taxa limitada a 20 solicitações por segundo.

Por que imagens pessoais não podem ser colocadas em cartões na Carteira do Google?

A Carteira do Google não oferece suporte a imagens pessoais em cartões porque as regulamentações atuais determinam que todos os consumidores têm o direito de recusar a coleta ou o processamento de dados sensíveis. Ao ter dados confidenciais (imagens pessoais) como parte do objeto valioso (em um JWT), pode haver preocupações 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, imagens pessoais não são permitidas. 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 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.

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 documentos
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" documentos

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 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 à 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. 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 de NFC especial para os cartões com Toque inteligente do Google?

Ele precisa ser um terminal compatível com o Toque inteligente. Confira uma lista de fornecedores certificados neste link.

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.

Tokens JSON Web (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.

É 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 cartão é 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. 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 obrigatórios marcados 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 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".