Advertencias de screening AML y códigos de alerta

Descripción general

El análisis AML emite un pequeño conjunto de etiquetas de advertencia en el array warnings[] de cada entrada de aml_screenings[]. Las dos etiquetas siguientes son las únicas advertencias AML que genera Didit. Todo lo demás que ves en una coincidencia está codificado en los propios campos de la coincidencia (risk_view, match_score, risk_score, sanction_matches[], …) y no como advertencia. Tanto las sesiones de un flujo de verificación (workflow) como la API de AML independiente emiten POSSIBLE_MATCH_FOUND de la misma forma. El estado que se devuelve en el registro AML (Approved, In Review, Declined) se deriva del score agregado y de tus umbrales. Las etiquetas de advertencia señalan esas mismas condiciones para que puedas reaccionar a ellas de forma programática. Consulta Puntuación de riesgo AML para ver cómo se corresponden los umbrales con el estado.

Advertencias generadas

Riesgo	Causa	`log_type`	Afecta al estado	Corrección recomendada
`POSSIBLE_MATCH_FOUND`	El `score` agregado es distinto de cero y supera el `aml_score_approve_threshold` (por defecto `80`): al menos una posible coincidencia entra en tu banda de riesgo. (La API de AML independiente también la emite cuando la puntuación es exactamente igual al umbral).	`warning`; pasa a `error` cuando la puntuación también supera el `aml_score_review_threshold` (por defecto `100`).	`In Review` cuando la puntuación supera el umbral de aprobación; `Declined` cuando supera el umbral de revisión.	Revisa cada coincidencia de `hits[]`. Usa el endpoint de estado de coincidencias AML para marcarlas como `Confirmed Match`, `False Positive` o `Inconclusive`. Las actualizaciones de coincidencias disparan un webhook `data.updated`, pero no recalculan el estado AML: define el estado final mediante el endpoint de estado AML o la revisión en la consola.
`COULD_NOT_PERFORM_AML_SCREENING`	Al registro KYC le falta uno o más de estos campos: `full_name`, `date_of_birth` o `issuing_state`. No se realiza ninguna llamada de evaluación facturable.	`warning`	Fuerza `In Review`.	Completa los campos que faltan en el registro KYC. El análisis AML se vuelve a ejecutar automáticamente cuando los tres están presentes: el registro de advertencia obsoleto se elimina y no es necesario volver a ejecutarlo manualmente.

Las advertencias se almacenan con feature: "AML" y siguen la estructura estándar del objeto de advertencia.

Configuración ajustable

Controles AML por nodo del flujo (también se aceptan como opciones en la API de AML independiente):

aml_score_approve_threshold: por defecto 80. Una puntuación distinta de cero que lo supere genera POSSIBLE_MATCH_FOUND y envía la comprobación AML a In Review. Las puntuaciones iguales o inferiores no generan la advertencia en los flujos de sesión, independientemente del número de coincidencias.
aml_score_review_threshold: por defecto 100. Una puntuación que lo supere rechaza automáticamente la comprobación AML (con el valor por defecto de 100 nunca se activa hasta que lo reduzcas).
aml_match_score_threshold: por defecto 93. Clasificación por coincidencia: las coincidencias con un match_score inferior empiezan como False Positive y se excluyen de la puntuación agregada; las iguales o superiores empiezan como Unreviewed.
Pesos de la puntuación de coincidencia: aml_name_weight / aml_dob_weight / aml_country_weight, por defecto 60 / 25 / 15 (deben sumar 100). Consulta Puntuación de coincidencia AML.
Monitorización continua: cuando está activada, el análisis AML vuelve a analizar al sujeto a medida que cambian los conjuntos de datos y vuelve a emitir el informe junto con un webhook status.updated (cambio de estado) o data.updated (cambio en las coincidencias).

Cuando se dispara COULD_NOT_PERFORM_AML_SCREENING, la comprobación AML permanece en In Review hasta que se aporten los campos de identidad que faltan. En cuanto Didit tiene el nombre completo, la fecha de nacimiento y el estado emisor, el análisis AML se vuelve a ejecutar automáticamente y la advertencia desaparece: no se puede volver a activar manualmente.

Ejemplos

`POSSIBLE_MATCH_FOUND` (puntuación por encima del umbral de aprobación)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "POSSIBLE_MATCH_FOUND",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Possible match found in AML screening",
      "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review.",
      "node_id": "aml-1"
    }
  ]
}

`COULD_NOT_PERFORM_AML_SCREENING` (faltan campos KYC)

{
  "warnings": [
    {
      "feature": "AML",
      "risk": "COULD_NOT_PERFORM_AML_SCREENING",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Could not retrieve data from KYC for performing AML Screening",
      "long_description": "The system encountered issues accessing or processing Know Your Customer (KYC) data necessary for conducting the Anti-Money Laundering (AML) screening. please fill the KYC full name, birth date, issuing state and document number to automatically proceed with AML screening.",
      "node_id": "aml-1"
    }
  ]
}

Contenido relacionado

Informe AML: estructura completa de la respuesta, campos de las coincidencias y semántica de los estados
Puntuación de riesgo AML: cómo se calcula la puntuación agregada
Puntuación de coincidencia AML: confianza por coincidencia
Monitorización AML continua: ciclo de vida de la monitorización
Modelos de datos: análisis AML: esquema canónico, incluido el objeto de advertencia

Autenticación

Verificación

Monitorización

Plataforma

Advertencias de screening AML y códigos de alerta

Descripción general

Advertencias generadas

Configuración ajustable

Ejemplos

`POSSIBLE_MATCH_FOUND` (puntuación por encima del umbral de aprobación)

`COULD_NOT_PERFORM_AML_SCREENING` (faltan campos KYC)

Contenido relacionado

Tipos de advertencia

​Descripción general

​Advertencias generadas

​Configuración ajustable

​Ejemplos

​POSSIBLE_MATCH_FOUND (puntuación por encima del umbral de aprobación)

​COULD_NOT_PERFORM_AML_SCREENING (faltan campos KYC)

​Contenido relacionado

​Tipos de advertencia

Descripción general

Advertencias generadas

Configuración ajustable

Ejemplos

`POSSIBLE_MATCH_FOUND` (puntuación por encima del umbral de aprobación)

`COULD_NOT_PERFORM_AML_SCREENING` (faltan campos KYC)

Contenido relacionado

Tipos de advertencia