O recurso de inscrição (login) de vale-presente permite que os usuários pesquisem um vale-presente e o adicionem à Carteira do Google. Os usuários serão direcionados ao seu site compatível com dispositivos móveis para concluir a e depois pode adicionar o cartão à Carteira do Google.
Este guia fornece uma visão geral das etapas de implementação necessárias para ativar seu programa de vale-presente para esse recurso.
Visão geral
Para começar, verifique se você já configurou o projeto e tem acesso ao API Google Wallet.
Siga estas quatro etapas para implementar o recurso de login para o programa de vales-presente:
- Configure uma classe de teste na Carteira do Google para testar seu fluxo de login.
- Desenvolva páginas de login que usam a
SharedDataTypeda Carteira do Google. - Implemente o envio do vale-presente para a Carteira do Google após o login.
- Solicite a verificação e a ativação.
Configurar uma classe de teste na Carteira do Google
Determine o URL de login e o logotipo do programa. Depois,
use os campos aninhados discoverableProgram na
giftcardclass para definir
valores adequados.
Defina os valores no discoverableProgram para criar uma versão de rascunho do
programa de vale-presente com login ativado. Para garantir que isso fique visível para os testadores, verifique se
os testadores tenham acesso ao seu Console do Google Pay e da Carteira. Para mais detalhes sobre como compartilhar
o acesso do Google Pay e do Console da Carteira com outras pessoas. Consulte
Saiba mais sobre a página "Usuários".
concluir a verificação da funcionalidade da sua implementação durante o desenvolvimento; use o widget de contato com o suporte no Console do Google Pay e da Carteira. Enquanto estiver no console, selecione API Google Wallet no tópico e depois Login de vale-presente no subtópico.
Desenvolver uma página de login que use os dados do usuário da Carteira do Google
Quando um usuário escolhe adicionar seu vale-presente, ele é direcionado para uma página personalizada no seu site para concluir o processo de login.
Você precisa fornecer um URL de login em que o usuário possa fazer login em uma conta existente.
A página de login precisa atender aos seguintes requisitos:
- Proporcione uma experiência do usuário otimizada para dispositivos móveis.
- Permitir que o usuário conclua o login em uma única página.
- Use criptografia
HTTPScom um certificado válido para garantir que os dados do usuário sejam transmitidos com segurança. - Garanta pelo menos 99,9% de tempo de atividade da sua página de login.
Ao apresentar a página de login, a Carteira do Google cria
um WebView do Android e uma solicitação POST for feita ao
URL. Os dados do usuário são fornecidos no parâmetro SharedDataType
incluído na solicitação POST usando
o tipo de conteúdo
application/x-www-form-urlencoded e a
codificação UTF-8. O valor de SharedDataType
é um objeto JSON codificado em Base64.
Implementar envio imediato do vale-presente para a Carteira do Google
Depois da autenticação (login), a página precisa enviar imediatamente o vale-presente do usuário para a Carteira do Google.
Remeta o vale-presente à Carteira do Google redirecionando para um link que siga a estrutura.
https://pay.google.com/gp/v/save/{jwt_generated}O comprimento seguro de um URL é 2.000 caracteres. Os links precisam permanecer abaixo desse limite. Os objetos codificados em JWTs precisam ser pequenos e conter apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-a antes do JWT. Para objetos maiores, que não caibam no limite, considere criando primeiro o objeto API Google Wallet e envio apenas do ID do objeto no JWT.
Fluxo de comunicação típico
O fluxo de comunicação para um usuário que conclui o login é ilustrado no imagem a seguir. A responsabilidade por implementar todas as ações entre "Your Server" (Seu servidor) é sua.
Solicitar verificação e ativação
Depois de concluir o trabalho de desenvolvimento e testar o fluxo de login, envie uma solicitação pelo widget de contato com o suporte do Console do Google Pay e da Carteira.
Após uma revisão completa da implementação que confirmar o recurso correto em com o app Carteira do Google, o recurso de login por vale-presente será lançado publicamente para seu programa de vales-presente. Isso permitirá que qualquer usuário veja programa e usar esse recurso.
Para garantir uma experiência do usuário ideal, verificações recorrentes do seu login implementação será realizada para garantir a conformidade contínua com os requisitos do recurso. Você vai receber uma notificação no caso de discrepâncias, e o recurso de login poderá ser desativado até que o problema seja resolvido.
Perguntas frequentes
- Há algum requisito para as imagens usadas no meu programa de vales-presente?
- Sim, as imagens precisam ser hospedadas em
HTTPSlocal porque, de outra forma, eles não ficarão visíveis na Carteira do Google.
- Sim, as imagens precisam ser hospedadas em
- Há alguma ferramenta que simplifique 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, permitindo verificar o conteúdo que está sendo enviado. O Google não tem afiliação nem recomendar especificamente qualquer um desses terceiros.
- Como processamos corretamente os dados SharedDataType codificados em Base64?
- Use a codificação UTF-8 em todo o processo. String JSON é codificado primeiro em UTF-8 e, depois, em UTF-8 usando android.util.Base64 com as opções NO_WRAP e URL_SAFE. Isso corresponde à seção 4 do RFC 3548.