Saltar para o conteúdo principal
O início de sessão com carteira é um dos três métodos de Verificação de identidade. O utilizador inicia sessão com uma identidade digital que já possui — uma eID nacional ou uma identidade bancária — e esse fornecedor partilha um conjunto assinado de atributos com a Didit. O resultado apresenta o nível de garantia cryptographic: um fornecedor de identidade autenticou a pessoa e assinou os atributos que devolveu. Isto é tudo o que o nível atesta. Não se trata de uma classificação em relação aos outros dois níveis — eles descrevem evidências diferentes, e não representam graus maiores ou menores da mesma coisa — e a duração do início de sessão depende do fluxo próprio da carteira, o qual a Didit não controla nem garante.
A disponibilidade é específica do seu ambiente. As tabelas abaixo descrevem a disponibilidade em produção, e a consola utiliza o catálogo de capacidades ativas do respetivo ambiente quando guarda um fluxo. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID estão disponíveis. Estonian ID-card, eParaksts mobile, Personalausweis, OneID e ConnectID permanecem Em breve em produção. O Smart-ID suporta a Estónia, Letónia, Lituânia e Bélgica; o Mobile-ID suporta a Estónia e Lituânia; a Finnish Trust Network suporta a Finlândia. Consulte o guia de integração do Smart-ID e Mobile-ID para obter detalhes sobre a cobertura por país, a configuração e o fluxo de verificação. Uma carteira marcada como Em breve não pode ser ativada nesse ambiente.

Escolha a sua integração

Utilize as APIs de carteiras de identidade digital quando a sua aplicação gere a interface e os passos de autenticação. Cada carteira dispõe de um endpoint de início dedicado, com endpoints partilhados de resultados, consulta contínua e cancelamento. Não precisa de criar um fluxo. Utilize a Sessions API para o percurso alojado da carteira da Didit, regras de fluxo e o recurso de contingência de documentos configurado. A disponibilidade da carteira, a aprovação necessária do utilizador e os atributos de identidade verificados aplicam-se a ambos os métodos de integração.

Pré-requisitos

Cada carteira requer uma identidade ativa junto do emissor indicado abaixo e acesso ao respetivo método de autenticação. A conta deve ser elegível para os atributos solicitados e o utilizador deve consentir a sua partilha. Uma assinatura verifica o emissor e as declarações devolvidas; não garante que todos os atributos solicitados estejam presentes, atualizados ou sejam suficientes para a sua política de conformidade. Uma carteira sem retrato não inclui uma comparação de selfie. Todas as 25 entradas do catálogo de carteiras estão listadas abaixo, incluindo ambos os países do BankID, o ConnectID, o Estonian ID-card e o eParaksts mobile. Um recurso de contingência de documentos configurado executa uma verificação de documentos separada. Não é prometida nenhuma data de lançamento. Estas são carteiras de identidade. A triagem de carteiras de criptomoedas verifica endereços de blockchain quanto a risco financeiro e é um produto separado.

Preços

✅ Disponível significa ativado em produção. ⏳ Em breve significa ainda não ativado em produção, mesmo que os testes de integração tenham começado. As carteiras disponíveis aparecem primeiro. Mediante pedido na coluna de preço significa que a carteira está disponível, mas não tem uma tarifa pública de retalho; não significa que a verificação seja gratuita. Estes são os preços padrão da Didit em USD por verificação de carteira concluída para os produtos de identidade listados abaixo. O preço indicado inclui a verificação da identidade através da carteira; não é adicionada qualquer taxa de transação nacional de eID separada. Uma tarifa acordada específica para a organização tem precedência. Em breve na coluna de preço significa que a carteira está planeada e o seu preço para o cliente ainda não foi publicado. Não significa que a verificação seja gratuita. As bandeiras dos países mostram a cobertura do catálogo da carteira; a coluna de disponibilidade em separado mostra se pode atualmente ser ativada. Um preço publicado não ativa uma carteira. A disponibilidade acima provém do catálogo de produção. Uma carteira marcada como Em breve ainda não pode ser selecionada num fluxo; estas tarifas aplicam-se quando ficar disponível.
  • Um início de sessão verificado por carteira é cobrado uma vez por nó de Verificação de identidade num fluxo, ou uma vez por pedido de verificação através da API autónoma de carteiras. Callbacks repetidos ou verificações de estado não geram outra cobrança.
  • Inícios de sessão cancelados, expirados, recusados ou incompletos não geram uma cobrança de verificação de carteira.
  • Os preços das carteiras são preços de tabela: o desconto do seu plano aplica-se a eles como em qualquer outra verificação.
  • Uma alternativa de documento é uma verificação separada, faturada segundo os preços da verificação de documentos. Outras funcionalidades concluídas do fluxo são faturadas separadamente.
