API de monitorización de transacciones (KYT)

La monitorización de transacciones de Didit te permite analizar cada transacción en tiempo real, tanto entrante como saliente, con un motor de reglas configurable. Cada transacción recibe una puntuación de riesgo, y las reglas pueden aprobarla, marcarla para revisión o rechazarla automáticamente según tus umbrales. Esta lección de Didit Academy recorre el motor de reglas con datos reales: el feed de transacciones, cómo se calcula la puntuación de riesgo, la creación de reglas con desencadenantes y condiciones, las pruebas retrospectivas y la activación de la monitorización de cripto. Si eres nuevo en Didit TM, empieza con el inicio rápido para una configuración de 10 minutos y después lee la guía de integración para conocer la arquitectura y los patrones de producción. La puntuación de riesgo explica con exactitud cómo se calculan las puntuaciones.

Cómo funciona

Envía una transacción

Envía los datos de la transacción mediante la API Create Transaction. Cada transacción incluye las partes sujeto y contraparte, los datos financieros (importe, divisa, dirección), la información del método de pago y, opcionalmente, el contexto del dispositivo y propiedades personalizadas para la evaluación de reglas.Didit admite varias categorías de transacción, desde transacciones financieras estándar hasta eventos de juego, transferencias de regla de viaje y entradas de registro de auditoría. Consulta Envío de transacciones para ver la referencia completa del payload.

El motor de reglas evalúa

Didit ejecuta la transacción contra todas las reglas activas de tu aplicación. Las reglas pueden comprobar:

Umbrales de una sola transacción: límites de importe, países de alto riesgo, entidades en lista de bloqueo
Ventanas de velocidad: volumen acumulado o recuento a lo largo del tiempo (por ejemplo, más de $10,000 en 24 horas)
Patrones de comportamiento: detección de fraccionamiento, movimientos rápidos de entrada y salida, patrones de importes redondos
Análisis AML: comprobaciones de sanciones y listas de vigilancia sobre contrapartes y usuarios vinculados mediante proveedores externos
Riesgo de wallet: exposición a mixers y direcciones de wallet de alto riesgo (para transacciones cripto)

Cada regla coincidente contribuye a la puntuación de riesgo global de la transacción.

Puntúa y decide

Según la puntuación acumulada y la coincidencia de regla de mayor gravedad, la transacción recibe un estado:

Estado	Significado
`APPROVED`	Por debajo de todos los umbrales: la transacción está limpia
`IN_REVIEW`	Marcada para revisión manual por un analista
`DECLINED`	Rechazada automáticamente por una regla
`AWAITING_USER`	Requiere una verificación adicional del usuario

Cuando una transacción pasa a AWAITING_USER, Didit crea automáticamente una sesión de subsanación vinculada y devuelve una URL de verificación para que puedas continuar el flujo sin salir del espacio de trabajo de la transacción.

Monitoriza e investiga

Usa la Business Console o la API para:

Revisar las transacciones marcadas con todo su contexto (puntuaciones, reglas coincidentes, partes vinculadas)
Abrir casos de investigación y asignar analistas
Seguir el rendimiento de los analistas y los tiempos de resolución
Exportar los datos de las transacciones para informes de cumplimiento

Análisis de cripto

Para las transacciones con criptomonedas, Didit analiza automáticamente las direcciones de wallet y los hashes de transacción con proveedores de analítica blockchain (Crystal, Merkle Science y otros). El análisis se ejecuta en el servidor durante la creación de la transacción, sin llamadas adicionales a la API por tu parte. Cada análisis genera una puntuación de riesgo estandarizada, un análisis del origen de los fondos con desglose por categorías de exposición, tablas de exposición y un grafo de red interactivo. Los resultados alimentan directamente el motor de reglas: reglas predefinidas como “Contraparte sancionada” y “Exposición a mercados de la darknet” se activan automáticamente. Consulta el análisis de cripto para ver los detalles de los proveedores, los precios, las categorías de exposición y la visualización de la red.

Capacidades clave

Capacidad	Descripción
Puntuación en tiempo real	Cada transacción se puntúa al instante con todas las reglas activas
Biblioteca de reglas integrada	Reglas preconfiguradas para AML/CTF, fraude, cripto, juego responsable y analítica blockchain
Reglas personalizadas	Crea reglas desde la consola con condiciones, ventanas de velocidad, ámbitos y acciones automáticas
Análisis de cripto	Análisis automático de wallets y transacciones mediante Crystal, Merkle Science y otros
Análisis del origen de los fondos	Desglose del origen de los fondos: exchanges, mixers, entidades sancionadas, estafas
Conexiones de contrapartes	Vista a nivel de entidad de con quién ha transaccionado la wallet
Grafo de red	Grafo visual interactivo de las relaciones de la wallet y los flujos de fondos
Cumplimiento de la regla de viaje	Seguimiento de los datos del ordenante y del beneficiario, los detalles del protocolo y el estado de la obligación en transferencias de activos virtuales
Flujos de subsanación	Activa automáticamente la verificación del usuario cuando una regla exige comprobaciones adicionales
Gestión de casos	Abre casos, vincula alertas y transacciones, asigna analistas y adjunta pruebas
Ajustes configurables	Ajusta los umbrales de puntuación, la divisa por defecto, las preferencias de proveedor y los flujos de subsanación por aplicación
Webhooks	Recibe en tiempo real los eventos `transaction.created`, `transaction.updated`, `transaction.status.changed` y `transaction.alert.generated` mediante webhooks

Integración

Envía las transacciones por la API y recibe los resultados por webhooks:

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "finance0001",
    "transaction_category": "finance",
    "transaction_details": {
      "direction": "outbound",
      "amount": "1200.00",
      "currency": "EUR"
    },
    "subject": { "entity_type": "person", "vendor_data": "user-123", "full_name": "John Doe" },
    "counterparty": { "entity_type": "person", "full_name": "Jane Doe" }
  }'

Consulta la referencia de la API para ver el esquema completo del payload.

Siguientes pasos

Envío de transacciones

Referencia completa del payload de la API Create Transaction.

Reglas y puntuación

Cómo funciona el motor de reglas, los paquetes integrados y la creación de reglas personalizadas.

Ingesta de eventos

Envía inicios de sesión, partidas, bonos, pagos y disputas al mismo motor.

Análisis de cripto

Análisis de wallets, origen de los fondos y visualización de la red.

Regla de viaje

Datos de cumplimiento de la regla de viaje para transferencias de activos virtuales.

Casos e investigaciones

Abre casos, asigna analistas y gestiona los flujos de investigación.

Ajustes

Umbrales de puntuación, proveedores y configuración de la subsanación.

​Cómo funciona

​Análisis de cripto

​Capacidades clave

​Integración

​Siguientes pasos

Envío de transacciones

Reglas y puntuación

Ingesta de eventos

Análisis de cripto

Regla de viaje

Casos e investigaciones

Ajustes

Cómo funciona

Análisis de cripto

Capacidades clave

Integración

Siguientes pasos