Los 11 Paquetes de Reglas de Monitoreo de Transacciones, Explicados (ES)

Un motor de monitoreo de transacciones es tan bueno como las reglas que lo rigen. Si empiezas con un libro de reglas en blanco, pasarás meses codificando umbrales de estructuración, ventanas de velocidad y lógica de sanciones antes de detectar tu primer pago sospechoso. Peor aún, si la política es sutilmente incorrecta, ahogarás a los analistas en falsos positivos o pasarás por alto los patrones importantes.

La API de Monitoreo de Transacciones de Didit incluye 11 paquetes de reglas ya integrados. Activas los que se ajustan a tu negocio, ajustas sus umbrales en la Consola y añades tus propias reglas. Cada transacción se puntúa en tiempo real contra cada regla activa y se resuelve en uno de cuatro estados — APPROVED, IN_REVIEW, DECLINED, o AWAITING_USER — a $0.02 por transacción.

Esta guía detalla los 11 paquetes: qué detecta cada uno, los patrones que puntúa y cómo ajustarlo.

Puntos clave

• 11 paquetes integrados cubren finanzas, AML/CTF, detección de anomalías, indicadores de alerta del GAFI, inteligencia de dispositivos, fraude, monitoreo de criptomonedas, screening de criptomonedas, juego responsable, comercio electrónico y un paquete totalmente personalizado.
• No empiezas de cero. Cada paquete es un conjunto curado de reglas que activas y ajustas, no código que escribes.
• Cada regla tiene una acción — añadir a la puntuación de riesgo, cambiar el estado, añadir etiquetas o notas, o añadir una parte a una lista — de modo que la política es declarativa y se revisa en la Consola.
• Las reglas se ejecutan en tiempo real contra la API unificada /v3/; las transacciones se resuelven en APPROVED, IN_REVIEW, DECLINED, o AWAITING_USER.
• $0.02 por transacción, pago por llamada, sin mínimos. El screening AML de una parte marcada se factura por separado a $0.20 por verificación.

Qué son los paquetes de reglas

Un paquete es un grupo temático de reglas. En lugar de exponer cientos de reglas individuales, Didit las organiza en torno al riesgo que realmente enfrenta un negocio determinado: un neobanco activa Finanzas y AML/CTF, un intercambio de criptomonedas añade monitoreo y screening de criptomonedas, un operador de iGaming añade Juego responsable. Los paquetes se superponen deliberadamente: una contraparte sancionada es detectada por AML/CTF, ya sea que el pago sea fiduciario o cripto.

Dentro de cada paquete, las reglas individuales tienen condiciones (umbrales de cantidad, atributos de la contraparte, listas de jurisdicciones), ventanas de velocidad opcionales y una acción. La acción es lo que hace que el motor sea declarativo: una regla puede añadir a la puntuación de riesgo de la transacción, cambiar su estado a IN_REVIEW o DECLINED, adjuntar etiquetas o notas para un analista, o añadir la parte a una lista para futuras investigaciones.

Por qué es importante

Los reguladores esperan un monitoreo basado en el riesgo y documentado. Las directivas AML de la UE, las recomendaciones del GAFI y regímenes equivalentes en todo el mundo requieren que las empresas reguladas detecten e informen actividades sospechosas, y que demuestren su funcionamiento. Un montón de reglas personalizadas en el código de la aplicación es difícil de auditar y más difícil de cambiar sin una implementación.

Los paquetes resuelven ambos problemas. Debido a que están curados contra tipologías conocidas, comienzas con cobertura el primer día en lugar del tercer mes. Debido a que se gestionan en la Consola en lugar de enviarse en código, el cumplimiento revisa cada cambio de umbral, y el libro de reglas es auditable por diseño.

Detalles técnicos

Las transacciones se crean contra la API unificada /v3/. Cada una es idempotente en un transaction_id que controlas, por lo que los reintentos nunca duplican el conteo.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_4d21a8",
    "category": "finance",
    "amount": 9700,
    "currency": "EUR",
    "currency_kind": "fiat",
    "txn_date": "2026-05-21T11:04:00Z",
    "subject": { "vendor_data": "user_8842", "role": "SENDER", "entity_type": "INDIVIDUAL" },
    "counterparty": { "role": "RECEIVER", "entity_type": "INDIVIDUAL" },
    "payment_method": "BANK_TRANSFER"
  }'

