Pular para o conteúdo principal
Didit levanta US$ 7,5 milhões para construir a infraestrutura para identidade e fraude
Didit
Voltar para o blog
Blog · 20 de novembro de 2026

Aceite o Google Wallet ID no seu fluxo de onboarding: guia de integração

Como aceitar o Google Wallet ID com a Didit: sandbox primeiro, Registro no Google uma vez, fluxo hospedado ou API avulsa, apps Android, fallback para documento e leitura do resultado verificado.

Por DiditAtualizado
accept-google-wallet-id-integration-cover.png

Em resumo

Para aceitar o Google Wallet ID em seu fluxo de onboarding, desenvolva primeiro no sandbox, registre cada aplicação de produção no Google uma única vez pelo console da Didit e, em seguida, ative o Google Wallet para um país em um fluxo de trabalho ou chame a API independente a partir de sua própria página ou aplicativo Android.

  • Fluxo hospedado: ative o Google Wallet na etapa de Verificação de Identidade e mantenha a captura de documentos como fallback.
  • API independente: comece pelo seu backend, solicite à carteira no mesmo clique e envie a resposta da carteira uma única vez.
  • Considere como prova de identidade apenas um resultado concluído e verificado lido a partir do seu backend.

Última revisão: 20 de novembro de 2026 · Não constitui assessoria jurídica

Este guia é voltado para o desenvolvedor que escreve a integração e o gerente de produto que a inclui no cadastro. Ele aborda as duas formas de aceitar o Google Wallet ID com a Didit: o fluxo hospedado e a API independente. Para saber o que foi lançado e por que isso é importante, leia Verificação do Google Wallet ID. Para conhecer o padrão de navegador subjacente, leia nosso guia sobre a Digital Credentials API.

A pessoa compartilha um passe de identificação criado a partir de um passaporte ou, nos Estados Unidos, uma carteira de habilitação digital de um estado compatível, a partir do Google Wallet ou de outra carteira Android compatível. A Didit o aceita em cinco países: Estados Unidos, Reino Unido, Brasil, Singapura e Taiwan.[1]

Duas formas de aceitar o Google Wallet ID

Ambas retornam os mesmos atributos verificados e o mesmo veredito signature_valid.[1]

Mais rápido de implementar

Fluxo hospedado (Sessions API)

  • A Didit exibe "Verificar com identidade digital" somente onde o navegador e o dispositivo oferecem suporte
  • As regras do fluxo de trabalho e o fallback para documento são executados na mesma sessão
  • Incorpore com o Web SDK ou com um iframe

A Didit gerencia as telas

Controle total

API independente

  • Sua página ou aplicativo Android solicita diretamente à carteira
  • Sem fluxo de trabalho, sem workflow_id, sem return_url
  • Você cria o botão, a nova tentativa e qualquer fallback

Sua interface de usuário gerencia as telas

O fluxo hospedado já vem com o fallback para documento configurado. Um aplicativo Android nativo ou uma tela de cadastro personalizada direciona para a API independente.

Antes de começar

Defina estes pontos antes de escrever código.

  • Crie uma aplicação de sandbox: ela não exige registro no Google e não consome créditos.[2]
  • Anote a origem HTTPS que fará a solicitação à carteira, como https://app.example.com.
  • Registre o host dessa origem como um hostname de retorno da sua aplicação ou use seu domínio white-label.[2]
  • Mantenha a chave de API no seu backend: cada chamada da Didit contém x-api-key e é realizada no servidor.

A carteira recusa solicitações feitas a partir de qualquer origem diferente daquela com a qual você iniciou, portanto a origem não é um detalhe para corrigir depois.[2] A Didit aceita o Google Wallet em cinco países.

PaísValor da APICredenciais que as pessoas podem compartilhar
Estados UnidosUSAPasse de identificação a partir de um passaporte, carteira de habilitação digital de estados dos EUA compatíveis
Reino UnidoGBRPasse de identificação a partir de um passaporte
BrasilBRAPasse de identificação a partir de um passaporte
SingapuraSGPPasse de identificação a partir de um passaporte
TaiwanTWNPasse de identificação a partir de um passaporte

