Saltar al contenido principal
PATCH
curl

Qué hace

El análisis AML devuelve una lista de coincidencias (hits): posibles coincidencias con listas de sanciones, bases de datos de PEP, listas de vigilancia y medios adversos. Cada coincidencia tiene un review_status (su disposición), que empieza como Unreviewed o False Positive según la puntuación de coincidencia. Este endpoint permite a tu equipo (o a tu automatización) registrar una decisión sobre cada coincidencia sin cambiar la decisión global de la sesión. Encontrarás las coincidencias y sus ID en la decisión de la sesión: en el array hits de la comprobación AML, donde el id de cada coincidencia es el hit_id que pasas aquí. El id de una coincidencia es hit_ seguido de 24 caracteres hexadecimales, y no cambia cuando se vuelve a analizar al mismo sujeto. Un ID de coincidencia devuelto en el formato anterior se sigue aceptando; la respuesta siempre identifica la coincidencia por su id actual.

Estados de revisión

Las decisiones de los revisores se conservan entre las reevaluaciones de la monitorización continua: una coincidencia que marques como False Positive mantiene ese estado cuando el proveedor vuelve a analizar la entidad.

Actualizar una sola coincidencia

PATCH /v3/session/{sessionId}/update-aml-hit-status/
En una sesión con varias comprobaciones AML (flujos de trabajo de grafo), añade ?node_id=feature_aml_1 a la URL o incluye "node_id" en el cuerpo para seleccionar una comprobación concreta.

Actualizar varias coincidencias a la vez

PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/ Pasa hit_updates, una lista de pares { hit_id, review_status }. La operación es de todo o nada: si no se encuentra algún hit_id, la solicitud devuelve 404 y no se modifica ninguna coincidencia.
Una llamada masiva exitosa dispara un único webhook data.updated y registra una sola entrada de actividad que abarca todos los cambios.

Qué ocurre después de una actualización

  • Webhook: se dispara un evento data.updated en la sesión.
  • Registro de auditoría: el cambio queda registrado en el historial de revisión de la sesión junto con quién lo hizo (clave de API o usuario), y es visible en la cronología de actividad de la consola.
  • El estado global del paso AML no cambia: cambiar la disposición de una coincidencia no modifica por sí solo el estado del paso AML ni la decisión de la sesión. Para cambiar el estado del paso AML (Approved / Declined / In Review), usa update-feature-status. Para cambiar la decisión de la sesión, usa update-status.

Compatibilidad con KYC y KYB

Funciona tanto con sesiones de Verificación de usuario (KYC) como de Verificación de empresas (KYB): Didit resuelve el sessionId en ambos tipos. En KYB, el análisis AML se ejecuta sobre la empresa y sus personas clave; cada comprobación AML expone sus propias coincidencias.

Permiso

Requiere el privilegio write:sessions, con una clave de API de cliente (x-api-key) o un encabezado de autorización de usuario.

Errores

Relacionado

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

sessionId
string<uuid>
requerido

UUID de la sesión de verificación. Acepta ID de sesión tanto de usuario (KYC) como de empresa (KYB): el servicio resuelve el ID en ambos tipos de sesión.

Ejemplo:

"11111111-2222-3333-4444-555555555555"

Parámetros de consulta

node_id
string

ID del nodo del grafo del flujo. Solo es obligatorio cuando la sesión tiene varios análisis AML (uno por nodo); omítelo en sesiones con un único análisis AML.

Ejemplo:

"feature_aml_1"

Cuerpo

application/json
hit_id
string
requerido

El id de la coincidencia en el array hits de la comprobación AML (hit_...). Se sigue aceptando un id de coincidencia devuelto en el formato anterior.

Ejemplo:

"hit_7c1e9a40b2d35f86e0a4c912"

review_status
enum<string>
requerido

El nuevo estado de revisión de la coincidencia.

Opciones disponibles:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Ejemplo:

"False Positive"

node_id
string

ID de nodo del grafo opcional. Úsalo (aquí o como parámetro de consulta) cuando la sesión tenga varias comprobaciones AML.

Ejemplo:

"feature_aml_1"

Respuesta

Se actualizó el estado de revisión de la coincidencia.

message
string
requerido

Siempre Hit status updated successfully.

hit_id
string
requerido

El id de la coincidencia actualizada, tal como lo devuelve la decisión de la sesión, también cuando la solicitud identificó la coincidencia con un id en el formato anterior.

review_status
enum<string>
requerido

El estado de revisión que ahora tiene guardado la coincidencia.

Opciones disponibles:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
Última modificación el 1 de noviembre de 2026