Saltar para o conteúdo principal
Didit angaria 7,5 milhões de dólares para construir a infraestrutura para identidade e fraude
Didit
Voltar ao blog
Blog · 20 de novembro de 2026

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.

Por DiditAtualizado
digital-credentials-api-cover.png

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]

Última revisão: 20 de novembro de 2026 · Não constitui aconselhamento jurídico

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.

CamadaO que fazExemplos
API do navegadorTransporta o pedido da página e a resposta de voltaW3C Digital Credentials API
Protocolo de apresentaçãoDefine o pedido e a resposta que a carteira compreendeOpenID4VP 1.0, ISO/IEC 18013-7 Anexo C
Formato de credencialA estrutura de dados assinada dentro da respostaISO mdoc, SD-JWT VC
PlataformaEncontra carteiras que podem responder e mostra o seletorAndroid Credential Manager, iOS
CarteiraContém a credencial, pede ao utilizador, assina a respostaGoogle 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 seu servidor A sua página web Browser e SO Carteira
1O utilizador clica em verificar
2Pedido assinado
3credentials.get, digital

O browser adiciona a origem e apresenta o seletor

4Pedido e origem

O utilizador revê e aprova

5Resposta encriptada
6Objeto DigitalCredential
7Reencaminhar protocolo e dados

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]

IdentificadorProtocoloEstrutura do pedido
openid4vp-v1-unsignedOpenID4VP 1.0Pedido não assinado
openid4vp-v1-signedOpenID4VP 1.0Pedido assinado
openid4vp-v1-multisignedOpenID4VP 1.0Pedido assinado por várias partes
org-iso-mdocISO/IEC 18013-7:2025 Anexo CPedido 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 plataformaOndeApresentaçãoProtocolosFonte
ChromeAndroid, Windows, macOS, Linux, ChromeOSAtivo por predefiniçã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 iOSiOS 26Tal como o Safari, executam em 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]
Aplicações AndroidAndroid 9 (nível de API 28) e posteriorCredential ManagerOpenID4VP para Google WalletAndroid, 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

Sim

Mesmo dispositivo

O seletor da plataforma lista as credenciais; a carteira abre-se por cima da página.

Não

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çãoO que significa na práticaOrigem
Divulgação seletivaApenas os campos pedidos saem da carteiraChrome[2]
Gesto do utilizadorUm pedido requer um clique; os sites não podem perguntar em silêncio ou repetidamenteW3C[1]
Mediação sempreO seletor de plataformas pergunta ao utilizador em cada pedidoW3C[1]
Origem definida pelo navegadorA página não pode fingir ser outro siteW3C[1]
Resposta encriptadaEncriptada para a sua chave; apenas o seu servidor a desencriptaW3C, Chrome[1][2]
Aprovação para partilharO Google Wallet pede uma biometria, PIN ou padrão antes de partilharGoogle[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.

Começar gratuitamenteFale connoscoLer a documentação

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

  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, WebKit blog, secçã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 a 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 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.

Começar grátisFale connosco

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitorização de Transações e Rastreio de Carteiras. Integre em 5 minutos.

Peça a uma IA para resumir esta página