Explicação da Digital Credentials API: acesso a carteiras de ID
A W3C Digital Credentials API para empresas: como um site pede uma ID a uma carteira sem redirecionamento, suporte de navegadores em 2026, QR entre dispositivos, privacidade, iframes e como a Didit a usa para o Google Wallet.

Em suma
A Digital Credentials API é uma API de navegador do W3C que permite a um website solicitar dados de identidade a uma carteira digital com uma única chamada, navigator.credentials.get() com um membro digital. O navegador e o sistema operativo apresentam o pedido da carteira, e a carteira devolve uma resposta assinada e encriptada.[1][2]
- O Chrome ativa-a por predefinição a partir da versão 141, conforme anunciado pela Google em 3 de outubro de 2025; o Safari 26 suporta-a para pedidos ISO mdoc.[2][3]
- Transporta pedidos OpenID4VP ou ISO/IEC 18013-7 Anexo C, sem redirecionamento e sem código QR próprio.[1]
- A Didit utiliza-a para aceitar identidades digitais do Google Wallet em cinco países.[8]
Provar quem é online tem significado há muito tempo uma fotografia de um documento de identidade e uma selfie. As identidades digitais numa carteira de telemóvel mudam isso, mas um website continua a precisar de uma forma segura de aceder à carteira. A Digital Credentials API é essa ponte.
Este guia explica a API para gestores de produto e arquitetos: como flui um pedido, onde funciona atualmente, partilha entre dispositivos, privacidade, iframes e como a Didit a utiliza para o Google Wallet. Os detalhes internos do protocolo encontram-se no nosso guia do verificador OpenID4VP e os formatos de credenciais 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. A sua versão mais recente é um Working Draft datado de 19 de novembro de 2026, na via de Recomendação.[1] A especificação define uma API que permite aos navegadores "intermediar a apresentação e emissão de credenciais digitais, tais como uma carta de condução, um cartão de identificação emitido pelo governo". Baseia-se no Credential Management Level 1 e "foi concebida para ser agnóstica em relação aos formatos de credenciais".[1]
Na prática, é mais um tipo de credencial para a chamada de navegador que os websites já utilizam para passkeys. Durante o seu origin trial, a API esteve em navigator.identity.get(); o Chrome moveu-a para navigator.credentials.get() quando foi lançada.[2] A API apenas transporta um pedido para uma carteira e uma resposta de volta; o conteúdo pertence aos protocolos subjacentes.
| Camada | O que faz | Exemplos |
|---|---|---|
| API do navegador | Transporta o pedido da página e a resposta de volta | W3C Digital Credentials API |
| Protocolo de apresentação | Define o pedido e a resposta que a carteira compreende | OpenID4VP 1.0, ISO/IEC 18013-7 Anexo C |
| Formato de credencial | A estrutura de dados assinada dentro da resposta | ISO mdoc, SD-JWT VC |
| Plataforma | Encontra carteiras que podem responder e mostra o seletor | Android Credential Manager, iOS |
| Carteira | Contém a credencial, pede ao utilizador, assina a resposta | Google Wallet |
A pilha sob uma chamada da Digital Credentials API.[1][2][4]
Como decorre um pedido da Digital Credentials API
Uma verificação requer uma única viagem de ida e volta entre a sua página e a carteira e vice-versa. O seu servidor constrói o pedido, a página transmite-o ao browser num clique, e a resposta encriptada regressa ao servidor para validação.[2][6]
O browser adiciona a origem e apresenta o seletor
O utilizador revê e aprova
Desencriptar e verificar assinaturas
Uma apresentação no mesmo dispositivo através da Digital Credentials API, de forma simplificada.[1][2][6]
Cada pedido identifica um protocolo e transporta um objeto data nesse protocolo. Os browsers têm de suportar todos os protocolos de apresentação indicados na tabela da especificação:[1]
| Identificador | Protocolo | Estrutura do pedido |
|---|---|---|
openid4vp-v1-unsigned | OpenID4VP 1.0 | Pedido não assinado |
openid4vp-v1-signed | OpenID4VP 1.0 | Pedido assinado |
openid4vp-v1-multisigned | OpenID4VP 1.0 | Pedido assinado por várias partes |
org-iso-mdoc | ISO/IEC 18013-7:2025 Anexo C | Pedido mdoc ISO |
Protocolos de apresentação no registo do W3C, Working Draft de 19 de novembro de 2026.[1]
Antes de mostrar um botão, uma página verifica typeof DigitalCredential e DigitalCredential.userAgentAllowsProtocol().[2][3] A resposta é devolvida como um objeto DigitalCredential com um payload de data encriptado, que a página reencaminha para o seu backend.[2] A sintaxe do pedido e os modos de resposta são questões de protocolo, abordadas no guia do verificador OpenID4VP.
Porque não há redirecionamento
Antes desta API, um site acedia a uma carteira digital enviando o utilizador para fora da página: um redirecionamento ou um URI personalizado entregue a uma aplicação, frequentemente apresentado como um código QR no computador. A Digital Credentials API mantém o utilizador na sua página e devolve a resposta ao mesmo separador.[2]
Via anterior
Redirecionamento ou URI personalizado
- O utilizador sai da sua página para uma aplicação ou uma página alojada
- A sua página desenha o seu próprio código QR no computador
- A carteira digital identifica quem solicita a partir do conteúdo do pedido
- Cada carteira digital necessita do seu próprio formato de link
Específico do esquema
Via mediada pelo navegador
Digital Credentials API
- O utilizador permanece na sua página e o navegador mostra o prompt
- O navegador desenha o código QR no computador
- O próprio navegador determina a origem que faz o pedido
- Uma chamada, qualquer carteira digital que a plataforma encontre
Digital Credentials do W3C
Como uma página acede a uma carteira digital, antes e com a API.[1][2]
A diferença mais importante é a origem. A especificação exige que o navegador utilize "a sua própria determinação da origem do documento" e não uma fornecida pela página, para que "a entidade mostrada ao utilizador" seja aquela que o navegador detetou.[1] Um pedido OpenID4VP assinado também pode listar as suas origens esperadas, que o guia da Google define "para evitar ataques de relay".[6] A arquitetura da carteira digital da UE refere o mesmo aspeto relativamente aos fluxos de URI personalizado entre dispositivos, conforme explica o nosso guia de entidade confiante.
Suporte de navegadores e plataformas no final de 2026
O suporte depende do navegador, do sistema operativo e do protocolo do pedido. A tabela reflete fontes públicas consultadas em 20 de novembro de 2026.
| Navegador ou plataforma | Onde | Apresentação | Protocolos | Fonte |
|---|---|---|---|---|
| Chrome | Android, Windows, macOS, Linux, ChromeOS | Ativo por predefinição a partir da versão 141 (3 de outubro de 2025) | OpenID4VP e Anexo C | Chrome, W3C CG[2][5] |
| Edge | Android, Windows, macOS | A partir da versão 141 | OpenID4VP e Anexo C | W3C CG[5] |
| Safari | iOS 26, iPadOS 26, macOS 26 | Suportado | Apenas Anexo C (org-iso-mdoc) | WebKit, W3C CG[3][5] |
| Outros navegadores iOS | iOS 26 | Tal como o Safari, executam em WebKit | Apenas Anexo C | Chrome, W3C CG[2][5] |
| Firefox | macOS | A partir da versão 149 | Apenas Anexo C | W3C CG[5] |
| Firefox | Android, Windows, Linux | Em desenvolvimento | Ainda não | W3C CG[5] |
| Aplicações Android | Android 9 (nível de API 28) e posterior | Credential Manager | OpenID4VP para Google Wallet | Android, Google[4][6] |
W3C CG = a tabela de suporte do W3C Web Identity and Credentials Adoption Community Group.[5]
Os utilizadores também precisam de um dispositivo compatível: Android com os serviços Google Play 24.0 ou posterior, ou iOS 26 ou posterior, além de uma aplicação de carteira que suporte a API.[2] O Google Wallet responde a identidades digitais baseadas em ISO mdoc através de OpenID4VP 1.0 no Android 9 e posterior.[6] O WebKit refere que ainda não funciona no interior do WKWebView, a visualização web em aplicações iOS.[3] Também indica um problema conhecido: um pedido que misture OpenID4VP e o Anexo C pode deixar o iOS num indicador de progresso infinito ao ler um código QR a partir do Chrome no macOS.[3]
Nota
O suporte muda com cada versão. Detete a funcionalidade e o protocolo em tempo de execução e mantenha outra rota para todos os outros.
No mesmo dispositivo e entre dispositivos
Quando a carteira está no mesmo dispositivo, o Android mostra um seletor de credenciais correspondentes. Quando não está, o browser propõe continuar num telemóvel.[2][7]
1A página chama a API dentro de um clique
O mesmo pedido em todos os casos.
Existe uma credencial correspondente neste dispositivo
Mesmo dispositivo
O seletor da plataforma lista as credenciais; a carteira abre-se por cima da página.
Entre dispositivos
O browser mostra o seu próprio código QR; o telemóvel lê-o e passa uma verificação de proximidade por Bluetooth.
2A resposta regressa à mesma página
Cifrada, através do browser.
Onde o aviso da carteira aparece.[2][6]
O Chrome indica que a leitura do código QR configura "uma ligação segura, encriptada de ponta a ponta e resistente a phishing" entre o computador e o telemóvel, utilizando o protocolo CTAP sobre Bluetooth Low Energy para verificar que o utilizador está fisicamente presente e no controlo de ambos os dispositivos.[2] A Google acrescenta duas condições para o Google Wallet: o Bluetooth tem de estar ligado para encontrar o dispositivo próximo, e o fluxo entre dispositivos "só está disponível quando o parceiro implementou Signed Requests".[7]
A sua página nunca desenha um código QR. Os limites vêm das plataformas: o iOS não suporta a apresentação a partir de uma credencial noutro dispositivo, e o Safari no macOS apenas passa pedidos do Anexo C, pelo que um pedido OpenID4VP não consegue chegar a uma carteira Android a partir do Safari.[5]
Privacidade e segurança: o que a API protege
Em vez de uma imagem de todo o documento, a carteira devolve apenas os atributos que o pedido nomeia, assinados pelo emitente. O Chrome chama a este princípio "divulgação seletiva": os sítios Web "recebem apenas a informação mínima necessária".[2]
| Proteção | O que significa na prática | Origem |
|---|---|---|
| Divulgação seletiva | Apenas os campos pedidos saem da carteira | Chrome[2] |
| Gesto do utilizador | Um pedido requer um clique; os sites não podem perguntar em silêncio ou repetidamente | W3C[1] |
| Mediação sempre | O seletor de plataformas pergunta ao utilizador em cada pedido | W3C[1] |
| Origem definida pelo navegador | A página não pode fingir ser outro site | W3C[1] |
| Resposta encriptada | Encriptada para a sua chave; apenas o seu servidor a desencripta | W3C, Chrome[1][2] |
| Aprovação para partilhar | O Google Wallet pede uma biometria, PIN ou padrão antes de partilhar | Google[7] |
A Google declara que não guarda dados relacionados com credenciais nos seus servidores.[7] O ecrã de consentimento é o da carteira: o Google Wallet mostra o nome, o logótipo e a política de privacidade fornecidos pelo verificador, para que a pessoa veja quem pergunta antes de partilhar.[7]
Uma assinatura válida prova que os dados são autênticos, mas o Chrome lembra aos programadores que "devem verificar se o emissor é adequado e de confiança" para o seu caso de uso.[2] O trabalho no lado do servidor para uma resposta mdoc, seguindo o guia da Google:[6]
- Descodifique a resposta com a chave que corresponde ao pedido.
- Valide a cadeia de certificados do emissor face às raízes de emissores fidedignos.
- Verifique cada valor devolvido face ao seu resumo assinado.
- Verifique a assinatura do dispositivo sobre a sessão, que vincula a sua origem.
Utilizar a API dentro de um iframe: digital-credentials-get
Muitos fluxos de verificação correm dentro de um iframe no site do cliente. A especificação cobre este caso com uma funcionalidade controlada por política chamada digital-credentials-get, cuja lista de permissões predefinida é 'self'.[1] Uma página de outra origem pode chamar a API apenas quando a página de integração a concede, através 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 o pedido da carteira dentro do iframe, e o utilizador nunca vê um aviso. Com o fluxo gerido da Didit num iframe, adicione digital-credentials-get ao atributo allow, ou utilize o Web SDK 0.5.1 ou posterior.[10]
Quais as carteiras que respondem hoje
No Android, o sistema desenha o seletor, e as credenciais que aparecem dependem da forma como cada carteira se regista no Credential Manager e do pedido.[7] A equipa do Chrome considera a Google Wallet uma pioneira.[2]
Nota
Como outras carteiras podem responder à mesma chamada, a Google recomenda um botão genérico como "Verificar com ID digital" em vez do nome de uma carteira.[7]
No iOS, o WebKit diz que a API chega ao Apple Wallet ou a outras aplicações registadas como Provedor de Documentos de Identidade.[3] Na Europa, a arquitetura da carteira europeia de identidade digital (EUDI Wallet) lista o OpenID4VP e o ISO/IEC 18013-7 sobre a API de Credenciais Digitais como vias de apresentação remota. A parte de registo dessa história está no guia de parte confiante da EUDI Wallet.
Como a Didit o ajuda a aceitar o Google Wallet através da Digital Credentials API
A Didit executa o lado do verificador da Digital Credentials API para o Google Wallet, como um dos métodos no seu produto de carteiras de ID digital. O Google Wallet está ativo na Didit em produção e em sandbox, para o passe de ID criado a partir de um passaporte e de cartas de condução móveis de estados dos EUA suportados, nos Estados Unidos, no Reino Unido, no Brasil, em Singapura e em Taiwan.[8] Detalhes do produto: Verificação de ID do Google Wallet. Código: o guia de integração.
- Fluxo alojado. Os utilizadores veem "Verificar com ID digital" e confirmam no aviso do próprio browser ou do Android, sem redirecionamento. O método aparece apenas onde o browser pode enviar um pedido OpenID4VP assinado; noutros locais, a verificação de documentos mantém-se.[8][9]
- API autónoma. A Didit devolve um pedido pronto para a sua página passar a
navigator.credentials.get()dentro de um clique, ou ao Gestor de Credenciais no Android; a sequência completa encontra-se no guia de integração.[9] - Verificações. A Didit verifica a assinatura do emitente em relação às raízes de emitentes fidedignos, cada valor em relação ao respetivo resumo assinado e a assinatura do dispositivo sobre a sua origem e este pedido. A resposta é encriptada para a Didit.[9]
- Resultado. Nome, data de nascimento, número de documento, data de validade, país e autoridade emissora e nacionalidade para uma passe de ID, ao nível de garantia Substancial. Não é partilhada nenhuma fotografia.[8]
O ambiente de teste não requer registo. Cada aplicação de produção regista-se uma vez junto da Google na consola (passo de Verificação de Identidade, a linha do Google Wallet de um país suportado, Registar com Google), uma configuração única de cerca de um minuto. A API de verificação própria da Google é gratuita; o preço da Didit para executar a verificação é de $0,20 por verificação concluída, sendo que os inícios de sessão cancelados, expirados ou recusados não são faturados. Consulte os preços.[7][8]
A Didit fornece
- O pedido assinado e o registo junto da Google
- A desencriptação e cada verificação de assinatura e de origem
- A verificação de documentos como alternativa na mesma sessão
Fica consigo
- O botão e a ação do utilizador na sua página
- A permissão do iframe quando incorpora o fluxo
- A decisão de integração e as suas políticas
Aceitar IDs do Google Wallet sem construir um verificador
Ativar o Google Wallet num fluxo de trabalho, testá-lo no ambiente de teste e pagar apenas pelas verificações concluídas.
Principais conclusões
- A Digital Credentials API é um Rascunho de Trabalho do W3C que encaminha os pedidos de carteiras através de
navigator.credentials.get(). - O Chrome e o Edge suportam OpenID4VP e o Anexo C; o Safari suporta apenas o Anexo C.
- O browser define a origem e gera o código QR entre dispositivos.
- No interior de um iframe, a página de incorporação tem de conceder
digital-credentials-get. - A Didit utiliza-a para IDs do Google Wallet em cinco países, com uma alternativa de documentos.
Perguntas frequentes
O que é a Digital Credentials API?
Uma API de browser do W3C que permite a um website solicitar uma credencial digital, tal como um documento de identificação governamental, a uma carteira através de navigator.credentials.get(). O browser e o sistema operativo apresentam o aviso da carteira.[1][2]
Que browsers suportam a Digital Credentials API?
O Chrome tem-na ativada por predefinição a partir da versão 141 no Android e no computador, e o Edge suporta-a a partir da versão 141. O Safari 26 suporta-a apenas para pedidos ISO mdoc, e o Firefox suporta-a no macOS a partir da versão 149, também apenas para o Anexo C. Lido a 20 de novembro de 2026.[2][3][5]
A Digital Credentials API funciona no iPhone?
O Safari no iOS 26 suporta a API para pedidos ISO mdoc (Anexo C), e todos os browsers do iOS utilizam o mesmo motor. O método do Google Wallet da Didit utiliza pedidos OpenID4VP assinados, e o fluxo alojado mostra o método apenas onde o browser pode enviar um, pelo que num iPhone a opção da carteira fica oculta e é utilizada a verificação de documentos.[3][5][8]
A Digital Credentials API é o mesmo que o OpenID4VP?
Não. A API é o canal do navegador; o OpenID4VP é um dos protocolos que circulam através dele, a par do ISO/IEC 18013-7 Anexo C. O pedido indica o seu protocolo e a carteira responde nesse protocolo.[1]
Preciso de um teste de origem para a utilizar?
Não. O Chrome ativa a API por predefinição a partir da versão 141, conforme anunciado pela Google a 3 de outubro de 2025. O código de teste tem de passar de navigator.identity.get() para navigator.credentials.get().[2]
Porque é que a API precisa de um gesto do utilizador?
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 gestor de cliques; uma chamada fora de um gesto do utilizador falha.[1]
Como funciona a partilha entre dispositivos sem o meu próprio código QR?
O navegador desenha o código QR, uma verificação por Bluetooth confirma que o telemóvel está próximo e a carteira responde através de uma ligação encriptada. O Google Wallet precisa de um pedido assinado para isto.[2][7]
Que carteiras respondem à Digital Credentials API?
O Google Wallet atualmente, além de outras carteiras Android através do Credential Manager. No iOS, o Safari acede a Provedores de Documentos de Identidade registados.[3][7]
A Digital Credentials API é de utilização gratuita?
Sim. É um padrão de navegador e a Google afirma que a sua API do Google Wallet não custa nada. Executar o lado do verificador é separado: a Didit fatura apenas as verificações concluídas.[7][8]
Fontes
- Digital Credentials, W3C Federated Identity Working Group, Working Draft de 19 de novembro de 2026.
- Digital Credentials API: Secure and private identity on the web, Chrome for Developers, 3 de outubro de 2025.
- WebKit Features in Safari 26.0, WebKit blog, secção Digital Credentials API.
- Request a digital credential, Android Developers.
- Ecosystem support, digitalcredentials.dev, W3C Web Identity and Credentials Adoption Community Group, consultado a 20 de novembro de 2026.
- Accepting IDs from Google Wallet online, Google for Developers.
- Verify digital IDs with Google Wallet, Google for Developers.
- Digital ID wallets, documentação da Didit.
- Digital ID wallets standalone API, documentação da Didit.
- In-context iframe, documentação da Didit.
A Digital Credentials API transforma uma verificação de carteira numa única chamada de navegador; a parte difícil é o lado do verificador. Veja todas as carteiras que a Didit aceita na página de carteiras de identidade digital e as identificações eletrónicas nacionais em verificação de eID.
Adicione Verificação com ID digital ao seu registo
Ofereça o Google Wallet onde funciona e mantenha a verificação de documentos para todos os outros, num único fluxo de trabalho.
Artigos relacionados
- Google Wallet ID vs verificação de documentos: quando usar cada uma
- Explicação da Digital Credentials API: acesso a carteiras de ID
- Aceitar Google Wallet ID no seu fluxo de onboarding: guia de integração
- Google Wallet ID pass: o que as empresas recebem e onde funciona
- A verificação de ID do Google Wallet está ativa na Didit
- As 7 melhores plataformas de software eIDAS em 2026