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

Digital Credentials API explicada: como sites acessam carteiras de ID

A Digital Credentials API do W3C para empresas: como um site pede um ID à carteira sem redirecionamento, suporte de navegadores em 2026, QR entre aparelhos, privacidade, iframes e como a Didit a usa no Google Wallet.

Por DiditAtualizado
digital-credentials-api-cover.png

Em resumo

A Digital Credentials API é uma API de navegador do W3C que permite que um site solicite dados de identidade a uma carteira digital com uma única chamada: navigator.credentials.get() com um membro digital. O navegador e o sistema operacional exibem o aviso da carteira, e a carteira retorna uma resposta assinada e criptografada.[1][2]

  • O Chrome a habilita por padrão a partir da versão 141, conforme anunciado pelo Google em 3 de outubro de 2025; o Safari 26 oferece suporte para solicitações ISO mdoc.[2][3]
  • Ela transporta solicitações OpenID4VP ou ISO/IEC 18013-7 Anexo C, sem redirecionamentos e sem a necessidade de um código QR próprio.[1]
  • A Didit a utiliza para aceitar identidades digitais do Google Wallet em cinco países.[8]

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

Durante muito tempo, comprovar quem você é online significou enviar a foto de um documento de identidade e uma selfie. As identidades digitais na carteira de um celular mudam esse cenário, mas um site ainda precisa de uma forma segura de se comunicar com a carteira. A Digital Credentials API é essa ponte.

Este guia explica a API para gerentes de produto e arquitetos: como uma solicitação flui, onde ela funciona hoje, compartilhamento entre dispositivos, privacidade, iframes e como a Didit a utiliza para o Google Wallet. Os detalhes internos do protocolo estão no nosso guia do verificador OpenID4VP e os formatos de credencial em SD-JWT VC vs mdoc.

O que é a Digital Credentials API

A Digital Credentials API é uma especificação do W3C Federated Identity Working Group. Sua versão mais recente é um Working Draft datado de 19 de novembro de 2026, na trilha de Recomendação.[1] A especificação define uma API que permite aos navegadores "mediar a apresentação e a emissão de credenciais digitais, como carteira de habilitação ou documento de identidade emitido pelo governo". Ela se baseia no Credential Management Level 1 e "foi projetada para ser agnóstica a formatos de credenciais".[1]

Na prática, é mais um tipo de credencial para a chamada de navegador que os sites já usam para passkeys. Durante seu teste de origem, a API ficava em navigator.identity.get(); o Chrome a moveu para navigator.credentials.get() quando foi lançada.[2] A API apenas transfere uma solicitação para uma carteira e traz a resposta de volta; o conteúdo pertence aos protocolos subjacentes.

CamadaO que fazExemplos
API do navegadorTransporta a solicitação da página e traz a resposta de voltaW3C Digital Credentials API
Protocolo de apresentaçãoDefine a solicitação e a resposta que a carteira compreendeOpenID4VP 1.0, ISO/IEC 18013-7 Annex C
Formato de credencialA estrutura de dados assinada dentro da respostaISO mdoc, SD-JWT VC
PlataformaLocaliza carteiras que podem responder e exibe o seletorAndroid Credential Manager, iOS
CarteiraArmazena a credencial, solicita autorização ao usuário e assina a respostaGoogle Wallet

As camadas por trás de uma chamada da Digital Credentials API.[1][2][4]

Como funciona o fluxo de uma solicitação da Digital Credentials API

Uma verificação faz um ciclo de ida e volta entre a sua página e a carteira. Seu servidor cria a solicitação, sua página a repassa ao navegador em um clique, e a resposta criptografada retorna ao seu servidor para verificação.[2][6]

Seu servidor Sua página web Navegador e sistema operacional Carteira
1Usuário clica em verificar
2Solicitação assinada
3credentials.get, digital

O navegador adiciona a origem, exibe o seletor

4Solicitação e origem

Usuário revisa e aprova

5Resposta criptografada
6Objeto DigitalCredential
7Encaminha protocolo e dados

Descriptografar, verificar assinaturas

Uma apresentação no mesmo dispositivo por meio da Digital Credentials API, simplificada.[1][2][6]

Cada solicitação indica um protocolo e transmite um objeto data nesse protocolo. Os navegadores precisam oferecer suporte a todos os protocolos de apresentação na tabela da especificação:[1]

