A Carteira do Google oferece uma API REST que permite criar e gerenciar cartões enviando solicitações à API Google Wallet por HTTP. Isso é útil para quem quer criar serviços do lado do servidor para trabalhar com cartões de maneira programática.
Para usar a API REST da Carteira do Google, ative a API no console do Google Cloud, crie uma conta de serviço do Google Cloud e gere uma chave para ela.
Quando você cria cartões com a API REST, a chave da conta de serviço é usada para assinar seus objetos de cartões codificados por token da Web do JSON.
Para outras operações, como atualizar ou excluir cartões, a chave da conta de serviço é enviada com a solicitação para autenticar você como emissor do cartão.
1. Ativar a API REST da Carteira do Google
Para ativar a API REST Google Wallet, faça o seguinte:
- Se você ainda não tem uma conta do Google Cloud, acesse o console do Google Cloud e siga as etapas para se registrar em uma nova conta.
- No menu suspenso do projeto, na parte superior do console, selecione o projeto do Google Cloud que você quer usar ou crie um novo.
- Acesse a página de detalhes do produto da API Google Wallet no Console do Google Cloud Marketplace.
- Clique no botão "Ativar". Em alguns instantes, a API REST da Carteira do Google vai estar disponível para o projeto selecionado do Google Cloud.
2. Gerar uma chave de conta de serviço do Google Cloud
Para autenticar solicitações para a API REST da Carteira do Google, você precisará criar uma conta de serviço e gerar uma chave de conta de serviço fazendo o seguinte:
- Acesse a página Criar conta de serviço no console do Google Cloud.
- Preencha os detalhes da conta de serviço. Observe o endereço de e-mail da conta de serviço que aparece abaixo do campo "ID da conta de serviço". Você vai precisar dele mais tarde ao usar a conta de serviço para autenticar suas solicitações na API REST da Carteira do Google.
- Clique no botão "CONCLUÍDO". Não é necessário concluir as outras etapas de criação da conta de serviço.
- Clique no item de menu "CHAVES" na parte superior da página.
- Clique no menu suspenso "ADICIONAR CHAVE" e clique em "Criar nova chave".
- Selecione o tipo de chave "JSON".
- Clique em "CRIAR" para criar e fazer o download da chave da conta de serviço.
3. Autorizar sua conta de serviço no console da Carteira do Google
Para autenticar suas solicitações para a API REST da Carteira do Google usando uma chave de conta de serviço, adicione o endereço de e-mail da sua conta de serviço como um usuário à conta de emissor. Para adicionar a conta de serviço como um usuário, faça o seguinte:
- Acesse a página Contas de serviço no console do Google Cloud.
- Copie o endereço de e-mail da conta de serviço que você quer usar para autenticar suas solicitações na API Google Wallet.
- Acesse o console do Google Pay e da Carteira.
- Na navegação à esquerda, clique em "Usuários".
- Clique em "Convidar um usuário".
- Insira o endereço de e-mail da sua conta de serviço.
- No menu suspenso "Nível de acesso", selecione "Desenvolvedor".
- Clique no botão "Convidar".
Depois que a conta de serviço for adicionada, use as chaves de conta de serviço geradas para autenticar as solicitações à API REST da Carteira do Google. Ao usar chaves de conta de serviço, lembre-se de que essas são credenciais altamente confidenciais que só podem ser usadas em ambientes seguros do lado do servidor.