Países e valores da API para o Google Wallet na Didit.[1][2]

Opção 1: o fluxo hospedado

No fluxo hospedado, o Google Wallet é mais um método na etapa de Verificação de Identidade de um fluxo de trabalho. No console, abra o fluxo de trabalho, vá para Verificação de Identidade, selecione um país compatível e ative o Google Wallet entre as carteiras aceitas. Pela API, trata-se de um bloco wallet por país:

{"USA": {"document": {"enabled": true}, "wallet": {"enabled": true, "providers": ["google_wallet"], "on_failure": "fallback_to_document"}}}

wallet.providers é uma lista de permissões, não uma classificação: a pessoa escolhe entre o que você aceitou.[1] wallet.on_failure decide o que acontece quando a etapa da carteira não termina em um resultado verificado.

1Criar uma sessão

Seu backend chama a API Sessions com o fluxo de trabalho.

2A Didit verifica o navegador

O método é oferecido apenas onde o navegador e o dispositivo podem solicitar uma carteira.

A pessoa compartilha uma identidade digital

Sim

Verificado

Os atributos assinados chegam à sessão.

Não

Seguir on_failure

Captura de documentos ou uma Verificação de Identidade recusada.

3Ler a decisão

Webhook ou resultado da sessão, no seu backend.

O fluxo hospedado com o Google Wallet como o primeiro método.

Incorporação do fluxo hospedado em um iframe

Se o fluxo hospedado abrir dentro da sua própria página, o navegador deve ter permissão para solicitar uma carteira de dentro do frame. Use o Web SDK 0.5.1 ou posterior, ou adicione digital-credentials-get ao atributo allow do iframe.[1][5]

Atenção

Sem digital-credentials-get, o navegador recusa a solicitação à carteira dentro do iframe.

O que o fluxo hospedado mostra aos seus usuários

Não há redirecionamento. A pessoa confirma na própria solicitação de carteira do navegador ou do Android, que exibe o nome e o logotipo da sua empresa. Em um navegador para desktop, o navegador gera seu próprio código QR para que a pessoa possa responder a partir da carteira no celular.[1][2] O botão diz "Verificar com identidade digital", porque qualquer carteira Android compatível pode responder, e exibe um ícone genérico de carteira.

Etapa 1

Na etapa de identificação, a pessoa escolhe a opção rotulada como "Verificar com identidade digital".

1A pessoa escolhe a opção de identidade digital.

Etapa 2

O navegador ou o Android abre sua própria solicitação de carteira com o nome e o logotipo da sua empresa, e a pessoa aprova o compartilhamento no celular.

2A solicitação da carteira pertence ao navegador ou ao Android.

Etapa 3

Se a pessoa fechar a solicitação, a página exibe "Sua carteira não concluiu" e oferece "Tentar novamente" ou "Digitalizar seu documento em vez disso".

3Uma solicitação cancelada leva a uma nova tentativa ou à digitalização do documento.

As etapas em texto. Um esquema, não uma imagem de uma tela real; os rótulos entre aspas são o texto do próprio fluxo hospedado.

Opção 2: a API independente, passo a passo

Com a API independente, sua página ou aplicativo Android solicita a carteira diretamente, por meio da W3C Digital Credentials API.[7] Não há página hospedada pela Didit nem código QR da Didit.[2]

Carteira Sua página Seu backend Didit
1Solicitar início
2Iniciar com origem
3Solicitação à carteira
4Solicitação para a página
5Solicitar no mesmo clique

A pessoa toca em Compartilhar

6Protocolo e dados
7Resposta da carteira
8Enviar uma única vez
9Verificação decidida

A solicitação independente ao Google Wallet. A chave de API nunca sai do seu backend.

Etapa 1: comece com a sua origem

Seu backend chama POST /v3/id-verification/wallets/google-wallet/ com x-api-key, uma Idempotency-Key e um corpo JSON contendo country e origin. Você pode adicionar vendor_data (a referência do seu cliente, até 2.000 bytes em UTF-8) e metadata.[2][3]