IdentificadorProtocoloFormato da solicitação
openid4vp-v1-unsignedOpenID4VP 1.0Solicitação não assinada
openid4vp-v1-signedOpenID4VP 1.0Solicitação assinada
openid4vp-v1-multisignedOpenID4VP 1.0Solicitação assinada por várias partes
org-iso-mdocISO/IEC 18013-7:2025 Anexo CSolicitação ISO mdoc

Protocolos de apresentação no registro do W3C, Working Draft de 19 de novembro de 2026.[1]

Antes de exibir um botão, uma página verifica typeof DigitalCredential e DigitalCredential.userAgentAllowsProtocol().[2][3] A resposta retorna como um objeto DigitalCredential com uma carga útil data criptografada, que a página encaminha para o seu back-end.[2] A sintaxe da solicitação e os modos de resposta são questões de protocolo, abordadas no guia do verificador OpenID4VP.

Por que não há redirecionamento

Antes dessa API, um site acessava uma carteira enviando o usuário para fora: um redirecionamento ou uma URI personalizada entregue a um aplicativo, muitas vezes exibida como um código QR no desktop. A Digital Credentials API mantém o usuário na sua página e retorna a resposta para a mesma aba.[2]

Rota anterior

Redirecionamento ou URI personalizada

  • O usuário sai da sua página para um aplicativo ou uma página hospedada
  • Sua página gera seu próprio código QR no desktop
  • A carteira descobre quem solicita a partir do conteúdo da solicitação
  • Cada carteira precisa do seu próprio formato de link

Específico do esquema

Rota intermediada pelo navegador

Digital Credentials API

  • O usuário permanece na sua página, o navegador exibe o aviso
  • O navegador gera o código QR no desktop
  • O próprio navegador determina a origem solicitante
  • Uma única chamada, qualquer carteira que a plataforma encontrar

W3C Digital Credentials

Como uma página acessa uma carteira, antes e com a API.[1][2]

A diferença mais importante é a origem. A especificação exige que o navegador use "sua própria determinação da origem do documento" e não uma fornecida pela página, de modo que "a parte que é exibida ao usuário" seja aquela que o navegador viu.[1] Uma solicitação OpenID4VP assinada também pode listar as origens esperadas, recurso que o guia do Google estabelece "para evitar ataques de retransmissão".[6] A arquitetura da carteira europeia de identidade digital (EUDI Wallet) faz a mesma observação sobre fluxos de URI personalizada entre dispositivos, como explica o nosso guia da parte confiável.

Suporte de navegadores e plataformas no final de 2026

O suporte depende do navegador, do sistema operacional e do protocolo da solicitação. A tabela reflete fontes públicas consultadas em 20 de novembro de 2026.

Navegador ou plataformaOndeApresentaçãoProtocolosFonte
ChromeAndroid, Windows, macOS, Linux, ChromeOSAtivado por padrão a partir da versão 141 (3 de outubro de 2025)OpenID4VP e Anexo CChrome, W3C CG[2][5]
EdgeAndroid, Windows, macOSA partir da versão 141OpenID4VP e Anexo CW3C CG[5]
SafariiOS 26, iPadOS 26, macOS 26SuportadoApenas Anexo C (org-iso-mdoc)WebKit, W3C CG[3][5]
Outros navegadores do iOSiOS 26Assim como o Safari, rodam no WebKitApenas Anexo CChrome, W3C CG[2][5]
FirefoxmacOSA partir da versão 149Apenas Anexo CW3C CG[5]
FirefoxAndroid, Windows, LinuxEm desenvolvimentoAinda nãoW3C CG[5]
Aplicativos AndroidAndroid 9 (nível de API 28) e posteriorCredential ManagerOpenID4VP para o Google WalletAndroid, Google[4][6]

W3C CG = a tabela de suporte do W3C Web Identity and Credentials Adoption Community Group.[5]

Os usuários também precisam de um dispositivo compatível: Android com Google Play services 24.0 ou posterior, ou iOS 26 ou posterior, além de um aplicativo de carteira com suporte à API.[2] O Google Wallet responde a identidades digitais baseadas em ISO mdoc por meio do OpenID4VP 1.0 no Android 9 e posterior.[6] O WebKit observa que o recurso ainda não funciona dentro do WKWebView, a web view dos aplicativos iOS.[3] Também lista um problema conhecido: uma solicitação que misture OpenID4VP e Anexo C pode deixar o iOS em um carregamento infinito ao ler um código QR exibido pelo Chrome no macOS.[3]

