Correspondência facial 1:1 API: comparação selfie vs ID

​

Novas tentativas e feedback acionável

• Orçamento de tentativas — face_match_max_attempts controla o número total de envios de correspondência facial por sessão. Predefinição 3 (uma tentativa inicial mais duas novas tentativas), configurável por nó de fluxo (intervalo 1–3).
• Feedback de nova tentativa — enquanto restarem tentativas, uma falha que permita nova tentativa mantém o utilizador no passo e devolve feedback_codes (os SDKs Web e Mobile apresentam-nos automaticamente como mensagens de orientação):
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  
• Esgotamento — assim que o orçamento se esgota, o estado calculado é aplicado (Declined ou In Review).

​

Como funciona

​

Requisitos do documento

​

Requisitos gerais

• Emitidos pelo governo e válidos dentro do período de validade configurado
• Fisicamente intacto (sem danos, riscos ou manchas a ocultar detalhes)
• Todas as informações críticas (nome completo, data de nascimento, MRZ, etc.) claramente legíveis
• Dados consistentes em todos os documentos submetidos

​

Requisitos da 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ções digitais ou manipulações
• Documentos físicos obrigatórios (IDs digitais suportados apenas em regiões selecionadas onde sejam oficialmente reconhecidos)

​

Definições adicionais por país e tipo de documento

• Modo de expiração: Escolha como tratar documentos cuja data de validade já passou.
  • Rejeitar expirados: Se a data de validade do documento for anterior ao dia de hoje, marcar como expirado e recusar.
  • Permitir expirados: Não sinalizar nem bloquear documentos com uma data de validade expirada.
• Formato de carateres preferido: Selecione como os nomes e campos extraídos devem ser normalizados.
  • Preferir carateres latinos (A–Z): Exemplo: “Mohammed”
  • Preferir sistema de escrita original (não latino): Exemplo: “محمد”
• Suporte regional e subtipos: Ative documentos por região e especifique subtipos aceitáveis quando um tipo de documento contiver várias variações.
  • Exemplo: Para 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.).
  • Utilize o controlo “Subtipos aceites” para incluir/excluir rapidamente diversas variantes (por exemplo, “128 selecionados”).

Dica: Estas definições aplicam-se por país e tipo de documento, permitindo-lhe aplicar critérios mais rigorosos em alguns mercados e ser mais permissivo noutros.