Inteligencia

data.ndocs: lo que la misma persona ha hecho contigo, en cada respuesta.

Markdown

Todo proceso finalizado te dice quién es la persona, con el Human Token, y qué ha hecho esa persona contigo, con la inteligencia en data.ndocs: con cuántos de tus clientes se la vio, cuántos documentos usó y cuándo.

"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 entre los procesos de la persona
transactionsCount	Número de procesos de la persona, incluido este
firstSeen, lastSeen	Fechas UTC (YYYY-MM-DD) del proceso más antiguo y del más reciente
credentials[].type	Tipo de documento, un código del catálogo de atributos
credentials[].countryCode	País alpha-3 que emite el documento. Ausente para un tipo que el catálogo ya no incluye
credentials[].distinctCredentialCount	Documentos distintos de ese tipo

Cómo leerla

Un distinctClientsCount mayor que 1, o un distinctCredentialCount mayor que 1, significa que el mismo rostro se ha usado con distintos clientes o documentos. Qué hacer con esa señal es decisión tuya.

Qué se cuenta

Una persona se identifica por el Human Token. Solo se cuentan los procesos finalizados con ese token, entre todos tus client ids. Un proceso creado sin documento cuenta como una transacción y como un cliente, pero bajo ningún tipo de documento. credentials es [] cuando ninguno de los procesos de la persona tiene documento.

La inteligencia abarca los procesos de tu instalación de Human Plugin.

De quién es la inteligencia

• Identificación que finalizó con un Human Token: esa persona. No cuando data.liveness.value es not_live.
• Revalidación con data.humanTokenMatch igual a "true": la persona del token que enviaste en references. El proceso cuenta para esa persona.
• En cualquier otro caso (una coincidencia negativa o una captura que no es live): sin inteligencia y sin data.ndocs.

Cuándo está ausente

data.ndocs puede faltar para una persona conocida:

• el proceso aún no ha finalizado;
• no se pudo calcular la inteligencia. La creación o la lectura igualmente tiene éxito, y un GET posterior lo intenta de nuevo.

No interpretes la ausencia de data.ndocs como que la persona nunca fue vista.

Siguiente

Requisitos previos y acceso