{"country": "USA", "origin": "https://app.example.com", "vendor_data": "your-customer-reference"}

A resposta contém um request_id, wallet_verification.interaction = "digital_credentials" e next_action.type = "request_digital_credential". Passe next_action.digital_credentials.request para a página.

Etapa 2: consulte a carteira dentro de um gesto do usuário

Chame navigator.credentials.get({digital: request}) a partir do manipulador de clique do seu botão "Verificar com identidade digital", na origem com a qual você iniciou. A chamada precisa ser executada em um gesto do usuário, portanto não coloque uma etapa assíncrona entre o clique e a chamada: busque a solicitação antes do clique.[2] Exiba o botão apenas onde o navegador puder fazer isso, por exemplo, quando "DigitalCredential" in window for verdadeiro.

Observação

Uma solicitação cancelada é rejeitada com NotAllowedError ou AbortError; NotSupportedError significa que este navegador não pode consultar uma carteira. Direcione o cancelamento para uma nova tentativa e para o fluxo de documentos; onde o navegador não puder consultar uma carteira, oculte a opção.[2]

Etapa 3: envie a resposta da carteira

Envie o que a carteira retornou, {protocol, data}, para o seu backend. De lá, chame POST /v3/id-verification/wallets/verifications/{request_id}/response/ com o corpo {"response": {...}}. Envie uma única vez: um segundo envio retorna a verificação que já foi decidida.[2][4]

Por trás dessa chamada, a Didit verifica a assinatura do emissor em relação às raízes confiáveis de emissores, cada valor retornado em relação ao seu resumo assinado e a assinatura do dispositivo sobre a sua origem e esta solicitação.[4]

Aplicativos Android

Um aplicativo Android nativo usa o Jetpack Credential Manager com a mesma solicitação.[2][8] Crie um GetDigitalCredentialOption a partir de next_action.digital_credentials.request, chame getCredential e envie o credentialJson retornado ao seu backend como o corpo da solicitação, no campo response.[2]

A origem é diferente. Em vez de uma origem HTTPS, envie android:apk-key-hash: seguido pelo SHA-256 em base64 do certificado de assinatura do seu aplicativo, sem preenchimento.[2]

ErroOndeO que fazer
origin_invalidInício, 400Envie uma origem HTTPS ou uma origem de aplicativo Android
origin_not_allowedInício, 400Registre o host como um hostname de retorno
not_a_digital_credentials_walletEnvio, 409Esta verificação não aceita uma resposta de carteira

Os três erros a serem tratados na integração independente.[2]

Tratamento do resultado e webhooks

A resposta do envio é a verificação decidida. Você também pode lê-la com GET /v3/id-verification/wallets/verifications/{request_id}/ ou recebê-la no webhook status.updated com webhook_version: "v3". O session_id do webhook corresponde ao request_id, e uma identidade de carteira aparece com verification_method: "wallet".[2] Verifique a assinatura do webhook e torne o manipulador idempotente: entregas com falha passam por nova tentativa.

CampoO que indica
full_name, date_of_birthCampos de identidade normalizados no resultado da verificação de identidade
wallet_verification.attributesdocument_number, document_expiry_date e as demais declarações compartilhadas
signature_validO veredito da Didit sobre a asserção assinada, que é verificada internamente pela Didit e não é retornada
assurancecryptographic: a evidência é uma credencial assinada
Nível de garantiaSubstancial
portraitnull: o Google Wallet não compartilha uma foto de rosto, portanto não há correspondência facial com ela

O que uma verificação concluída do Google Wallet retorna. A nacionalidade é retornada apenas para um passe de identificação.[1]

Uma credencial que falha não é uma resposta de erro. É uma verificação decidida com o resultado failed.[2] No fluxo hospedado, os mesmos resultados acionam wallet.on_failure.

ResultadoSignificadoCobrado
verifiedA pessoa compartilhou o ID e os atributos assinados foram validadosSim
cancelledA pessoa desistiu da solicitação na carteiraNão
timeoutA janela de login expirou (10 minutos por padrão para carteiras)Não
failedO login não foi concluído ou a asserção não foi validadaNão

