> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Métodos de verificação de identidade na consola Didit

> Defina na consola Didit os métodos de verificação de identidade permitidos por país, os interruptores de recurso e o método usado por sessão.

O passo [Verificação de identidade](https://docs.didit.me/pt/core-technology/id-verification/verification-methods.md) num fluxo tem um separador **Países**. É aí que decide, país a país, qual dos três métodos uma pessoa pode usar e o que acontece quando um método sem documento não resulta. Tudo o que está no separador escreve a chave [`methods`](https://docs.didit.me/pt/management-api/workflows/feature-configs#ocr-/-verificação-de-identidade) no nó de Verificação de identidade: a consola e a API de Gestão são duas vistas do mesmo objeto.

## Países e métodos de verificação de identidade permitidos

Abra um fluxo, selecione o nó **Verificação de identidade** e, depois, **Países**. Cada linha de país mostra os métodos que aceita. Selecione um país para abrir o respetivo editor.

| Secção | O que controla | Configuração que escreve |
| - | - | - |
| **Captura do documento** | Se um documento fotografado é aceite, bem como os tipos de documento, subtipos e regras de captura desse país | `document.enabled`, `documents_allowed` |
| **Consulta sem documento** | Se a consulta sem documento é oferecida, quantas tentativas respondidas o utilizador tem e se os passos seguintes de Prova de vida e Correspondência facial do fluxo são ignorados após uma correspondência com retrato | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **Carteiras aceites** | Quais as carteiras de identificação digital que esse país oferece. É uma lista de aceitação, não uma classificação: o utilizador final escolhe entre as que você assinalar | `wallet.enabled`, `wallet.providers` |
| **Recorrer à captura do documento quando…** | Um interruptor por cada modo de falha | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

Os interruptores **Recorrer à captura do documento quando…** ficam desligados sempre que o país não tem captura do documento, porque não há para onde recorrer. Ative a **Captura do documento** para o país para os usar.

Um país em que desligue todos os métodos é rejeitado ao guardar, com a mensagem **Nenhum método ativado: ninguém pode verificar aqui**, porque essa configuração não consegue verificar ninguém.

### Oferecer a captura do documento apenas como alternativa

Abra um país e escolha **Como os utilizadores verificam aqui**:

| Escolha | O que os utilizadores veem |
| - | - |
| **Carteira em primeiro lugar, documento se falhar** | Apenas a carteira (ou a consulta de identidade, quando nenhuma carteira está selecionada). A captura do documento só é oferecida se a autenticação for cancelada, expirar ou falhar, ou se a consulta não corresponder. |
| **Apenas carteira, sem documento** | Apenas a carteira (ou a consulta de identidade). A captura do documento fica desligada para o país, e uma autenticação que não termine pode ser repetida: o utilizador fica no passo da carteira com "Tentar {wallet} novamente" e a sessão mantém-se aberta até concluir ou até expirar. |
| **O utilizador escolhe carteira ou documento** | A carteira ou a consulta lado a lado com a captura do documento. |
| **Apenas documento** | Captura do documento. Não é oferecida nenhuma carteira nem consulta. |

**Carteira em primeiro lugar** escreve `document.fallback_only` e os interruptores de alternativa correspondentes (`wallet.on_failure` e, quando uma consulta está ativada, os interruptores de consulta) num único passo. **Apenas carteira** define `document.enabled` como `false` e `wallet.on_failure` como `retry`: uma autenticação que não termine pode ser repetida, e a sessão mantém-se aberta até o utilizador concluir ou até expirar.
Funciona da mesma forma para qualquer carteira em qualquer país.
Ambas as opções ficam indisponíveis até selecionar uma carteira disponível (ou ativar uma consulta).
Uma carteira marcada como **Em breve** não pode ser a primeira opção: enquanto todas as carteiras de um país estiverem marcadas como **Em breve**, a captura do documento continua em primeiro lugar.
A lista de países mostra **Carteira, depois documento** em cada país que o usa, e a pré-visualização mostra apenas a carteira.

A mesma definição está em **Definições adicionais** nos ecrãs Carteiras e Consulta sem documento, como o interruptor **Oferecer a captura do documento apenas como alternativa**.
Ambos os controlos editam a mesma configuração.

### A disponibilidade é definida pelo servidor

O separador lê o mesmo catálogo de capacidades que a API valida, por isso só pode oferecer o que a plataforma suporta de facto:

* Um método que o catálogo não oferece nesse país não aparece como opção.
* Uma fonte ou carteira que o catálogo marca como **Em breve** aparece na lista para que veja o roteiro, mas não pode ser ativada.
* A autenticação com carteira é ativada por ambiente. Enquanto estiver desligada, todas as carteiras mostram **Em breve**, independentemente do que o catálogo indicar.

### Ativar Smart-ID ou Mobile-ID

O Smart-ID e o Mobile-ID estão disponíveis nos países suportados.
Consulte o [catálogo de carteiras](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md) para ver a cobertura por país.
Confirme a disponibilidade apresentada no seu ambiente atual antes de alterar um fluxo.

1. Abra **Fluxos de trabalho**, selecione o fluxo e o nó **Verificação de identidade** e, depois, abra **Países**.
2. Abra o editor do país e encontre **Carteiras aceites**.
3. Selecione **Smart-ID** ou **Mobile-ID** apenas se estiver disponível; deixe a captura do documento ativada se quiser uma alternativa.
4. Escolha o que deve acontecer quando a autenticação na carteira falhar e, depois, guarde e publique o fluxo.
5. Inicie uma nova sessão de verificação com esse fluxo e inspecione o cartão **Credencial** da sessão concluída.

O [guia de integração do Smart-ID e do Mobile-ID](https://docs.didit.me/pt/core-technology/id-verification/smart-id-mobile-id.md) indica os códigos de país suportados e o fluxo de códigos de comparação que o utilizador vê.
Um teste bem-sucedido num ambiente de pré-produção ou sandbox não ativa a carteira em produção.

### Pedido e resposta esperados

**Ver detalhes** numa fonte de consulta ou numa carteira abre o pedido e a resposta esperados: o que é pedido ao utilizador final, em linguagem simples, e o que a fonte devolve. Cada fonte de consulta é indicada pelo nome exato: um registo governamental na maioria dos países, um ficheiro de uma agência de crédito ou de registos residenciais em alguns, porque isso determina a proveniência e o regime de consentimento. O utilizador final nunca vê os campos da resposta, o nome da fonte nem o preço.

### Ativações em massa

**Definições globais** ativa um método em todos os países que o suportam, para não ter de percorrer os 36 países manualmente. O editor de cada país continua a prevalecer: ative um método globalmente e, depois, desligue-o no único país em que não o quer.

## Preços na aba

A captura de documento mostra o respetivo preço: \$0.15 por verificação. Uma consulta sem documento mostra o preço por país, e qualquer preço que o catálogo de preços ainda não tenha publicado aparece na aba marcado como valor provisório, e não como cotação. Uma linha de carteira mostra a carteira, a sua cobertura e a sua disponibilidade.

A aba também explica a consequência na faturação de cada interruptor de alternativa da consulta, para que o custo de uma configuração fique visível antes de a guardar:

* Uma consulta a um registo que respondeu é faturada: tanto uma correspondência como uma ausência de correspondência contam, e a captura de documento é então faturada à parte quando o utilizador recorre a ela.
* Uma consulta que nunca devolveu resposta não é faturada, pelo que uma indisponibilidade custa-lhe apenas o preço do documento.
* Se desativar uma alternativa, esses utilizadores são recusados, e não é faturado mais nada.

## Ler uma sessão

O bloco **Verificação de identidade** num detalhe da sessão mostra um chip para o método que a produziu e um segundo chip para o seu [nível de garantia](https://docs.didit.me/pt/core-technology/id-verification/verification-methods.md#níveis-de-garantia): **Documento / Documental**, **Consulta sem documento / Correspondência de dados**, ou o nome da carteira com **Criptográfico**.

> [!NOTE]
>
> Uma sessão que passou da verificação sem documento para a captura de documento aparece como sessão **Documento / Documental**. [`fallback_from`](https://docs.didit.me/pt/reference/data-models#verificação-de-identidade) nessa Verificação de identidade indica o método que foi tentado primeiro e o motivo pelo qual terminou (por exemplo `wallet` e `cancelled`), com `action: "fallback_to_document"`.

Abaixo dos chips, cada método mostra as suas próprias provas:

* **Documento**: sem alterações, com as imagens da frente, do verso e da selfie, as pontuações de qualidade, os campos extraídos e os avisos.
* **Consulta sem documento**: uma **Comparação com o registo** que lista cada campo comparado com o que o utilizador forneceu, o que a fonte continha e um resultado **Correspondência**, **Parcial** ou **Sem correspondência**, além do nome da fonte, quando foi verificada e do número de tentativas. Uma fonte que não respondeu aparece como uma linha própria com um erro, e não com um veredicto de campo. Quando a fonte devolveu um retrato, esse retrato e a selfie do utilizador são mostrados lado a lado, com a pontuação facial.
* **Carteira**: o cartão **Credencial**, com a carteira, a sua entidade emissora, o tipo de credencial, o nível de garantia que declarou, o momento em que foi verificada, se a assinatura foi validada e os atributos que a carteira partilhou.

Quando uma fonte ou uma carteira não partilha nenhum retrato, o painel indica-o em vez de deixar uma moldura vazia: não há nada com que fazer a correspondência facial, e a Prova de vida e a Correspondência facial são executadas como passos próprios se o fluxo as incluir.

## Relacionado

* [Métodos de verificação de identidade](https://docs.didit.me/pt/core-technology/id-verification/verification-methods.md): os três métodos, a alternativa e a faturação
* [Consulta sem documento](https://docs.didit.me/pt/core-technology/id-verification/non-doc-lookup.md): campos por país e consentimento
* [Carteiras de identidade digital](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md): atributos por carteira e garantia
* [Fluxos de trabalho](https://docs.didit.me/pt/console/workflows.md): criar e publicar um fluxo
* [Configurações de funcionalidades do fluxo](https://docs.didit.me/pt/management-api/workflows/feature-configs.md#ocr-/-verificação-de-identidade): as mesmas definições através da API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.