Requisitos de Entrada

Após a integração, o cliente poderá, através de um endpoint, fazer uma requisição de verificação das imagens de documentos fornecidos. Esta requisição será executada conforme pacote contratado pela entidade junto a ClearSale. Para envio da requisição o cliente deve-se atentar aos seguintes pontos:

Parâmetros

Para a utilização do produto de Autenticação de Identidade por Documentos, todos os parâmetros da requisição devem ser preenchidos (IdentifierID, ImagesDocument, Service e Selfie), com exceção de clientes que irão utilizar somente o serviço de Smart OCR (neste caso, o cliente fica isento de enviar a Selfie na requisição). Para garantir a correta resposta do produto, o cliente deve assegurar que o parâmetro Service deve ser enviado de acordo com o serviço contratado:

ServiceDescriçãoComo solicitar?
4Smart OCRLink
5Autenticação de Identidade por Documentos (AIDocs)Link
3AIDocs + Biometria DocumentalLink

Imagem

Aceitamos imagens em formatos PNG, JPG e JPEG, mas recomendamos enviar suas imagens como JPEGs, porque todas as imagens são convertidas automaticamente em JPEG durante o processamento delas. Os envios dos documentos podem ser feitos via base64 ou URL. Recomendamos o envio via URL para reduzirmos tempo de latência e consumo de recursos.

Para que o processo de validação seja executado com sucesso, é necessário que as imagens tenham como padrão os requisitos a seguir:

  1. Cada imagem enviada não deve exceder o tamanho máximo de 10MB;
  2. As imagens devem conter apenas um tipo de documento e uma selfie, sendo somente possível processar:
  • Carteira Nacional de Habilitação (CNH)
  • Carteira de Identidade / Registro Geral (RG)
  • Documento Nacional de Identificação (DNI/RG)
  • Carteira de Identidade Nacional (CIN)
  • Registro Nacional de Estrangeiro/Migratório (RNE / RNM)

Para verificar mais detalhes consultar a seção Documentos Aceitos.

  1. Devem ser enviadas a frente e verso correspondente a um dos documentos permitidos. A frente e o verso podem estar em uma mesma imagem (cenário 1: frente e verso) ou em duas imagens separadas (cenário 2: uma imagem com a frente e outra com o verso). Além disso, espera-se também em cada cenário o envio da Selfie do portador;

  1. As imagens dos documentos deverão ter a resolução mínima (Retrato ou Paisagem) de 300 x 275 pixels quando a área corresponde apenas a frente OU verso do documento (cenário 2); ou 800 x 800 pixels quando a área corresponde ao documento com fundo ou aberto, conforme o cenário 1; no caso de documentos aberto com o fundo a resolução deve ser de 1000 x 800 pixels;
  1. A resolução mínima da foto do portador no documento deve ser de 200 x 200 pixels para que ocorra a validação biométrica e/ou Face Match; Caso contrário, iremos redimensionar automaticamente a foto 3x4 para que atenda aos requisitos, podendo comprometer a qualidade da análise;
  2. As imagens do documento devem ser nítidas e possuir seus campos legíveis. Deve-se evitar, portanto:
  • Falta de luminosidade na captura da foto;
  • Imagens desfocadas;
  • Imagens com baixa qualidade na captura;
  • Documentos cortados ou com obstrução (exemplo: dedo ao segurar o documento);
  • Imagens com reflexo devido ao flash;
  • Imagens com brilho da embalagem plástica do documento;
  • Imagens com distorção de perspectiva e/ou geométricas curvas;
  • Selfie da pessoa segurando o documento;
  1. É necessário que o documento se encaixe dentro da tela de captura da imagem do aplicativo, e é recomendado que exista uma margem de segurança em torno dele próprio;
  2. É recomendado que o documento seja capturado em uma superfície plana, bem iluminada, com fundo homogêneo e de preferência escuro para facilitação do corte e tratamento da imagem;
  3. Os documentos precisam possuir um bom estado de conservação, sem manchas, arranhões, rasgos, entre outras degradações.

PDF

Além dos documentos impressos, também processamos documentos em formato PDF (Formato Portátil de Documento) originais, obtidos através dos aplicativos GOV.BR e Carteira Digital de Trânsito (CDT), que incluem QR Code para a verificação de autenticidade e certificado digital, representando avanço significativo na segurança e oferecendo praticidade na identificação de documentos. Modelos aceitos:

  • Carteira Nacional de Habilitação (CNH) emitida a partir de 2017;
  • Carteira de Identidade Nacional (CIN) emitida a partir de 2022;

Para que o processo de validação seja executado com sucesso, é necessário que os arquivos tenham como padrão os seguintes requisitos:

  1. O arquivo deve ser em formato PDF;
  2. Não deve exceder o tamanho máximo de 10MB;
  3. Deve ser emitido exclusivamente pelos órgãos emissores com assinatura digital.