Pré-requisitos

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 da Carteira do Google. Inscreva-se no Console do Google Pay e da Carteira para conseguir sua conta de emissor. Depois, acesse a página da API Google Wallet e clique em Criar seu primeiro cartão. Aceite os Termos de Serviço para criar uma classe de cartão.

Depois de concluir 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. Criar uma conta de serviço

Uma conta de serviço e uma chave da 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 fazer autenticação na API Google Wallet.

Observação: a chave da conta de serviço é altamente confidencial, portanto, mantenha essa informação em segurança. Caso contrário, terceiros podem usar a chave para fazer chamadas de API em seu nome. Se a chave da conta de serviço for comprometida, ela precisa ser revogada imediatamente. Gere uma nova e atualize o aplicativo para começar a usar.

Criar 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 a 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. Selecione 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. Clique em Convidar.

5. Criar uma classe

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

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

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, use a 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.