Por exemplo, 1,000 verificações de identificação completa iDIN concluídas à tarifa padrão custam $950, antes de outras funcionalidades do fluxo. Trata-se de uma identificação completa; não é um preço de início de sessão repetido. A tarifa do BankID acima aplica-se a Norway High, e a tarifa do eID alemão aplica-se ao perfil 2 do Personalausweis.

O que o utilizador faz

  1. Escolhe o seu país no passo de ID e escolhe uma carteira de entre as que você aceita.
  2. Inicia sessão com essa carteira, da mesma forma que inicia sessão no seu banco ou no seu portal governamental.
  3. Autoriza a partilha dos seus atributos de identidade consigo.
  4. Regressa verificado.
O início de sessão no mesmo dispositivo transfere o utilizador para a aplicação da carteira e devolve-o ao fluxo de verificação quando terminar. O início de sessão entre dispositivos apresenta um código QR no ecrã do computador que o utilizador lê com o telemóvel onde se encontra a carteira. Ambos são disponibilizados onde a carteira os suportar; o utilizador escolhe. Quando o Smart-ID ou o Mobile-ID está ativado no seu fluxo, o utilizador introduz o seu código de identificação pessoal na página de verificação. O Mobile-ID também solicita o número de telefone associado à identidade. A página apresenta um código de comparação, e o utilizador aprova no seu telemóvel apenas quando esse código coincidir. O utilizador introduz o seu PIN no seu telemóvel; a Didit nunca o solicita. Este fluxo funciona a partir de um computador ou telemóvel sem necessidade de código QR. A disponibilidade é determinada pelo catálogo de capacidades em produção; uma carteira marcada como Em breve ainda não pode ser ativada. Um início de sessão iniciado permanece válido durante uma janela de tempo limitada (10 minutos por predefinição). Após esse período, o utilizador tem de iniciá-lo novamente.

As carteiras constituem uma lista de aceitação

wallet.providers é a lista de carteiras que um país pode disponibilizar. Não se trata de uma classificação: a ordem que envia não tem qualquer significado, é normalizada para a ordem do catálogo ao guardar, e o utilizador final escolhe de entre as que você tiver aceite. Ative uma carteira ou todas as carteiras de um país — a escolha é do utilizador. A API rejeita um fluxo que ative uma carteira que o catálogo não disponibilize nesse país, ou uma que ainda esteja Em breve.
A lista de atributos de cada carteira abaixo inclui uma atestação assinada. A Didit verifica essa assinatura e comunica o veredito como wallet_verification.signature_valid na sessão; a atestação em si não é devolvida, pelo que não existe nenhuma referência para obter ou armazenar. A coluna Na sessão indica qual das duas opções recebe para cada atributo.

Carteiras suportadas

As carteiras disponíveis são MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID e Mobile-ID. O iDIN está disponível para identificação completa nos Países Baixos. O Smart-ID e o Mobile-ID estão disponíveis nos países listados no catálogo abaixo. A cobertura por país e os dados solicitados para o Smart-ID e o Mobile-ID refletem a integração implementada; a disponibilidade em produção permanece controlada separadamente. Utilize o guia de integração para as rotas implementadas do Smart-ID e do Mobile-ID.
A Disponibilidade é fornecida pelo catálogo de capacidades, não sendo mantida manualmente aqui. Em breve significa que a carteira está visível na consola e ainda não pode ser ativada; não tem uma data comprometida.

