Inteligência

data.ndocs: o que a mesma pessoa já fez com você, em toda resposta.

Markdown

Todo processo finalizado informa quem é a pessoa, com o Human Token, e o que essa pessoa já fez com você, com a inteligência em data.ndocs: com quantos dos seus clientes ela foi vista, quantos documentos usou e quando.

"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}

Campo	Significado
distinctClientsCount	Valores distintos de clientId nos processos da pessoa
transactionsCount	Número de processos da pessoa, incluindo este
firstSeen, lastSeen	Datas em UTC (YYYY-MM-DD) do processo mais antigo e do mais recente
credentials[].type	Tipo de documento, um código do catálogo de atributos
credentials[].countryCode	País emissor do documento, em alpha-3. Ausente para um tipo que o catálogo não lista mais
credentials[].distinctCredentialCount	Documentos distintos desse tipo

Como interpretar

Um distinctClientsCount acima de 1, ou um distinctCredentialCount acima de 1, significa que o mesmo rosto foi usado com clientes ou documentos diferentes. O que fazer com esse sinal é decisão sua.

O que é contado

Uma pessoa é identificada pelo Human Token. Só são contados os processos finalizados com esse token, em todos os seus client ids. Um processo criado sem documento conta como uma transação e como um cliente, mas sem tipo de documento. credentials é [] quando nenhum dos processos da pessoa tem documento.

A inteligência abrange os processos da sua instalação do Human Plugin.

De quem é a inteligência

• Identificação finalizada com um Human Token: essa pessoa. Não quando data.liveness.value é not_live.
• Revalidação com data.humanTokenMatch igual a "true": a pessoa do token que você enviou em references. O processo conta para essa pessoa.
• Nos demais casos (uma correspondência negativa, ou uma captura que não é viva): sem inteligência e sem data.ndocs.

Quando está ausente

data.ndocs pode estar ausente para uma pessoa conhecida:

• o processo ainda não foi finalizado;
• não foi possível calcular a inteligência. A criação ou a consulta ainda é bem-sucedida, e um GET posterior tenta de novo.

Não interprete um data.ndocs ausente como uma pessoa nunca vista.

Próximo passo

Pré-requisitos e acesso