Observação

O suporte muda a cada versão. Detecte o recurso e o protocolo em tempo de execução e mantenha uma rota alternativa para os demais casos.

No mesmo dispositivo e entre dispositivos

Quando a carteira está no mesmo dispositivo, o Android exibe um seletor de credenciais correspondentes. Quando não está, o navegador oferece a opção de continuar em um telefone.[2][7]

1A página chama a API em resposta a um clique

A mesma solicitação em todos os casos.

Uma credencial correspondente está neste dispositivo

Sim

Mesmo dispositivo

O seletor da plataforma lista as credenciais; a carteira abre sobre a página.

Não

Entre dispositivos

O navegador exibe seu próprio código QR; o telefone o escaneia e passa por uma verificação de proximidade via Bluetooth.

2A resposta retorna para a mesma página

Criptografada, por meio do navegador.

Onde o aviso da carteira aparece.[2][6]

O Chrome afirma que a leitura do código QR estabelece "uma conexão segura, criptografada de ponta a ponta e resistente a phishing" entre o computador e o telefone, usando o protocolo CTAP via Bluetooth Low Energy para verificar se o usuário está fisicamente presente e no controle de ambos os dispositivos.[2] O Google acrescenta duas condições para o Google Wallet: o Bluetooth precisa estar ativado para localizar o dispositivo próximo, e o fluxo entre dispositivos está "disponível apenas quando o parceiro tiver implementado Signed Requests".[7]

Sua página nunca desenha um código QR. As restrições vêm das plataformas: o iOS não suporta a apresentação a partir de uma credencial em outro dispositivo, e o Safari no macOS encaminha apenas solicitações Anexo C, de modo que uma solicitação OpenID4VP não consegue alcançar uma carteira Android a partir do Safari.[5]

Privacidade e segurança: o que a API protege

Em vez de uma imagem do documento completo, a carteira retorna apenas os atributos indicados na solicitação, assinados pelo emissor. O Chrome chama esse princípio de "divulgação seletiva": os sites "recebem apenas o mínimo de informações necessárias".[2]

ProteçãoO que significa na práticaFonte
Divulgação seletivaApenas os campos solicitados saem da carteiraChrome[2]
Gesto do usuárioUma solicitação precisa de um clique; sites não podem solicitar de forma silenciosa ou repetidaW3C[1]
Mediação a cada vezO seletor da plataforma pergunta ao usuário a cada solicitaçãoW3C[1]
Origem definida pelo navegadorA página não pode fingir ser outro siteW3C[1]
Resposta criptografadaCriptografada com a sua chave; apenas o seu servidor a descriptografaW3C, Chrome[1][2]
Aprovação para compartilharO Google Wallet solicita biometria, PIN ou padrão de desbloqueio antes de compartilharGoogle[7]

O Google declara que não salva dados relacionados a credenciais em seus servidores.[7] A tela de consentimento pertence à carteira: o Google Wallet exibe o nome, o logotipo e a política de privacidade fornecidos pelo verificador, para que a pessoa veja quem está solicitando antes de compartilhar.[7]

Uma assinatura válida comprova que os dados são autênticos, mas o Chrome lembra aos desenvolvedores que eles "devem verificar se o emissor é adequado e confiável" para o seu caso de uso.[2] O trabalho no lado do servidor para uma resposta mdoc, seguindo o guia do Google:[6]

  • Descriptografe a resposta com a chave correspondente à solicitação.
  • Valide a cadeia de certificados do emissor em relação às raízes de emissores confiáveis.
  • Verifique cada valor retornado em relação ao seu resumo assinado.
  • Verifique a assinatura do dispositivo sobre a sessão, que vincula a sua origem.

Uso da API dentro de um iframe: digital-credentials-get

Muitos fluxos de verificação são executados dentro de um iframe no site do cliente. A especificação contempla esse caso com um recurso controlado por política denominado digital-credentials-get, cuja lista de permissões padrão é 'self'.[1] Uma página de outra origem só pode chamar a API quando a página incorporadora conceder a permissão, por meio do atributo allow do iframe:[1]

