O recurso de inscrição de vale-presente (login) permite que os usuários pesquisem um vale-presente e adicione-o à 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.
- Desenvolver páginas de login que usam a Carteira do Google
SharedDataType. - Implemente o envio do vale-presente à Carteira do Google após o login.
- Solicitar verificação e 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 em Console, selecione API Google Wallet no tópico e, em seguida, Login com vale-presente 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 com o objetivo de 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 a criptografia
HTTPScom um certificado válido para garantir que os dados do usuário sejam são transmitidas 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
que está incluído na solicitação POST usando
application/x-www-form-urlencoded e
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), sua página deve enviar imediatamente o vale-presente do usuário para a Carteira do Google.
Envie o vale-presente para a Carteira do Google redirecionando para um que segue a estrutura
https://pay.google.com/gp/v/save/{jwt_generated}
O tamanho seguro de um URL é 2.000 caracteres. Seus links devem permanecem abaixo desse limite. Objetos codificados em JWTs devem ser pequenos, contendo apenas dados específicos do usuário. Tente manter a maioria dos dados na classe do objeto, criando-o 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. Todas as ações entre "Seu servidor" são sua responsabilidade de implementar.
Solicitar verificação e ativação
Depois de concluir o trabalho de desenvolvimento e testar o fluxo de login, envie uma solicitação através do Entre em contato com o suporte do Console do Google Pay e da Carteira widget.
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 em caso de discrepâncias e o recurso de login pode 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 serã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 seus tokens durante o processo de desenvolvimento, permitindo verificar a conteúdo que você está enviando. 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 a Seção 4 do RFC 3548.