> ## 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.

# Verificação de identidade API: 14,000+ documentos

> Didit verifica identidades com IA em 220+ países, 14,000+ tipos de documentos e 54 idiomas. $0.15 por verificação, $10 grátis/mês, latência sub-2s.

A Verificação de identidade da Didit lê e autentica documentos de identidade emitidos pelo governo, como passaportes, cartões de identidade, cartas de condução e títulos de residência, em 220+ países e 14,000+ tipos de documento. Verifica se o documento foi adulterado e se há fraude e, em seguida, extrai os seus dados com OCR baseado em IA. Quando o país o permite, as pessoas podem verificar a sua identidade sem documento, através de uma consulta a uma base de dados ou de uma carteira de identidade digital ([três formas de verificação](#três-formas-de-verificação)).A lição da Academy sobre como ler o resultado de uma verificação chega à verificação de identidade aos 3:47 e mostra porque é que as verificações de autenticidade vêm antes dos dados extraídos.[Verificação de identidade: autenticidade antes dos dados | Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

Prompt de integração da Verificação de identidade
        Copiar o prompt para a área de transferência



      
      

\<pre>

\````# Goal
Integrate Didit ID Verification (OCR + document authenticity) into your app. Pick ONE of the two delivery modes below.

\# Mode A — Session-based (recommended for user-facing flows)
Use this when the user uploads / photographs their document in a hosted Didit flow. The feature is configured on a workflow and runs as part of /v3/session/.

1\. Create a workflow with the ID_VERIFICATION feature (Business Console or POST /v3/workflows/). Canonical feature enum: "OCR" (legacy) or "ID_VERIFICATION".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open the returned session.url for the user OR mount the Web/Mobile SDK.
4\. After completion fetch the decision — GET /v3/session/{sessionId}/decision/ (or subscribe to the session.status.updated webhook).

The decision response surfaces the result under the plural array `id_verifications[]` (one entry per document collected in the workflow).

\# Mode B — Standalone API (server-to-server)
Use when you already have one or two document images and want a one-shot OCR + checks call.

POST https://verification.didit.me/v3/id-verification/
multipart/form-data — x-api-key: YOUR_API_KEY

Required: front_image. Required for dual-sided docs (ID cards, driver licences): back_image.
Allowed extensions: tiff/jpg/jpeg/png/webp/pdf. Max 5 MB per file. Images must be uncropped — all 4 corners visible.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/id-verification/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'front_image=@./id_front.jpg' \
-F 'back_image=@./id_back.jpg' \
-F 'perform_document_liveness=true' \
-F 'minimum_age=18' \
-F 'expiration_date_not_detected_action=DECLINE' \
-F 'invalid_mrz_action=DECLINE' \
-F 'inconsistent_data_action=DECLINE' \
-F 'preferred_characters=latin' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, id_verification: { status, full_name, document_type, document_number, date_of_birth, expiration_date, parsed_address, mrz, barcodes, portrait_image, front_document_image, back_document_image, warnings: [...] } }.

\# Status enum (per id_verifications[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.ID_VERIFICATION)
The warnings[] array on each id_verification carries risk codes including:
DOCUMENT_EXPIRED, INVALID_MRZ, INCONSISTENT_DATA, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_LIVENESS_FAILED, MIN_AGE_NOT_REACHED, MAX_AGE_EXCEEDED, EXPIRATION_DATE_NOT_DETECTED, DUPLICATED_DOCUMENT, FRAUD_RISK_FROM_OCR, COUNTRY_NOT_ALLOWED, DOCUMENT_TYPE_NOT_ALLOWED.
Full catalogue: /core-technology/id-verification/warnings-id-verification.

\# Failure modes to handle
\- HTTP 403 "You don't have enough credits..." — insufficient balance.
\- HTTP 400 with multipart validation errors (missing back_image on dual-sided docs, file > 5 MB, unsupported extension).
\- status="Declined" with one or more terminal warnings (DOCUMENT_EXPIRED, DOCUMENT_LIVENESS_FAILED, COULD_NOT_RECOGNIZE_DOCUMENT, etc.) — surface the first warning's long_description to the user and stop the flow.
\- status="In Review" with a DOCUMENT_LIVENESS_NOT_COMPUTED warning — the requested forgery check produced no usable score (provider error or crash); treat the document as unchecked and route it to your manual-review queue.
\- status="In Review" — route to your manual-review queue; do not approve the user.

\# See also
\- Canonical schema: /reference/data-models#id-verification
\- Full integration playbook: /integration/integration-prompt
\- Risk catalogue: /core-technology/id-verification/warnings-id-verification
\- Per-feature report: /core-technology/id-verification/report-id-verification````

\</pre>



      
      

Colar em

![Etapas da verificação de identidade da Didit, desde a captura do documento até à análise com IA e à decisão](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-verification-steps.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=42c64546f3495000d7ea3b10c4b5fa50)**1. Captura inteligente**Inicie o processo de verificação sem esforço, com o nosso sistema de captura intuitivo e baseado em IA. Os utilizadores carregam ou fotografam os seus documentos de identidade com assistência em tempo real:* **Deteção automática** do tipo de documento e do país emissor
* **Indicações visuais em tempo real** para o posicionamento, a iluminação e o foco ideais
* **Captura automática** quando as condições são ideais, sem necessidade de novas tentativas manuais
* Suporta **passaportes**, **cartas de condução**, **cartões de identidade nacionais** e **títulos de residência**> [!NOTE]
>
> *Porque é importante*: A nossa captura inteligente reduz o atrito para o utilizador e garante submissões de alta qualidade à primeira tentativa, aumentando as taxas de conversão e a confiança.**2. Processamento avançado de dados**Extraia e valide os dados de identidade com uma precisão sem igual.**Extração de dados**: tecnologia de ponta processa todos os campos principais:| Capacidade | Detalhes |
| - | - |
| **Extração de campos** | Nome completo, data de nascimento, número do documento, datas de emissão e de validade, nacionalidade e muito mais |
| **OCR** | Reconhecimento de texto de alta precisão |
| **Análise da MRZ** | Descodificação da zona de leitura automática |
| **Descodificação de códigos de barras** | Extração automática dos dados do código de barras |**Validação de dados**:* Cruza os dados entre as zonas visuais, a MRZ e os códigos de barras para garantir a consistência
* Verificação criptográfica de códigos de barras assinados pelo emissor, sempre que a autoridade emissora publica os certificados necessários para os verificar. Os cartões de identidade nacionais franceses já são abrangidos: o seu código de barras ANTS 2D-Doc é verificado com base num certificado do signatário que remonta à lista de confiança da ANTS, pelo que um código de barras que a autoridade não assinou é detetado mesmo quando o seu conteúdo parece consistente
* Correspondência de formatos e padrões para detetar anomalias
* Consultas em tempo real a bases de dados governamentais (quando permitido) para uma verificação oficial> [!NOTE]
>
> *Porque é importante*: O processamento completo dos dados garante exatidão e elimina erros, dando-lhe confiança em cada verificação.**3. Análise avançada**O nosso sistema baseado em IA realiza verificações completas para garantir a integridade e a autenticidade do documento:- **Verificação da autenticidade** do documento
- **Deteção de adulteração** e análise da integridade da imagem
- **Prova de vida do documento** para prevenir fraudes provenientes de:
  * Capturas de ecrã de documentos digitais
  * Fotografias de documentos apresentados em ecrãs
  * Cópias impressas de documentos
  * Documentos manipulados com retratos alterados
- **Validação de elementos de segurança** (hologramas, marcas de água, etc.)
- **Correspondência com modelos** numa base de dados certificada**4. Resultados e integração perfeita**Obtenha informações úteis de imediato, com opções de entrega flexíveis.**Resultados em tempo real**:- Atualizações imediatas através de um painel intuitivo
- Notificações webhook instantâneas para fluxos automatizados
- API RESTful para uma integração perfeita nos seus sistemas existentes**Relatórios completos**:* Relatórios PDF detalhados com os resultados da verificação e as provas
* Registos de auditoria para conformidade e manutenção de registos
* Opções personalizáveis para se adaptarem às suas necessidades operacionais> [!NOTE]
>
> *Porque é importante*: Resultados rápidos e acessíveis permitem à sua equipa agir depressa, mantendo um processo seguro e auditável.***## Três formas de verificaçãoUma fotografia de documento é uma das três [formas de verificação de identidade](https://docs.didit.me/pt/core-technology/id-verification/verification-methods.md). Consoante o país, pode também permitir que as pessoas provem quem são sem qualquer documento:- **[Consulta sem documento](https://docs.didit.me/pt/core-technology/id-verification/non-doc-lookup.md)**: o utilizador introduz o seu número de identificação nacional e alguns dados pessoais, e nós verificamos esses dados num registo governamental ou noutra fonte oficial, indicada para cada país. Quando essa fonte devolve um retrato, são incluídas uma selfie, prova de vida passiva e correspondência facial.
- **[Carteiras de identidade digital](https://docs.didit.me/pt/core-technology/id-verification/digital-id-wallets.md)**: o utilizador inicia sessão com uma identidade digital governamental ou bancária, como a MitID, a BankID ou a itsme, e a carteira partilha um conjunto assinado de atributos.Tudo o que está nesta página descreve a captura de documentos, que não muda: um fluxo que não menciona métodos continua a ser apenas captura de documentos.***## Requisitos do documentoPara garantir o maior sucesso na verificação, os documentos têm de cumprir estas normas:#### Requisitos gerais- Emitidos pelo governo e válidos dentro do período de validade configurado
- Fisicamente intactos (sem danos, riscos ou manchas que ocultem os dados)
- Todas as informações críticas (nome completo, data de nascimento, MRZ, etc.) claramente legíveis
- Dados consistentes em todos os documentos enviados#### Requisitos de imagem- Fotografia original, em tempo real (sem capturas de ecrã, digitalizações ou cópias digitais)
- Formatos suportados: JPG, JPEG, PNG, PDF
- Tamanho máximo do ficheiro: 5MB
- Imagem a cores com todos os cantos do documento visíveis
- Sem reflexos, sombras, edição digital ou manipulação
- São necessários documentos físicos (documentos de identidade digitais suportados apenas em regiões selecionadas onde são oficialmente reconhecidos)## Definições adicionais por país e tipo de documentoConfigure regras detalhadas por país e tipo de documento diretamente na consola. Estes controlos permitem-lhe ajustar os critérios de aceitação e as preferências de transcrição às suas necessidades de conformidade.![Painel de definições adicionais de verificação de identidade da Didit para regras de validade e aceitação por país](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-additional-settings.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=4238b10a404795a61926fbdf1a3adc20)* **Modo de validade**: Escolha como tratar os documentos com datas de validade já ultrapassadas.

  * **Recusar documentos expirados**: Se a data de validade do documento for anterior a hoje, marque-o como expirado e recuse-o.
  * **Permitir documentos expirados**: Não assinale nem bloqueie documentos com uma data de validade ultrapassada.

  Esta definição controla também a monitorização pós-aprovação, que está ativada por predefinição: com **Recusar documentos expirados**, uma sessão aprovada passa para `"Kyc Expired"` quando a data de validade do documento é ultrapassada mais tarde, e `status.updated` é disparado; com **Permitir documentos expirados**, a sessão mantém-se aprovada e nunca é monitorizada. Consulte [monitorização de documentos](https://docs.didit.me/pt/core-technology/id-verification/document-monitoring-id-verification.md).
  No fluxo de trabalho da API, a definição de documento por país `expiration_check_mode` aceita `strict` (**Recusar documentos expirados**), `allow_expired` (**Permitir documentos expirados**) e `local_regulation`.
  `local_regulation` segue a regra própria do país, sempre que a Didit a tenha, e recusa documentos expirados em todos os outros casos.
  Qualquer outro valor é rejeitado.
* **Formato de caracteres preferido**: Selecione a forma como os nomes e os campos extraídos devem ser normalizados.
  * **Preferir caracteres latinos (A–Z)**: Exemplo: "Mohammed"
  * **Preferir o sistema de escrita original (não latino)**: Exemplo: "محمد"
* **Suporte regional e subtipos**: Ative documentos por região e especifique os subtipos aceites quando um tipo de documento tiver muitas variantes.
  * Exemplo: para as cartas de condução dos Estados Unidos, selecione os subtipos exatos que aceita (por exemplo, Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License, etc.).
  * Use o controlo "Subtipos aceites" para incluir ou excluir rapidamente muitas variantes (por exemplo, "128 selected").> Dica: estas definições aplicam-se por país e tipo de documento, pelo que pode ser mais exigente em alguns mercados e mais permissivo noutros.## Restrições de idade por paísAplique requisitos de idade mínima e máxima por país durante a verificação de identidade. O sistema extrai a data de nascimento do utilizador a partir do documento submetido e compara-a com os limites de idade configurados para o país emissor do documento.### ConfiguraçãoAs restrições de idade são configuradas numa tabela por país, diretamente na consola:| Coluna | Descrição |
| - | - |
| **País** | O país emissor do documento (ISO 3166-1 alpha-3). Só são apresentados os países ativados na sua lista de documentos permitidos. |
| **Idade mín.** | Idade mínima exigida. Os utilizadores com idade inferior a este valor desencadeiam a ação configurada (Recusar ou Revisão). |
| **Idade máx.** | Idade máxima permitida. Os utilizadores com idade superior a este valor acionam a ação configurada. Deixe vazio para não haver limite superior. |
| **Substituições de estado/região** | Para países com variação de idade a nível subnacional (por exemplo, Estados Unidos, México), abra o ícone de definições para configurar idades mínimas e máximas por estado, que substituem as predefinições do país. |### Predefinições da maioridadeA consola inclui o botão **"Aplicar a idade legal de maioridade"**, que preenche automaticamente a idade mínima de cada país com a idade legal de maioridade aplicável (18 na maioria dos países, com exceções como 19 na Coreia do Sul, 21 nos Emirados Árabes Unidos, 20 na Nova Zelândia, etc.). Depois, pode ajustar países individuais ou adicionar substituições ao nível do estado, conforme necessário.### Substituições por estado/regiãoAlguns países têm limiares legais de idade diferentes consoante o estado ou a região. Quando um documento é digitalizado, o sistema de OCR extrai a região (por exemplo, "Mississippi", "Alabama", "Jalisco") do documento. Se existir uma substituição por estado configurada para essa região, esta tem prioridade sobre a definição de idade ao nível do país.Por exemplo, se os Estados Unidos tiverem uma idade mínima de 18, mas o Mississippi tiver uma substituição de 21, um utilizador que apresente uma carta de condução do Mississippi será avaliado em função da idade mínima de 21 anos.### Ações configuráveisQuando a idade de um utilizador estiver fora do intervalo configurado para o país (ou estado) do seu documento, pode escolher a ação:* **Recusar**: A sessão é recusada automaticamente.
* **Revisão**: A sessão é assinalada para revisão manual.> [!NOTE]
>
> As restrições de idade por país também funcionam com fluxos de **Verificação de idade adaptativa**. Quando um caso limítrofe desencadeia a alternativa de verificação de identidade, a verificação de idade utiliza estas definições por país para tomar a decisão final, com base no país emissor e na região do documento.


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