Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para provisionar uma nova chave de multifamília, o usuário precisa concluir um fluxo de autenticação e associação no dispositivo. Isso vincula a conta externa
do usuário a uma conta da Carteira do Google.
Este documento descreve esse processo de forma geral em diferentes plataformas.
Adicionar à Carteira do Google usando um app Android
Nesta seção, descrevemos o fluxo para salvar um cartão na
Carteira do Google usando o app Android de um provedor de serviços.
Fluxo de usuário
As imagens mostram o fluxo do usuário para provisionar uma chave multifamiliar
com a Carteira do Google.
Figura 1: o usuário começa a provisionar o cartão e aceita os
Termos de Serviço.
Uma animação de conexão é exibida para o usuário durante a configuração
da conectividade de rede e dos serviços iniciais.
Depois disso, o usuário aceita os Termos de Serviço e
continua o fluxo.
Figura 2: provisionamento de usuários concluído.
Uma animação de salvamento é mostrada ao usuário enquanto os serviços em segundo plano
provisionam a conta no dispositivo.
Após a conclusão dos serviços, uma tela de êxito é mostrada.
Se o dispositivo ainda não tiver o app Carteira do Google, o usuário poderá receber nas próximas telas a instrução de fazer o download do
app.
Pontos principais
Se o cartão já estiver salvo na Conta do Google selecionada, o
usuário vai receber um link para abrir o cartão no app Carteira do Google,
onde pode ver os detalhes do cartão.
Se o cartão estiver salvo em uma Conta do Google diferente da que o
usuário está conectado, ele vai receber uma mensagem indicando que esse cartão já está salvo em outra Conta
do Google.
Se o usuário tentar adicionar um cartão e não tiver uma Conta do Google, será
exibida uma instrução para criar uma conta. Após a criação da Conta do Google,
o fluxo continua normalmente.
Os apps com suporte para fluxos de chaves multifamiliares precisam se integrar às APIs do Google
Play Services. No entanto, as chamadas de método do app do provedor de serviços para o Google Play Services não estão disponíveis na versão
distribuída publicamente do
Google Play Services.
O desenvolvedor do app do provedor de serviços precisa adicionar e ter acesso aos módulos
personalizados para chamar determinados métodos. Entre em contato com seu provedor de serviços para
receber mais informações.
Adicionar à Carteira do Google em um dispositivo wearable usando um app Android
Os usuários podem fazer o provisionamento para wearables iniciando o fluxo no
smartphone e selecionando um único wearable, conforme mostrado nesta figura:
Figura 1: fluxo de provisionamento de dispositivos wearable.
Pontos principais
Para provisionar um wearable, é necessário um smartphone capaz de provisionar um
cartão.
Os usuários podem provisionar o smartphone e o wearable em um único fluxo ou reiniciar o fluxo para adicionar o wearable depois que o primeiro provisionamento do smartphone for concluído.
Os usuários devem ser limitados pelo provedor de serviços a provisionar apenas um
dispositivo wearable.
Pergunte ao seu provedor de serviços sobre a disponibilidade do provisionamento de dispositivos wearable.
Os apps com suporte para fluxos de chaves multifamiliares precisam se integrar às APIs do Google
Play Services. No entanto, as chamadas de método do app do provedor de serviços para o Google Play Services não estão disponíveis na versão
distribuída publicamente do
Google Play Services.
O desenvolvedor do app do provedor de serviços precisa adicionar e ter acesso aos módulos
personalizados para chamar determinados métodos. Entre em contato com seu provedor de serviços para
receber mais informações.
Adicionar à Carteira do Google usando um site
Nesta seção, descrevemos o fluxo para salvar um cartão na Carteira do Google usando o site
de um emissor.
Etapa 1: fazer login no site
A primeira etapa do fluxo é fazer login no site do emissor e selecionar o botão "Adicionar à Carteira do Google".
Figura 3: um usuário faz login em um site e navega até o botão
Adicionar à Carteira do Google.
Etapa 2: fazer login com o Google
O usuário conclui o login com o Google e vê uma tela de carregamento
no site do emissor antes de ser redirecionado para a Carteira do Google na próxima
etapa.
Figura 3: um usuário escolhe uma Conta do Google para vincular à
chave multifamiliar.
Etapa 3: concluir o provisionamento
O usuário conclui o fluxo de provisionamento na Carteira do Google.
Figura 3: o usuário continua o provisionamento, aceita os Termos de
Serviço e conclui o fluxo.
[null,null,["Última atualização 2025-07-11 UTC."],[],[],null,["# Provision a new card\n\nTo provision a new Multi-family Key, the user must complete an authentication\nand association flow on their device. This links their external\nuser account to a Google Wallet account.\nThis document describes that process at a high level across different surfaces.\n\nAdd to Google Wallet from an Android app\n----------------------------------------\n\nIn this section, we describe the flow to save a card to\nGoogle Wallet from a Service Provider's Android app.\n\n### User flow\n\nThese figures illustrate the user flow to provision a Multi-family Key from a\nGoogle Wallet perspective.\n| **Note:** Before this flow begins, the user must authenticate within the Service Provider's app. Next, they must select the [Add to Google Wallet](/wallet/access/multi-family-key/get-started/brand-guidelines#add-to-google-wallet-button) button. If the user doesn't have a Google Account, they complete a flow to create one and then continue the flow to provision their card.\n**Figure 1**: A user begins to provision their card and accepts the Terms of Service.\n\n\n- A spinning connection animation is shown to the user while network connectivity and initial services configure.\n- After this completes, the user accepts the Terms of Service and continues with the flow.\n\n\u003cbr /\u003e\n\n**Figure 2**: User provisioning completes.\n\n\n- A spinning save animation is shown to the user while background services provision the account on the device.\n- After the services complete, a success screen appears.\n- The user might be prompted in subsequent screens to download the Google Wallet app, if it doesn't already exist on their device.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n### Key points\n\n- If the card is already saved to the selected Google Account, the user is instead shown a link to open the card in the Google Wallet app, where they can view card details.\n- If the card is saved to a Google Account other than the one the user is logged into, the user receives a message that indicates another Google Account has already saved that card.\n- If the user attempts to add a card and doesn't have a Google Account, a prompt to create an account appears. After creation of the Google Account, the flow continues normally.\n- Apps that support Multi-family Keys flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet on a Wearable from an Android app\n------------------------------------------------------\n\nUsers can provision to their Wearables by initiating the provisioning flow on\ntheir phone and selecting a single Wearable, as seen in this figure:\n**Figure 1**: Wearable provisioning flow.\n\n### Key points\n\n- Provisioning to a Wearable requires a phone capable of provisioning a card.\n- Users can provision to their phone and Wearable in a single flow, or they can restart the flow to add it to a Wearable after the first provisioning to their phone is complete.\n- Users should be limited by the Service Provider to provisioning only a single Wearable.\n- Inquire with your Service Provider about the availability of Wearable provisioning.\n- Apps that support Multi-family Keys flows need to integrate with Google Play services APIs. However, the method calls from the Service Provider app to Google Play services aren't available in the publicly distributed version of [Google Play services](https://developers.google.com/android/guides/overview). The Service Provider app developer must add and get access to custom modules to call certain methods. Check with your Service Provider for more information.\n\nAdd to Google Wallet from a Website\n-----------------------------------\n\nThis section describes the flow to save a card to Google Wallet from\nan issuer's website.\n\n### Step 1: Sign in to Website\n\nThe first step in the flow is to sign in to the issuer's website and select\nthe Add to Google Wallet button.\n**Figure 3**: A user logs into a website and navigates to the Add to Google Wallet button. **Important:** Google requires that your website authenticates users before you show the Add to Google Wallet button. Sending the user an email with a \"secret\" link is not sufficient authentication.\n\n### Step 2: Sign in with Google\n\nThe user completes Sign in with Google and then sees a loading screen\non the issuer's website before being redirected to Google Wallet in the next\nstep.\n**Figure 3**: A user chooses a Google Account to link to their Multi-family Key. **Note:** You can download this [loading gif](/static/wallet/access/images/web-provisioning-loading.gif) for use on your website's loading page if you would like to match the Google Wallet loading screen.\n\n### Step 3: Complete Provisioning\n\nThe user completes the provisioning flow within Google Wallet.\n**Figure 3**: A user continues with provisioning, accepts terms of service, and completes the flow."]]
