> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# API de monitorización de transacciones (KYT)

> Didit analiza cada transacción en tiempo real con reglas, puntuación de riesgo, velocidad, AML y gestión de casos. $0.02 por transacción, sin contratos.

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.

[Detecta el fraude en tiempo real: el motor de reglas — Didit Academy](https://www.youtube.com/embed/Yhm63_n7HuU?rel=0\&playsinline=1)

Si eres nuevo en Didit TM, empieza con el [inicio rápido](https://docs.didit.me/es/transaction-monitoring/quickstart.md) para una configuración de 10 minutos y después lee la [guía de integración](https://docs.didit.me/transaction-monitoring/integration-guide.md) para conocer la arquitectura y los patrones de producción. La [puntuación de riesgo](https://docs.didit.me/transaction-monitoring/risk-scoring.md) explica con exactitud cómo se calculan las puntuaciones.

## Cómo funciona

**1. Envía una transacción**

Envía los datos de la transacción mediante la API [Create Transaction](https://docs.didit.me/management-api/transactions/create.md). 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](https://docs.didit.me/transaction-monitoring/transactions.md) para ver la referencia completa del payload.

**2. 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.

**3. 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.

**4. 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](https://docs.didit.me/transaction-monitoring/aml-screening.md) 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](https://docs.didit.me/integration/webhooks.md) |

## Integración

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

```bash theme={null}
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](https://docs.didit.me/management-api/transactions/create.md) para ver el esquema completo del payload.

## Siguientes pasos

> **[Envío de transacciones](https://docs.didit.me/transaction-monitoring/transactions.md)**
>
> Referencia completa del payload de la API Create Transaction.

> **[Reglas y puntuación](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> Cómo funciona el motor de reglas, los paquetes integrados y la creación de reglas personalizadas.

> **[Ingesta de eventos](https://docs.didit.me/transaction-monitoring/events.md)**
>
> Envía inicios de sesión, partidas, bonos, pagos y disputas al mismo motor.

> **[Análisis de cripto](https://docs.didit.me/transaction-monitoring/aml-screening.md)**
>
> Análisis de wallets, origen de los fondos y visualización de la red.

> **[Regla de viaje](https://docs.didit.me/transaction-monitoring/travel-rule.md)**
>
> Datos de cumplimiento de la regla de viaje para transferencias de activos virtuales.

> **[Casos e investigaciones](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> Abre casos, asigna analistas y gestiona los flujos de investigación.

> **[Ajustes](https://docs.didit.me/transaction-monitoring/settings.md)**
>
> Umbrales de puntuación, proveedores y configuración de la subsanación.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.