Estonian ID-card e eParaksts mobile

Ambos os métodos estão integrados no catálogo de carteiras, mas permanecem Em breve em produção. Não podem ser ativados em fluxos de produção até que o catálogo de produção os marque como Disponíveis. Os identificadores da API são idcard_ee para a Estónia (EST) e eparaksts_mobile para a Letónia (LVA). Ambos têm o preço de $0.55 por verificação concluída quando disponíveis; um preço publicado não ativa o acesso à produção.
  • Estonian ID-card: o utilizador continua no navegador no computador ligado ao seu leitor de cartões inteligentes e autentica-se com o seu cartão e PIN através do software do cartão.
  • eParaksts mobile: o utilizador continua para o serviço de início de sessão de identidade e aprova com a sua conta eParaksts mobile ativa. Os utilizadores em computadores de secretária podem ler o código QR para continuar no seu telemóvel; os utilizadores em telemóveis continuam diretamente.
Ambos utilizam o fluxo partilhado da Didit de seleção de carteira, transferência e retorno. O utilizador introduz o seu PIN de autenticação apenas no serviço de identidade ou no software do cartão, nunca num formulário da Didit. Após a autenticação, a Didit verifica os atributos de identidade assinados e continua o fluxo configurado. O cancelamento ou falha segue a ação de contingência de documento ou de recusa configurada no fluxo.
A marca branca aplica-se aos ecrãs de verificação da Didit. Os ecrãs de autenticação externa para estes dois métodos mantêm a imagem de marca do seu serviço. Logótipos personalizados, nomes de serviços e estilização de marca branca não transitam para esses ecrãs externos.

Utilizar estas carteiras através da API

Ambos os métodos também suportam verificação independente por API sem um workflow_id. A disponibilidade em produção é a mesma para a API independente e para fluxos; verifique GET /v3/id-verification/wallets/ antes de disponibilizar qualquer um dos métodos aos utilizadores. Mantenha a sua x-api-key no seu backend e registe o host de retorno da sua aplicação na respetiva definição allowed_return_hosts. Envie um return_url em HTTPS nesse host ao iniciar uma verificação. A resposta de início devolve um request_id e um wallet_verification.next_action.url para o navegador do utilizador. Redirecione o utilizador para esse URL para que se possa autenticar com o seu cartão ou aplicação. Após o seu regresso, consulte GET /v3/id-verification/wallets/verifications/{request_id}/ a partir do seu backend para verificar o resultado da verificação, ou processe o webhook status.updated assinado. Não considere o redirecionamento do navegador por si só como prova de verificação bem-sucedida. O mesmo preço e as mesmas regras de faturação por verificação concluída aplicam-se a ambas as opções de integração.

Google Wallet

A Google Wallet permite que uma pessoa partilhe um documento de identificação emitido pelo governo a partir do seu telemóvel com a sua página ou aplicação, através da W3C Digital Credentials API. Está disponível em produção e na sandbox. As aplicações na sandbox não necessitam de registo. Cada aplicação em produção regista-se uma vez antes de poder utilizar a Google Wallet: na consola, abra o passo de verificação de identidade, encontre a linha da Google Wallet de um país suportado, selecione Registar na Google e conclua a configuração única, que demora cerca de um minuto. A Google apresenta depois o seu nome e logótipo quando as pessoas partilham o seu documento de identificação. Até a aplicação estar registada, guardar um fluxo que ative a Google Wallet é recusado com “Register this application with Google before enabling Google Wallet.” Os utilizadores finais dos seus clientes veem a opção como Verify with digital ID, porque para além da Google Wallet qualquer outra carteira Android que suporte o mesmo pedido OpenID4VP e contenha um documento de identificação compatível (um passe de identificação ou uma carta de condução móvel) pode responder ao pedido.
  • Países: Estados Unidos, Reino Unido, Brasil, Singapura e Taiwan.
  • Credenciais: o passe de identificação da Google Wallet criado a partir de um passaporte, além de cartas de condução móveis de estados dos EUA suportados.
  • Devolvido: nome, data de nascimento, número do documento, data de validade do documento, país emissor e autoridade emissora, e nacionalidade para um passe de identificação. O resultado também inclui o veredito signature_valid para a credencial. Nenhum retrato é partilhado.
  • Privacidade: a Didit solicita apenas os campos de que necessita, e apenas esses campos saem da carteira. A pessoa aprova a partilha na Google Wallet no seu próprio dispositivo.
