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.
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: my-service-account@my-project-id.iam.gserviceaccount.com.
- 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: my-service-account@my-project-id.iam.gserviceaccount.com.
- 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.
- Verifique se você está na guia Gerenciar
- A mensagem "Você está no modo de demonstração" vai aparecer se for a primeira vez que você cria um cartão.
- 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.
- Clique em Criar uma classe
- Escolha Vale-presente.
- Preencha todos os campos obrigatórios marcados com *
- 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.
Depois de criar uma classe de vale-presente, acesse Adicionar cartões à Carteira do Google.