Como gerar credenciais de autenticação da API REST da Carteira do Google
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A Carteira do Google oferece uma API REST que permite criar e gerenciar cartões
enviar solicitações para a API Google Wallet por HTTP. Isso é útil para quem
quer criar serviços do lado do servidor
para trabalhar com cartões de forma programática.
Para usar a API REST da Carteira do Google, ative-a no console do Google Cloud.
criar uma conta de serviço do Google Cloud e gerar uma chave para ela.
Quando você cria cartões com a API REST, a chave da conta de serviço usada para assinar
Objetos de cartões JSON codificados por token da Web.
Para outras operações, como atualização ou exclusão de cartões, a chave da conta de serviço
é enviado com a solicitação para autenticar você como o emissor do cartão.
1. Ativar a API REST da Carteira do Google
Para ativar a API REST da Carteira do Google, faça o seguinte:
- Se você ainda não tiver uma conta do Google Cloud, acesse o console do Google Cloud.
e siga as etapas para criar uma nova conta.
- No menu suspenso do projeto na parte superior do console, selecione a
do Google Cloud que você quer usar ou crie um novo.
- Acesse a página de detalhes do produto da API Google Wallet.
no Marketplace do console do Google Cloud.
- Clique no botão "Ativar" . Em alguns instantes, a API REST da Google Wallet será
disponíveis 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ê precisa criar uma
conta de serviço e gere uma chave para ela da seguinte forma:
- Acesse Criar conta de serviço página
no console do Google Cloud.
- Preencha os detalhes da conta de serviço. Anote o endereço de e-mail do serviço.
que aparece abaixo de "ID da conta de serviço" . Você vai precisar disso mais tarde
quando você usa a conta de serviço para autenticar suas solicitações na Carteira do Google.
API REST.
- Clique em "CONCLUÍDO". . Não é necessário concluir a outra conta de serviço
etapas de criação.
- Clique em "CHAVES" item de menu na parte superior da página.
- Clique em "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 conta de serviço
chave, adicione o endereço de e-mail da sua conta de serviço como um usuário ao seu
Conta do emissor. Para adicionar sua 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 para a API Google Wallet.
- Acesse a página do Google Pay e Console da Carteira.
- No painel de 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 campo "Nível de acesso" selecione "Desenvolvedor".
- Clique no botão "Convidar" .
Depois que a conta de serviço for adicionada, será possível usar as chaves de conta de serviço geradas
para autenticar solicitações para a API REST da Carteira do Google. Ao usar o serviço
chaves de conta, lembre-se de que são credenciais altamente confidenciais que
só devem ser usadas em ambientes seguros do lado do servidor.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eGoogle Wallet's REST API enables programmatic management of passes through HTTP requests, ideal for server-side integrations.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize the API, you must enable it in the Google Cloud console, create a service account, and generate a key for authentication.\u003c/p\u003e\n"],["\u003cp\u003eThis service account key is crucial for signing Pass Objects during creation and authenticating other pass operations like updates and deletions.\u003c/p\u003e\n"],["\u003cp\u003eYou must add your service account email as a user in the Google Pay & Wallet console to grant API access.\u003c/p\u003e\n"]]],["The Google Wallet REST API allows programmatic pass management via HTTP requests. To use it, enable the API in the Google Cloud console, create a service account, and generate a JSON key. This key is used to sign JSON Web Token-encoded Pass Objects for creation and authenticates requests for updates or deletions. Finally, authorize the service account by adding its email as a 'Developer' user in the Google Pay & Wallet console. This process enables secure, server-side interaction with the Google Wallet.\n"],null,["# Generating Google Wallet REST API authentication credentials\n\nGoogle Wallet offers a REST API that lets you create and manage passes by\nsending requests to the Google Wallet API over HTTP. This is useful for those who\nwant to build server-side services to work with passes programmatically.\n\nTo use the Google Wallet REST API, you must enable the API in the Google Cloud console,\ncreate a Google Cloud service account, then generate a key for the service account.\n\nWhen you create passes with the REST API, the service account key used to sign your\nJSON Web Token-encoded Passes Objects.\n\nFor other operations, such as updating or deleting passes, the service account key\nis sent with the request to authenticate you as the Pass Issuer.\n\n1. Enable the Google Wallet REST API\n------------------------------------\n\nTo enable the Google Wallet REST API, do the following:\n\n1. If you don't already have a Google Cloud account, go to the [Google Cloud console](https://console.cloud.google.com) and follow the steps to register for a new account.\n2. From the project drop-down menu at the top of the console, select the Google Cloud project you want to use, or create a new one.\n3. Go to the [Google Wallet API product details page](https://console.cloud.google.com/apis/library/walletobjects.googleapis.com) in the Google Cloud console Marketplace.\n4. Click the 'Enable' button. In a few moments, the Google Wallet REST API will be available for the selected Google Cloud project.\n\n2. Generate a Google Cloud service account key\n----------------------------------------------\n\nTo authenticate requests to the Google Wallet REST API, you'll need to create a\nservice account, and generate a service account key by doing the following:\n\n1. Go to the ['Create service account' page](https://console.cloud.google.com/iam-admin/serviceaccounts/create) in the Google Cloud console.\n2. Fill in the service account details. Note the email address for the service account that appears below the 'Service account ID' field. You will need this later when you use the service account to authenticate your requests to the Google Wallet REST API.\n3. Click the 'DONE' button. There is no need to complete the other service account creation steps.\n4. Click the 'KEYS' menu item at the top of the page.\n5. Click the 'ADD KEY' drop-down menu, then click 'Create new key'.\n6. Select key type 'JSON'.\n7. Click 'CREATE' to create and download the service account key.\n\n3. Authorize your service account in the Google Wallet console\n--------------------------------------------------------------\n\nTo authenticate your requests to the Google Wallet REST API using a service account\nkey, you must add the email address of your service account as a user to your\nIssuer account. To add your service account as a user, do the following:\n\n1. Go to the ['Service accounts'](https://console.cloud.google.com/iam-admin/serviceaccounts) page in the Google Cloud console.\n2. Copy the email address of the service account you want to use to authenticate your requests to the Google Wallet API.\n3. Go to the [Google Pay \\& Wallet console](https://pay.google.com/business/console/).\n4. In the left nav, click 'Users'.\n5. Click 'Invite a user'.\n6. Input the email address of your service account.\n7. In the 'Access level' drop-down, select 'Developer'.\n8. Click the 'Invite' button.\n\nOnce your service account is added, you can use any service account keys generated\nfor it to authenticate requests to the Google Wallet REST API. When using service\naccount keys, keep in mind that these are highly sensitive credentials that\nshould only be used in secure, server-side environments."]]
