Prerequisites

Antes de usar a API Google Wallet para uma integração, siga estas etapas:

1. Criar uma conta de emissor da API Google Wallet

É necessário ter uma conta de emissor para criar e distribuir cartões para a Carteira do Google. Inscreva-se no Console do Google Pay e da Carteira para conseguir sua conta de emissor. Depois de se inscrever, acesse a página da API Google Wallet e clique em Criar seu primeiro cartão. Depois de aceitar os Termos de Serviço, você poderá começar a criar uma classe de cartão.

Após a etapa acima, você também pode testar o Codelab.

2. Ativar a API Wallet

• Faça login no Google Cloud Platform e ative a API Google Wallet no projeto do GCP.
• Se você ainda não tiver um projeto do GCP, crie um.
• Ative a API Google Wallet.

3. Crie uma conta de serviço

Uma conta de serviço e uma chave de conta de serviço são necessárias para chamar a API Google Wallet. A conta de serviço é a identidade que chama a API Google Wallet. A chave da conta de serviço contém uma chave privada que seu aplicativo usa para se autenticar na API Google Wallet.

Observação: a chave da conta de serviço é altamente confidencial. Se ela não estiver segura, um terceiro poderá usá-la para fazer chamadas de API em seu nome. Se a chave da conta de serviço for comprometida, revogue-a imediatamente, gere uma nova e atualize seu aplicativo para usar essa nova chave da conta de serviço.

Crie uma conta de serviço:

• 1.Crie uma conta de serviço no Console do Google Cloud fornecendo os seguintes detalhes:
  • Nome da conta de serviço — exemplo: Cliente da Web da Carteira
  • ID da conta de serviço — exemplo: my-service-account
• 2. Clique em CRIAR E CONTINUAR.
• 3. Clique em CONCLUÍDO.

Crie uma chave de conta de serviço:

• 1. Selecione sua conta de serviço. Por exemplo: [e-mail].
• 2. Clique no item de menu CHAVES na parte superior da página.
• 3. Clique em ADICIONAR CHAVE e escolha Criar chave.
• 4. Selecione o tipo de chave JSON.
• 5. Clique em CRIAR para criar e fazer o download da chave da conta de serviço.

4. Autorizar a conta de serviço

É preciso autorizar a conta de serviço para chamar a API. Para autorizá-la, conceda a ela acesso para gerenciar sua conta de emissor.

• Acesse a página Usuários no Console do Google Pay e da Carteira.
• 1. Clique em Convidar um usuário.
• 2. Adicione o endereço de e-mail da conta de serviço. Por exemplo: [e-mail].
• 3. Selecione Desenvolvedor para o nível de acesso.
• 4. Selecione Convidar.

5. Criar uma turma

Antes de criar e adicionar um GiftCardObject, é preciso criar um GiftCardClass. Para isso, faça login no Console do Google Pay e da Carteira, acesse a página API Google Wallet e crie uma nova classe de vale-presente.

1. Verifique se você está na guia Gerenciar
2. Você verá a mensagem "Você está no modo de demonstração" se for a primeira vez que cria um cartão.
3. No modo de demonstração, clique em Configurar contas de teste para adicioná-las. Somente essas contas poderão salvar os cartões enquanto sua conta de emissor estiver no modo de demonstração.
4. Clique em Criar uma turma
5. Escolha Vale-presente.
6. Preencha todos os campos obrigatórios marcados com *
7. Clique em Criar turma

Repita as etapas desta página se precisar de vários vales-presente.

Consulte o modelo de layout para mais informações sobre como esses atributos são representados no cartão.

Observação: se você precisar gerenciar e criar vales-presente dinamicamente, recomendamos o uso da API Web para automatizar a criação de classes de vale-presente.

Depois de criar uma classe de vale-presente, acesse Adicionar cartões à Carteira do Google.