Resultados da carteira e faturamento.[1]

Atenção

Um retorno do navegador ou um valor enviado pela sua própria página não é prova de identidade. Aprove a conta apenas com base em um resultado verified concluído que seu backend leu da Didit, via API ou por um webhook assinado.[2]

Configurando o fallback para documento

Nem toda pessoa possui uma identidade digital, e nem todo navegador consegue solicitar uma carteira. O fluxo hospedado oculta o método onde o navegador não pode fazer a solicitação e mantém a captura de documentos.[1] Com on_failure definido como fallback_to_document, uma tentativa cancelada, expirada ou com falha na carteira envia a pessoa para a captura de documentos na mesma sessão. Com decline, a sessão termina com uma Verificação de Identidade recusada. Se a captura de documentos estiver desativada para esse país, fallback_to_document também recusa, porque não há para onde recorrer.[1]

Didit hosted flow, document capture fallback

A etapa de captura de documentos que a pessoa acessa após "Digitalizar seu documento em vez disso".

Na API independente, esta etapa é sua: ofereça uma verificação de documento quando o resultado não for verified.

Testando no sandbox

Uma aplicação de sandbox executa as mesmas etapas da produção com uma carteira simulada. As respostas contêm simulated: true, qualquer resposta enviada decide a verificação e nenhum crédito é cobrado. Uma aprovação simulada é um dado de exemplo, não uma identidade verificada.[2]

sandbox_scenarioO que testa
wallet_cancelledSua nova tentativa e fallback quando a pessoa desiste
wallet_timeoutUma solicitação expirada
wallet_provider_errorUma carteira que não conclui

Cenários de sandbox. Aplicações em produção rejeitam sandbox_scenario.[2]

Entrando em produção: Registrar no Google

Cada aplicação de produção é registrada no Google uma vez. O console exibe "Funciona em sandbox agora. Registre-se no Google antes de entrar em produção." em uma aplicação de sandbox. Até que uma aplicação de produção seja registrada, salvar um fluxo de trabalho que ativa o Google Wallet é recusado com "Registre esta aplicação no Google antes de habilitar o Google Wallet."[1]

1Abra a etapa de Verificação de Identidade

No console, localize a linha do Google Wallet de um país compatível.

2Escolha Registrar no Google

A caixa de diálogo "Registrar no Google Wallet" é aberta. Apenas um Administrador pode enviá-la.

3Preencha cinco campos

Razão social, o nome exibido no Google Wallet, um logotipo quadrado, a URL da política de privacidade e a finalidade.

4Registrado

O indicador muda de Precisa de registro para Em registro e para Registrado.

A configuração única leva cerca de um minuto; o console informa que geralmente fica pronta em poucos minutos.[1]

A caixa de diálogo explica a etapa em uma linha: "A Didit registra sua empresa no Google como sua verificadora. O Google precisa disso uma vez antes que seus usuários possam compartilhar o Google Wallet ID com você." O nome exibido no Google Wallet aceita até 64 caracteres; o logotipo é um PNG ou JPG quadrado de pelo menos 256 x 256 px. A caixa de diálogo também exibe uma prévia do que as pessoas compartilharão.

Como a Didit ajuda você a aceitar o Google Wallet ID

A Didit executa a solicitação à carteira, o registro no Google, as verificações e o fallback por trás de uma única API, ao lado das outras carteiras de identidade digital que ela suporta. A verificação do Google Wallet ID custa US$ 0,20 por verificação concluída no preço de tabela. Tentativas de login canceladas, expiradas, recusadas ou incompletas não são cobradas, e o fallback para documento é uma verificação separada cobrada pela tabela de verificação de documentos (preços).[6] No console: Fluxos de trabalho, Verificação de Identidade, Países, Carteiras aceitas.

A Didit fornece

  • A solicitação assinada à carteira e o registro no Google
  • Verificações de emissor, resumo e assinatura do dispositivo
  • O fluxo hospedado, o sandbox e o fallback para documento
  • A verificação decidida por API e webhook