Não existe redirecionamento: a pessoa confirma no aviso da carteira do próprio navegador ou do Android, e os navegadores em computadores de secretária mostram o seu próprio código QR quando a carteira está num telemóvel. A verificação é solicitada a partir da sua página ou aplicação, pelo que a integração de API necessita da origem HTTPS da sua página. O fluxo alojado da API de sessões oferece o método apenas em navegadores e dispositivos que o suportem, mantendo a contingência de documento caso contrário. Quando apresenta o fluxo alojado dentro da sua própria página, utilize o Web SDK 0.5.1 ou posterior, ou adicione digital-credentials-get ao atributo allow do seu iframe: sem ele, o navegador recusa o pedido da carteira dentro do iframe.

Outras carteiras futuras

O ConnectID (Austrália) está integrado para testes em sandbox e surge no catálogo de carteiras como connectid. A pessoa seleciona um banco de teste participante através do seletor do ConnectID, inicia sessão nesse banco e analisa o pedido de partilha. O pacote de identidade inicial solicita o nome próprio, o apelido e a data de nascimento, juntamente com uma referência de transação para a verificação. Não solicita morada, número de telefone, endereço de e-mail, saldo da conta ou histórico de transações. O aviso de partilha identifica a Didit e a empresa que recebe a identidade verificada. As credenciais bancárias permanecem no banco. O acesso a produção permanece Em breve; os testes em sandbox não ativam a verificação de identidade em produção. Antes da ativação, é necessário concluir um caso de utilização de produção aprovado, o onboarding do cliente, os termos obrigatórios e a certificação. Outras carteiras marcadas como Em breve nas tabelas também continuam indisponíveis em produção. Não é prometida qualquer data de lançamento.

Nível de garantia

Quando uma carteira fornece um nível de garantia eIDAS (low, substantial ou high), a Didit regista o nível efetivamente declarado no resultado. Uma carteira sem um nível eIDAS especificado, como o ConnectID, é apresentada como Não especificada; a sua integração não implica uma alegação de garantia eIDAS. Se uma carteira devolver um nível inferior ao solicitado, o início de sessão falha em vez de efetuar uma redução de nível silenciosa. Verifique wallet_verification.level_of_assurance na sessão quando as suas regras de conformidade dependerem disso.

Referência por carteira

MitID

mitid · Disponível Informação introduzida na Didit: Nome · Data de nascimento · Alias CPR (pseudonimizado)

BankID

bankid_se · Disponível Informação introduzida na Didit: Nome · Número pessoal

iDIN

idin · Disponível Informação introduzida na Didit: Nome · Data de nascimento · Morada

Finnish Trust Network

ftn · Disponível Informação introduzida na Didit: Nome · Código de identificação pessoal

Google Wallet

google_wallet · Disponível Informações introduzidas na Didit: Não são introduzidos dados de identidade na Didit

Smart-ID

smart_id · Disponível Informações introduzidas na Didit: Código de identificação pessoal

Mobile-ID

mobile_id · Disponível Informações introduzidas na Didit: Código de identificação pessoal · Número de telefone do Mobile-ID

BankID

bankid_no · Em breve Informações introduzidas na Didit: Nome · Data de nascimento · Número de identificação nacional

