Saltar para o conteúdo principal
A verificação de identidade do Didit Authentication pede às pessoas que comprovem quem são nos momentos que escolher: antes de a conta ser criada e novamente antes de uma ação sensível, como um pagamento. A sua aplicação recebe o resultado e as declarações verificadas que selecionou, como over_18 ou um nome verificado, nos tokens da pessoa, nunca os seus documentos ou fotografias. Configure-a na consola, em Authentication > Verified identity, ou por API com verified/.
A página Verified identity na Business Console da Didit, com os níveis de verificação no registo e os respetivos preços, e as regras de verificação reforçada antes de ações sensíveis

Authentication > Verified identity: a verificação no registo e as regras antes de ações sensíveis.

Como funciona

Cada verificação é executada como uma sessão de verificação da sua aplicação, criada com o vendor_data da pessoa. Isso significa que aparece nas suas verificações e fica associada à mesma pessoa que os respetivos inícios de sessão e transações, segue para revisão manual como qualquer outra verificação e é faturada ao preço dessa verificação. A Didit executa cada verificação com o seu fluxo predefinido, ou com um dos seus próprios fluxos, à sua escolha para essa verificação. Consulte preços para ver todos os preços de verificação.

Ao criar conta

Escolha o nível que uma pessoa tem de passar antes de a sua conta ser criada: Um novo nível aplica-se às pessoas que se registam a partir desse momento, nunca às contas existentes. Nas páginas alojadas, a Didit orienta a pessoa durante a verificação no registo. Nos seus próprios ecrãs, a chamada de registo responde com verification_required e um verification_url válido durante 30 minutos: envie a pessoa para esse endereço. A Didit emite o código de início de sessão apenas depois de a verificação ser aprovada.

Verificação reforçada antes de ações sensíveis

Uma verificação reforçada (step-up) pede à pessoa que se verifique novamente, apenas quando uma ação tem risco suficiente. Ative as regras, e a sua aplicação pergunta à Didit, antes de cada ação sensível, se alguma delas se aplica.
Um telemóvel a mostrar uma verificação reforçada que pede à pessoa que confirme a sua identidade com uma selfie

O que a pessoa vê quando uma verificação reforçada pede uma selfie.

Pode alterar a verificação de cada regra para prova de vida, início de sessão com selfie ou verificação de identidade completa. Quando várias regras se aplicam, a Didit pede a verificação mais forte. Quando a Didit ainda não tem dados faciais da pessoa registados, o início de sessão com selfie passa a ser uma verificação de identidade completa.

Pedir uma verificação reforçada

A sua aplicação chama POST {issuer}/step-up/ com o token de acesso da pessoa, ou o método stepUp() dos SDK:
  • 200 {"required": false}: nenhuma regra se aplica, por isso pode avançar.
  • 201 com verification_url: redirecione a pessoa para esse URL. A verificação reforçada fica aberta durante 30 minutos (expires_in: 1800).

Ler o resultado no seu backend

A pessoa regressa a return_to com step_up=<id>&status=approved acrescentado, mas essa consulta não prova nada. O seu backend lê a verificação reforçada com GET {issuer}/step-up/{step_up_id}/ e um token de acesso da mesma sessão, e só age quando status é approved. Uma verificação reforçada nunca permite a ação quando a verificação falha: quando a verificação não está disponível, a ação continua bloqueada. Os guias de início rápido de JavaScript, Next.js e iOS mostram o lado do SDK, e a Referência da API tem o contrato completo.

O que a sua aplicação recebe

Escolha quais as afirmações verificadas que entram nos tokens da pessoa: O token de acesso e o token de ID incluem as afirmações em verified, com level, o nível mais alto em que a pessoa foi aprovada: liveness, liveness_face_match ou full_id. É {} quando a pessoa não foi aprovada em nenhum, e GET /session/ devolve null em vez disso.
  • Uma verificação aprovada durante uma sessão chega aos tokens na próxima atualização, em até 5 minutos.
  • Qualquer entidade que tenha o token pode ler estas afirmações, incluindo o seu front-end. Por isso, selecione apenas as afirmações pessoais de que a sua aplicação precisa.
  • A sua aplicação recebe afirmações, nunca o documento, a selfie ou os dados faciais.

Configurar através da API

GET e PATCH em verified/ na API de gestão de autenticação da sua aplicação leem e alteram as mesmas definições que a consola:
Uma regra que omita mantém as respetivas definições atuais.
Última modificação em 22 de novembro de 2026