<iframe src="https://verifier-service.example.com" allow="digital-credentials-get"></iframe>

Atenção

Sem a permissão, o navegador recusa a solicitação da carteira dentro do iframe, e o usuário nunca vê um aviso. Com o fluxo hospedado da Didit em um iframe, adicione digital-credentials-get ao atributo allow ou use o Web SDK 0.5.1 ou posterior.[10]

Quais carteiras respondem hoje

No Android, o sistema exibe o seletor, e as credenciais mostradas dependem de como cada carteira se registra no Credential Manager e da solicitação.[7] A equipe do Chrome cita o Google Wallet como um dos primeiros adotantes.[2]

Observação

Como outras carteiras podem responder à mesma chamada, o Google recomenda um botão genérico como "Verificar com ID digital" em vez do nome de uma carteira específica.[7]

No iOS, o WebKit afirma que a API alcança o Apple Wallet ou outros aplicativos registrados como Identity Document Provider.[3] Na Europa, a arquitetura da carteira europeia de identidade digital (EUDI Wallet) lista o OpenID4VP e o ISO/IEC 18013-7 sobre a Digital Credentials API como rotas de apresentação remota. A parte de registro desse processo está no guia da parte confiável da EUDI Wallet.

Como a Didit ajuda você a aceitar o Google Wallet por meio da Digital Credentials API

A Didit opera o lado do verificador da Digital Credentials API para o Google Wallet, como um dos métodos do seu produto de carteiras de identidade digital. O Google Wallet está ativo na Didit em produção e no sandbox, para o passe de identificação criado a partir de um passaporte e carteiras de motorista digitais de estados dos EUA compatíveis, nos Estados Unidos, no Reino Unido, no Brasil, em Singapura e em Taiwan.[8] Detalhes do produto: verificação de identidade com Google Wallet. Código: o guia de integração.

  • Fluxo hospedado. As pessoas veem "Verificar com ID digital" e confirmam no aviso do próprio navegador ou do Android, sem redirecionamento. O método aparece apenas onde o navegador pode enviar uma solicitação OpenID4VP assinada; nos demais casos, a verificação por documento continua disponível.[8][9]
  • API independente. A Didit retorna uma solicitação pronta para a sua página enviar a navigator.credentials.get() em resposta a um clique, ou ao Credential Manager no Android; a sequência completa está no guia de integração.[9]
  • Verificações. A Didit verifica a assinatura do emissor em relação às raízes confiáveis de emissores, cada valor em relação ao seu resumo assinado e a assinatura do dispositivo sobre a sua origem e esta solicitação. A resposta é criptografada com a chave da Didit.[9]
  • Resultado. Nome, data de nascimento, número do documento, data de validade, país e autoridade emissora e nacionalidade para um passe de identificação, no nível de garantia Substancial. Nenhuma foto do rosto é compartilhada.[8]

O sandbox não requer registro. Cada aplicativo de produção é registrado uma vez com o Google no console (etapa ID Verification, a linha do Google Wallet de um país compatível, Register with Google), uma configuração única de cerca de um minuto. A própria API verificadora do Google é gratuita; o preço da Didit para executar a verificação é de $0.20 por verificação concluída, e tentativas canceladas, expiradas ou recusadas não são cobradas. Veja os preços.[7][8]

A Didit fornece

  • A solicitação assinada e o registro com o Google
  • A descriptografia e cada verificação de assinatura e de origem
  • A verificação por documento como alternativa na mesma sessão

Fica com você

  • O botão e o gesto do usuário na sua página
  • A permissão do iframe quando você incorpora o fluxo
  • A decisão de onboarding e as suas políticas

Aceite IDs do Google Wallet sem construir um verificador

Ative o Google Wallet em um fluxo de trabalho, teste-o no sandbox e pague apenas por verificações concluídas.

Comece grátisFale conoscoLeia a documentação

Principais conclusões

  • A Digital Credentials API é um W3C Working Draft que encaminha solicitações de carteira por meio de navigator.credentials.get().
  • O Chrome e o Edge oferecem suporte a OpenID4VP e ao Anexo C; o Safari oferece suporte apenas ao Anexo C.
  • O navegador define a origem e gera o código QR entre dispositivos.
  • Dentro de um iframe, a página que o incorpora deve conceder digital-credentials-get.
  • A Didit a utiliza para IDs do Google Wallet em cinco países, com alternativa por documento.