El motor evalúa la transacción contra cada regla activa en cada paquete activo y devuelve el estado más las reglas que se activaron, etiquetadas con su paquete:

{
  "transaction_id": "txn_4d21a8",
  "status": "IN_REVIEW",
  "risk_score": 58,
  "triggered_rules": [
    { "name": "Threshold avoidance", "bundle": "Finance", "action": "ADD_SCORE" },
    { "name": "High velocity — sender 24h count", "bundle": "Anomaly detection", "action": "CHANGE_STATUS" }
  ],
  "alert_id": "alrt_91bc02"
}

Precio. $0.02 por transacción, facturado por llamada, sin mínimos. Si una transacción marcada activa el screening AML de una parte, esa verificación se factura por separado a $0.20.

Los 11 paquetes, uno por uno

1. Finanzas — el paquete central de pagos fiduciarios. Detecta estructuración (dividir una gran suma en pagos más pequeños para evitar un umbral de reporte), grandes transacciones individuales y evasión de umbrales. Ajusta el umbral de reporte a tu jurisdicción (€10,000 en gran parte de la UE) y establece el margen por debajo de este que consideras sospechoso.

1. AML/CTF — antilavado de dinero y financiación del terrorismo. Detecta volumen acumulado durante una ventana, movimiento rápido de entrada y salida, exposición a partes sancionadas, exposición a PEP y transacciones que involucran jurisdicciones de alto riesgo. Ajusta las listas de jurisdicciones y las ventanas de volumen acumulado. Cuando una parte activa una regla de sanciones o PEP, puedes encadenar el screening AML a $0.20 por verificación.

1. Detección de anomalías — valores atípicos de comportamiento. Detecta picos de velocidad, reactivación de cuentas inactivas y cantidades o contrapartes que se desvían del patrón establecido de un usuario. Ajusta las ventanas de velocidad (conteo, suma, distintos) y la sensibilidad de la línea base.

1. GAFI — patrones alineados con los indicadores de alerta del GAFI para el lavado de dinero y la financiación del terrorismo. Úsalo como una capa orientada al regulador sobre Finanzas y AML/CTF; ajusta qué familias de indicadores de alerta se aplican a tus productos.

1. Inteligencia de dispositivos — huella digital del dispositivo y señales de riesgo de sesión adjuntas a una transacción. Detecta un solo dispositivo detrás de muchas cuentas, geolocalización inconsistente y otras anomalías de sesión. Ajusta el peso que estas señales añaden a la puntuación de riesgo.

1. Prevención de fraude — tipologías de fraude de primera y tercera parte: patrones de mulas, multi-contabilidad y señales de toma de control de cuentas. Ajusta los umbrales de la red de mulas y la agresividad con la que las señales de toma de control cambian el estado.

1. Monitoreo de criptomonedas — patrones de transacciones en cadena para flujos de criptomonedas. Funciona con currency_kind: "crypto" y una dirección. Ajusta los umbrales de exposición que mueven una transacción de IN_REVIEW a DECLINED.

1. Screening de criptomonedas — riesgo de billetera y exposición a la fuente de fondos. Configura currency_kind: "crypto" con una dirección y el motor puede ejecutar automáticamente el screening de billeteras en cadena en la dirección de la contraparte, verificando la exposición a entidades sancionadas, mercados de la darknet, mezcladores, ransomware y fondos robados. El screening de billeteras comienza en $0.02 por screening con tu propia clave (Crystal o Merkle Science).

1. Juego responsable — para operadores de iGaming. Detecta picos de velocidad de depósito, cambios sospechosos de límites y abuso de bonos, utilizando las categorías gambling_bet, gambling_limit_change y gambling_bonus_change. Ajusta las ventanas de velocidad de depósito y los patrones de cambio de límite que tratas como una señal de daño.

1. Comercio electrónico — patrones de contracargos y abuso de reembolsos para mercados y comerciantes. Ajusta los umbrales de velocidad de reembolso y la relación de contracargos.