Vipps

vipps · Em breve Informação introduzida no Didit: Nome · Data de nascimento · Número de identificação nacional

Buypass ID

buypass · Em breve Informação introduzida no Didit: Nome · Data de nascimento · Número de identificação nacional

itsme

itsme · Em breve Informação introduzida no Didit: Nome · Data de nascimento · Número do registo nacional

Personalausweis

personalausweis · Em breve Informação introduzida no Didit: Nome · Data de nascimento · Nacionalidade · Morada

Freja eID

frejaid · Em breve Informação introduzida no Didit: Nome · Data de nascimento · Número pessoal

UAE PASS

uae_pass · Em breve Informação introduzida na Didit: Nome · Número da Emirates ID · Nacionalidade · Retrato

gov.br

govbr · Em breve Informação introduzida na Didit: Nome · CPF

OneID

oneid · Em breve Informação introduzida na Didit: Nome · Data de nascimento

GOV.UK Wallet

govuk_wallet · Em breve Informação introduzida na Didit: Nome · Data de nascimento · Retrato

Estonian ID-card

idcard_ee · Em breve Informação introduzida na Didit: Nome · Data de nascimento · Código de identificação pessoal

eParaksts mobile

eparaksts_mobile · Em breve Informação introduzida na Didit: Nome · Data de nascimento · Código de identificação pessoal

Bank iD

bankid_cz · Em breve Informação introduzida na Didit: Nome · Data de nascimento

MojeID

mojeid · Em breve Informação introduzida na Didit: Nome · Data de nascimento

Diia

diia · Em breve Informação introduzida na Didit: Nome · Data de nascimento · Retrato

FranceConnect

franceconnect · Em breve Informação introduzida na Didit: Nome · Data de nascimento

Auðkenni

audkenni · Em breve Informação introduzida na Didit: Nome · Kennitala

ConnectID

connectid · Em breve Informação introduzida na Didit: Não são introduzidos dados de identidade na Didit

EUDI Wallet

eudi · Em breve Informação introduzida na Didit: PID - dados de identificação pessoal

Falha e alternativa

Qualquer resultado diferente de verified segue o seletor wallet.on_failure do país: fallback_to_document envia o utilizador para a captura de documentos, decline termina a sessão com uma Verificação de identidade recusada. fallback_to_document com a captura de documentos desativada para esse país resulta em recusa, dado que não há nenhuma alternativa para o fallback. Para apresentar a captura de documentos apenas após um início de sessão falhado na carteira, consulte Oferecer captura de documentos apenas como fallback. Apenas um início de sessão concluído é faturado. Inícios de sessão abandonados, cancelados, expirados ou falhados não têm qualquer custo.

O que é apresentado na sessão

attributes contém as afirmações validadas da carteira, cujos nomes variam consoante a carteira. Utilize full_name e date_of_birth no resultado da verificação de identidade para os campos de identidade normalizados. A tabela por carteira distingue esses campos normalizados dos atributos específicos da carteira. portrait está presente apenas para as carteiras que partilham um retrato. signature_valid é o resultado da validação da asserção assinada que a carteira devolveu. É true num início de sessão concluído: uma asserção que não seja validada faz falhar o início de sessão e segue wallet.on_failure em vez de produzir um resultado aprovado. Os tipos de todos os campos estão no modelo de dados da verificação de identidade.

Configurar carteiras

Este é um fragmento de configuração para utilizar apenas quando o catálogo do seu ambiente marcar cada carteira selecionada como available no país selecionado. Enviar uma carteira indisponível rejeita a gravação de todo o fluxo, incluindo quaisquer outros métodos no mesmo pedido. Para exemplos de Smart-ID e Mobile-ID, consulte o guia de integração.
Ative pelo menos uma carteira quando wallet.enabled for true, caso contrário a gravação será rejeitada. A referência completa encontra-se em Configurações de funcionalidades do fluxo.

Relacionado

Última modificação em 7 de novembro de 2026