Perguntas frequentes

O que é a Digital Credentials API?

Uma API de navegador do W3C que permite a um site solicitar uma credencial digital, como um documento de identidade emitido pelo governo, de uma carteira por meio de navigator.credentials.get(). O navegador e o sistema operacional exibem a solicitação da carteira.[1][2]

Quais navegadores são compatíveis com a Digital Credentials API?

O Chrome a traz ativada por padrão a partir da versão 141 no Android e no desktop, e o Edge é compatível a partir da versão 141. O Safari 26 oferece suporte apenas a solicitações ISO mdoc, e o Firefox é compatível no macOS a partir da versão 149, também apenas com o Anexo C. Dados consultados em 20 de novembro de 2026.[2][3][5]

A Digital Credentials API funciona no iPhone?

O Safari no iOS 26 é compatível com a API para solicitações ISO mdoc (Anexo C), e todos os navegadores para iOS usam o mesmo motor. O método do Google Wallet da Didit usa solicitações OpenID4VP assinadas, e o fluxo hospedado exibe o método apenas onde o navegador pode enviá-las. Portanto, em um iPhone, a opção de carteira fica oculta e a verificação por documento é usada.[3][5][8]

A Digital Credentials API é a mesma coisa que o OpenID4VP?

Não. A API é o canal do navegador; o OpenID4VP é um dos protocolos que trafegam por ela, ao lado do ISO/IEC 18013-7 Anexo C. A solicitação indica seu protocolo, e a carteira responde nesse protocolo.[1]

Preciso de um teste de origem para usá-la?

Não. O Chrome habilita a API por padrão a partir da versão 141, conforme anunciado pelo Google em 3 de outubro de 2025. O código de teste deve migrar de navigator.identity.get() para navigator.credentials.get().[2]

Por que a API precisa de um gesto do usuário?

A especificação exige ativação transitória, para que um site não possa solicitar credenciais de forma silenciosa ou repetida. Chame a API a partir de um manipulador de cliques; uma chamada fora de um gesto do usuário falha.[1]

Como funciona o compartilhamento entre dispositivos sem um código QR próprio?

O navegador gera o código QR, uma verificação por Bluetooth confirma que o celular está por perto, e a carteira responde por uma conexão criptografada. O Google Wallet exige uma solicitação assinada para isso.[2][7]

Quais carteiras respondem à Digital Credentials API?

O Google Wallet hoje, além de outras carteiras do Android por meio do Credential Manager. No iOS, o Safari alcança Identity Document Providers registrados.[3][7]

O uso da Digital Credentials API é gratuito?

Sim. Trata-se de um padrão do navegador, e o Google afirma que sua Google Wallet API não tem custo. A operação do lado do verificador é separada: a Didit cobra apenas por verificações concluídas.[7][8]

Fontes

  1. Digital Credentials, W3C Federated Identity Working Group, Working Draft de 19 de novembro de 2026.
  2. Digital Credentials API: Secure and private identity on the web, Chrome for Developers, 3 de outubro de 2025.
  3. WebKit Features in Safari 26.0, blog do WebKit, seção Digital Credentials API.
  4. Request a digital credential, Android Developers.
  5. Ecosystem support, digitalcredentials.dev, W3C Web Identity and Credentials Adoption Community Group, consultado em 20 de novembro de 2026.
  6. Accepting IDs from Google Wallet online, Google for Developers.
  7. Verify digital IDs with Google Wallet, Google for Developers.
  8. Digital ID wallets, documentação da Didit.
  9. Digital ID wallets standalone API, documentação da Didit.
  10. In-context iframe, documentação da Didit.

A Digital Credentials API transforma uma verificação de carteira em uma única chamada do navegador; a parte difícil é o lado do verificador. Veja todas as carteiras aceitas pela Didit na página de carteiras de identidade digital e os eIDs nacionais na verificação de eID.

Adicione "Verificar com ID digital" ao seu cadastro

Ofereça o Google Wallet onde ele funcionar e mantenha a verificação de documentos para todos os outros, em um único fluxo de trabalho.

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