1. Personalizado — tus propias reglas construidas sobre el resto. Expresa condiciones, ventanas de velocidad (conteo, suma, distintos) y cualquiera de las acciones estándar. Úsalo para tipologías específicas del producto que los paquetes preestablecidos no cubren.

Cómo funciona el ajuste

El ajuste se realiza en la Consola de Negocios, no en el código. Para cada regla activa, estableces los umbrales, las ventanas de velocidad y la acción, y el cambio se revisa allí antes de que entre en vigor. Esto mantiene el cumplimiento en control de la política y te proporciona un registro de auditoría de cada cambio. Debido a que las reglas puntúan en tiempo real, puedes aumentar la sensibilidad durante una ola de fraude conocida y reducirla después sin una implementación.

Casos de uso

• Fintech — Finanzas + AML/CTF + Detección de anomalías cubren estructuración, volumen acumulado y picos de velocidad en depósitos, transferencias y retiros.
• Cripto — Monitoreo de criptomonedas + Screening de criptomonedas añaden detección de patrones en cadena y screening automático de billeteras en las direcciones de las contrapartes.
• Préstamos — Detección de anomalías + Prevención de fraude detectan patrones de identidad sintética y mulas en desembolsos y reembolsos.
• Mercados — Comercio electrónico + Prevención de fraude detectan abuso de reembolsos, redes de contracargos y multi-contabilidad.
• iGaming — Juego responsable + Detección de anomalías detectan picos de velocidad de depósito, abuso de cambios de límite y abuso de bonos.

Cómo integrarse con Didit

1. Elige tus paquetes. En la Consola de Negocios, activa los paquetes que se ajustan a tu negocio y ajusta sus umbrales.
2. Envía transacciones. POST /v3/transactions/ desde tu backend a medida que se mueve el dinero. Utiliza un transaction_id estable para la idempotencia y pasa vendor_data para que las transacciones se vinculen al usuario o entidad comercial a la que pertenecen.
3. Maneja webhooks. Escucha transaction.created y transaction.status.updated para mantener tu libro mayor sincronizado a medida que los analistas resuelven las alertas.
4. Añade reglas personalizadas. Superpón el paquete Personalizado para tipologías únicas de tu producto.

Dado que todo está en la API unificada /v3/, una sesión KYB puede generar las sesiones KYC para sus UBOs, esos usuarios fluyen al monitoreo de transacciones, y una transacción marcada puede generar un KYC de remediación — una plataforma de identidad y fraude, de principio a fin.

Preguntas frecuentes

¿Tengo que usar los 11 paquetes?

No. Activa solo los paquetes relevantes para tu negocio y ajusta sus umbrales. El resto permanecen desactivados.

¿Puedo escribir mis propias reglas?

Sí. El paquete Personalizado te permite construir reglas con condiciones, ventanas de velocidad y agregaciones sobre los 11 paquetes preestablecidos. Las reglas se gestionan en la Consola para que el cumplimiento revise cada cambio.

¿Cuánto cuesta?

$0.02 por transacción, facturado por llamada sin mínimos. El screening AML de una parte marcada se factura por separado a $0.20 por verificación, y el screening de billeteras en cadena comienza en $0.02 por screening con tu propia clave.

¿Cómo manejan los paquetes las criptomonedas?

Configura currency_kind a crypto con una dirección. El monitoreo de criptomonedas puntúa los patrones en cadena y el screening de criptomonedas puede ejecutar automáticamente el screening de billeteras en la dirección de la contraparte.

¿Dónde cambio un umbral?

En la Consola de Negocios. Los cambios de reglas se realizan y revisan allí en lugar de enviarse en código, lo que mantiene el libro de reglas auditable.

¿Listo para empezar?

Lee la descripción general de Monitoreo de Transacciones en la documentación, mira cómo se integra con el resto de la plataforma en la página del producto Monitoreo de Transacciones, y consulta los precios transparentes por llamada en la página de precios. Cuando estés listo, comienza gratis — 500 verificaciones KYC gratuitas cada mes, y monitoreo de transacciones a $0.02 por llamada.