Fica com você

  • Suas origens, hostnames de retorno e chave de API
  • O botão, a nova tentativa e os textos na sua própria interface
  • Quais países e resultados você aceita
  • A decisão de onboarding e sua política de conformidade

Adicione o Google Wallet ao seu cadastro

Desenvolva no sandbox hoje, registre-se no Google uma vez e pague apenas pelas verificações concluídas.

Comece grátisFale conoscoLeia a documentação

Principais conclusões

  • O sandbox não exige registro; cada aplicação de produção é registrada no Google uma vez, pelo console.
  • O fluxo hospedado oferece "Verificar com identidade digital" apenas onde funciona e mantém a captura de documentos como fallback.
  • Em um iframe, permita digital-credentials-get ou use o Web SDK 0.5.1 ou posterior.
  • Apenas um resultado verified concluído e lido do seu backend é prova de identidade.

Perguntas frequentes

Preciso de um fluxo de trabalho para usar o Google Wallet?

Não. A API independente não precisa de fluxo de trabalho nem de workflow_id. O fluxo hospedado usa um fluxo de trabalho, no qual o Google Wallet é ativado por país.

Qual origem envio para um aplicativo Android?

Envie android:apk-key-hash: seguido pelo SHA-256 em base64 do certificado de assinatura do seu aplicativo, sem preenchimento. Um site envia a origem HTTPS de sua página.

Por que a solicitação à carteira falha dentro do meu iframe?

O navegador recusa a solicitação, a menos que o iframe a permita. Adicione digital-credentials-get ao atributo allow do iframe ou use o Web SDK 0.5.1 ou posterior.

Posso enviar a resposta da carteira duas vezes?

A resposta é enviada uma única vez. Um segundo envio retorna a verificação já decidida.

Como uma credencial com falha aparece na API?

É uma verificação decidida com o resultado failed, não uma resposta de erro. No fluxo hospedado, ela segue wallet.on_failure.

Como testo sem um Google Wallet ID real?

Use uma aplicação de sandbox. Ela simula os mesmos passos, retorna simulated: true, não cobra créditos e sandbox_scenario testa falhas.

Como os webhooks identificam uma verificação por carteira?

O session_id do webhook status.updated corresponde ao request_id da API da carteira, e a identidade da carteira traz verification_method: "wallet". Use webhook_version: "v3" e verifique a assinatura.

O que acontece se a origem da minha página diferir daquela com a qual iniciei?

A carteira recusa a solicitação. Inicie a verificação com a origem exata que fará a solicitação à carteira e registre o host dela como um hostname de retorno da sua aplicação.

Fontes

  1. Carteiras de identidade digital: Google Wallet, falha e fallback, preços, documentação da Didit, acessado em 20 de novembro de 2026.
  2. APIs de carteiras de identidade digital: carteiras de Digital Credentials (Google Wallet), webhooks, sandbox, documentação da Didit, acessado em 20 de novembro de 2026.
  3. Referência da API: Google Wallet, documentação da Didit, acessado em 20 de novembro de 2026.
  4. Enviar uma resposta de carteira de identidade digital, documentação da Didit, acessado em 20 de novembro de 2026.
  5. Integração de iframe em contexto, documentação da Didit, acessado em 20 de novembro de 2026.
  6. Preços, documentação da Didit, acessado em 20 de novembro de 2026.
  7. Digital Credentials API: identidade segura e privada na web, Chrome for Developers, 3 de outubro de 2025.
  8. Verificar credenciais digitais, Android Developers.

Os mesmos padrões se aplicam também à verificação de eID. Para ver todas as carteiras que você pode aceitar, comece pelas carteiras de identidade digital na Didit.

Aceite o Google Wallet ID com a Didit

Ative a opção "Verificar com identidade digital" em um fluxo de trabalho ou chame a API da carteira a partir da sua própria página.

Comece grátisFale conosco

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitoramento de Transações e Análise de Carteiras. Integre em 5 minutos.

Peça para uma IA resumir esta página