Depois de criar um cartão e codificá-lo em um JWT assinado, você poderá emitir o cartão em qualquer lugar que aceite o link "Adicionar à Carteira do Google". Para isso, apresente ao usuário um botão "Adicionar à Carteira do Google" ou um hiperlink, que salvará o cartão na Carteira do Google quando ele for tocado. Exemplos de onde você pode usar esse método incluem apps para dispositivos móveis, sites, e-mail, chat e SMS.
Pré-requisitos
Antes de tentar emitir um cartão, faça o seguinte:
- Conclua todas as etapas do guia de integração.
- Crie pelo menos uma classe de cartões.
- Crie pelo menos um objeto de cartões.
- Codifique sua classe e objeto de cartões em um JWT.
- Assine o JWT com a chave da conta de serviço do Google Cloud.
1. Criar um link "Adicionar à Carteira do Google"
A emissão de um cartão com um link da Carteira do Google adiciona o objeto de cartões à Carteira do Google de um usuário e só pode ser iniciada no contexto de uma identidade do Google conectada.
O link "Adicionar à Carteira do Google" é um URL gerado dinamicamente que contém um JSON Web Token (JWT) codificado e assinado.
O link "Adicionar à Carteira do Google" tem este formato:
https://pay.google.com/gp/v/save/<signed_jwt>
Por exemplo, um link "Adicionar à Carteira do Google" completo será parecido com este:
https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A
Esse link pode ser incorporado a apps para dispositivos móveis, sites, e-mails, chats, SMS ou qualquer outro lugar que aceite hiperlinks.
Para mais informações sobre como criar classes e objetos de cartões, consulte Criar classes e objetos de cartões.
Para mais informações sobre como criar o JWT assinado necessário para criar um link "Adicionar à Carteira do Google", consulte Como trabalhar com JSON Web Tokens.
2. (Recomendado) Use o botão "Adicionar à Carteira do Google"
Para qualquer superfície que aceite imagens com hiperlinks, como sites e e-mails, recomendamos apresentar o link "Adicionar à Carteira do Google" aos usuários com um botão "Adicionar à Carteira do Google". Para os usuários da Carteira do Google, o botão é um comando conhecido que pode ser usado para iniciar a adição de um cartão à Carteira do Google.
Os recursos de imagem estão disponíveis para download em várias orientações e idiomas para ajudar na integração da API Google Wallet.