> ## 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.

# Biblioteca de reglas KYT: 150+ escenarios predefinidos

> Didit: 150+ reglas KYT para estructuración, velocidad, layering, sanciones, cripto, Travel Rule e iGaming. 1,000/mes incluidas, luego $0.001 c/u.

Didit ofrece una biblioteca seleccionada de **más de 150 reglas predefinidas de monitorización de transacciones** que puedes instalar una a una o por paquetes. Cada regla corresponde a una tipología real de AML, fraude o cumplimiento extraída de estándares globales y orientaciones regulatorias: recomendaciones del FATF, avisos de FinCEN, reglas de NACHA, principios de Wolfsberg, tipologías del Egmont Group y patrones de abuso en iGaming.

Elige las reglas predefinidas o los paquetes que necesites y después controla el modo de cada regla instalada (`ACTIVE`, `TEST` o `DISABLED`). Las condiciones, los umbrales y las acciones de las reglas predefinidas son fijos; crea una regla personalizada cuando necesites una lógica distinta. Desinstala una regla predefinida para eliminarla de la aplicación y vuelve a instalarla más adelante si la necesitas.

> [!NOTE]
>
> Puedes explorar, instalar y desinstalar las reglas de la biblioteca desde *Transactions -> Rules -> Library* en la Business Console, mediante la [API de la biblioteca de reglas](https://docs.didit.me/es/management-api/transactions/rules-library.md) (`GET /v3/transactions/rules/library/`, `POST`/`DELETE /v3/transactions/rules/install/`) o con las [herramientas MCP](https://docs.didit.me/es/integration/mcp/tools.md) `didit_transaction_rule_library_list` / `didit_transaction_rule_install` / `didit_transaction_rule_uninstall`. Las reglas predefinidas instaladas solo admiten cambios de `mode` (activar, desactivar, probar); sus umbrales son fijos: para cambiar uno, crea una [regla personalizada](https://docs.didit.me/es/transaction-monitoring/rules.md#creación-de-reglas-personalizadas). Para saber cómo contribuyen las reglas a la puntuación, consulta [puntuación de riesgo](https://docs.didit.me/es/transaction-monitoring/risk-scoring.md).

> [!NOTE]
>
> Una regla de la biblioteca cuyas condiciones requieren datos que el motor de reglas todavía no puede evaluar queda **no disponible** hasta que pueda ejecutarse: la biblioteca no la muestra, una solicitud que la incluya en `library_keys` responde `400` y no instala nada (en cambio, una clave desconocida se omite), y una instalación por `bundle` la omite. Una copia que hayas instalado antes se desactiva (`DISABLED`) y permanece en tu lista de reglas, y si cambias su `mode` a cualquier otro valor, la solicitud devuelve `400`. Una regla que no estaba disponible vuelve a estar disponible por sí sola en cuanto el motor de reglas puede evaluar sus condiciones, de modo que la lista de la biblioteca siempre muestra las reglas que puedes instalar hoy.

## Cómo se organizan las reglas predefinidas

Cada regla predefinida pertenece a un **paquete** (su familia funcional) y a una **categoría** (su temática de riesgo más amplia). Los paquetes te permiten activar o desactivar juntas reglas relacionadas desde la consola; las categorías determinan la puntuación y los informes.

| Paquete | Qué cubre |
| - | - |
| `finance` | Estructuración, transacciones de gran importe, volumen acumulado, dispersión entre países, estratificación (layering), concentración de fondos en cuentas mula (fan-in), pitufeo (smurfing) |
| `aml_ctf` | Sanciones, referencias de pago sospechosas, estratificación con importes redondos, entradas y salidas rápidas |
| `aml_monitoring` | Exposición al origen de los fondos de alto riesgo derivada de blockchain, financiación del terrorismo, explotación infantil |
| `anomaly_detection` | Velocidad elevada, reactivación de cuentas inactivas, actividad fuera de horario |
| `fatf` | Exposición a jurisdicciones de alto riesgo |
| `device_intelligence` | Reutilización de huellas de dispositivo, cuentas con varias huellas, anomalías de IP o navegador, VPN/proxy, viajes imposibles |
| `fraud_prevention_multi_accounting` | Huellas compartidas entre sujetos distintos |
| `fraud_prevention_app` | Señales de pagos push autorizados / primer pago a un beneficiario / víctimas de estafas |
| `fraud_prevention_ato` | Señales combinadas de toma de control de cuentas (cambio de datos personales, nuevo método de pago) |
| `fraud_prevention_consortium` | Contrapartes marcadas por otras instituciones de la red compartida |
| `crypto_monitoring` | Exposición a wallets de mezcladores, de la darknet o sancionadas, saltos entre cadenas (chain hopping), wallets sin custodia, carencias de VASP |
| `travel_rule` | Obligaciones globales y regionales de la Travel Rule (12 regímenes) y diligencia debida del VASP de la contraparte |
| `travel_rule_eu_tfr` | Controles del TFR de la UE: discrepancias en los datos de la contraparte, propiedad de la wallet no verificada, VASP de la contraparte no identificado, confirmación expirada |
| `responsible_gaming` | Límites de depósito y retirada para un juego más seguro, autoexclusión, juego fuera de horario |
| `igaming_fraud` | Abuso de bonos basado en eventos, apuestas opuestas, fraude de afiliados, chat rain farming, chip dumping, toma de control de cuentas |
| `e_commerce` | Microtransacciones de prueba de tarjetas, indicadores de contracargos, discrepancia del país de facturación, ráfagas de afiliados |
| `check_fraud` | Cheques fuera de rango / sin número / presentados por duplicado / en listas de vigilancia de la dark web / lavados, kiting de cheques |
| `bnpl` | Fraude de primera parte por impago de cuotas, identificadores compartidos entre cuentas BNPL, pagos a plazos con cuentas recién creadas |

## Cómo leer esta página

Cada regla indica su `library_key` (identificador estable que puedes usar en la API o en la URL de la consola), las condiciones y la agregación que la activan, y las acciones que aplica por defecto. Los umbrales numéricos que se muestran aquí son los valores predeterminados incluidos: cada valor se puede editar por aplicación sin que la regla pierda su identidad.

***

## Paquete de finanzas

Estas reglas se aplican a toda transacción con `transaction_type = FINANCE`. Reflejan el marco regulatorio de referencia (umbrales de reporte de la BSA/FinCEN, heurísticas de velocidad del GAFI/FATF), además de patrones de mulas de dinero y pitufeo (smurfing).

### Estructuración y montos cercanos al umbral

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `structuring-inbound` | ≥20 transferencias entrantes de menos de \$10,000 del mismo sujeto en 30 días | +35 de puntuación |
| `structuring-outbound` | ≥20 transferencias salientes de menos de \$10,000 del mismo sujeto en 30 días | +35 de puntuación |
| `single-transaction-just-below-threshold` | Una única transacción de entre $9,000 y $9,999 | +25 de puntuación |
| `round-amount-layering` | El monto de la transferencia es un valor redondo sospechoso ($10k, $25k, $50k, $100k, $250k, $500k, \$1M…) | +20 de puntuación |

### Volumen y velocidad

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `large-single-transaction` | Una única transacción ≥ \$25,000 | +50 de puntuación, `IN_REVIEW` |
| `cumulative-outbound-volume` | Volumen saliente ≥ \$100,000 en 30 días | +45 de puntuación, `IN_REVIEW` |
| `cumulative-inbound-volume-90d` | Volumen entrante ≥ \$200,000 en 90 días | +30 de puntuación, `IN_REVIEW` |
| `cumulative-outbound-volume-7d` | Volumen saliente ≥ \$50,000 en 7 días | +30 de puntuación, `IN_REVIEW` |
| `business-4h-inbound-volume` | Volumen entrante de una empresa ≥ \$30,000 en cualquier ventana de 4 horas | +30 de puntuación, `IN_REVIEW` |
| `business-4h-outbound-volume` | Volumen saliente de una empresa ≥ \$30,000 en cualquier ventana de 4 horas | +30 de puntuación, `IN_REVIEW` |
| `high-velocity-inbound` | ≥20 transacciones entrantes en 7 días | +25 de puntuación |
| `high-velocity-outbound` | ≥20 transacciones salientes en 7 días | +25 de puntuación |

### Estratificación, mulas y pitufeo

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `rapid-in-and-out-movement` | Una transacción saliente precedida por una entrante en las 6 horas anteriores | +60 de puntuación, `IN_REVIEW` |
| `cash-deposit-followed-by-withdrawal` | Depósitos en efectivo ≥ \$50,000 en 72 h seguidos de un retiro de efectivo | +30 de puntuación, `IN_REVIEW` |
| `money-mule-fan-in-to-counterparty` | Una contraparte recibe transferencias de ≥5 sujetos distintos en 7 días | +30 de puntuación, `IN_REVIEW` |
| `rapid-repeated-payments-same-counterparty` | ≥5 transferencias salientes a la misma contraparte en 24 horas | +30 de puntuación, `IN_REVIEW` |
| `cross-border-small-amount-velocity` | Un sujeto envía montos de menos de \$1,000 a contrapartes de ≥4 países distintos en 24 h | +30 de puntuación, `IN_REVIEW` |
| `high-risk-jurisdiction-smurfing` | ≥5 transferencias salientes de menos de \$1,000 al mismo país de alto riesgo en 7 días | +30 de puntuación, `IN_REVIEW` |
| `many-unique-counterparties-24h` | El sujeto realiza transacciones con ≥6 contrapartes distintas en 24 h | +30 de puntuación, `IN_REVIEW` |
| `many-unique-payment-methods-7d` | El sujeto alterna entre ≥4 métodos de pago distintos en 7 días | +30 de puntuación, `IN_REVIEW` |
| `counterparty-country-spread-24h` | El sujeto realiza transacciones con contrapartes de ≥4 países distintos en 24 h | +30 de puntuación, `IN_REVIEW` |

### Anomalías de comportamiento

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `dormant-account-reactivation` | Primera transacción ≥ \$1,000 tras ≥365 días de inactividad | +20 de puntuación |
| `off-hours-high-value-finance` | Transferencia de alto valor (≥ \$5,000) marcada como fuera de horario según la configuración regional del sujeto | +25 de puntuación |

***

## Paquete AML / CTF

Estas reglas modelan tipologías clásicas de AML/CTF que no dependen del enriquecimiento con datos de blockchain, por lo que se aplican de forma universal a transferencias fiat y cripto.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `sanctions-counterparty` | La propia wallet analizada está atribuida a una entidad sancionada (`wallet_sanctioned`). La exposición por sí sola no activa la regla | +90 de puntuación, `DECLINED` |
| `sanctions-exposure-review` | La wallet analizada movió fondos hacia o desde entidades sancionadas sin estar sancionada ella misma | +50 de puntuación, `IN_REVIEW` |
| `suspicious-payment-reference` | La referencia del pago contiene palabras clave vinculadas a fondos de origen ilícito | +45 de puntuación, `IN_REVIEW` |
| `high-risk-jurisdiction-exposure` | El país de la contraparte o el país de la dirección IP del sujeto figura en la lista de alto riesgo | +40 de puntuación, `IN_REVIEW` |
| `high-risk-inbound-single` | Transacción entrante ≥ \$20,000 desde un país de alto riesgo | +30 de puntuación, `IN_REVIEW` |
| `high-risk-outbound-single` | Transacción saliente ≥ \$20,000 hacia un país de alto riesgo | +30 de puntuación, `IN_REVIEW` |

La lista predeterminada de jurisdicciones de alto riesgo incluye los territorios incluidos en los llamamientos a la acción del GAFI/FATF y los de regiones en conflicto: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`. Puedes sobrescribir la lista por aplicación.

> [!NOTE]
>
> **Actualmente no se ofrece cobertura de contrapartes PEP.** Ningún proveedor de análisis conectado informa si una contraparte es una persona expuesta políticamente: hoy el campo `pep_counterparty` es `null` en todos los resultados de análisis (consulta [análisis de wallets](https://docs.didit.me/es/transaction-monitoring/wallet-screening.md#respuesta)), por lo que la biblioteca no incluye ninguna regla predefinida de contraparte PEP. Una regla instalada antes de que se retirara esa regla predefinida sigue evaluándose, pero no puede coincidir con un análisis real: elimínala o reemplázala por una regla personalizada si necesitas actuar en función de otra señal.

***

## Paquete de análisis cripto

Estas reglas consumen los datos enriquecidos que genera el análisis cripto de Didit; son especialmente útiles para aplicaciones nativas cripto y de VASP.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `aml-high-risk-source-exposure` | ≥30% de los fondos de origen provienen de categorías sancionadas, darknet, fondos robados, ransomware o estafa | +70 de puntuación, `IN_REVIEW` |
| `aml-multiple-risky-counterparties` | ≥3 conexiones con entidades de alto riesgo en el grafo de origen de los fondos | +50 de puntuación, `IN_REVIEW` |
| `aml-terrorist-financing-exposure` | Cualquier exposición a financiación del terrorismo en la wallet | +100 de puntuación, `DECLINED` |
| `aml-child-exploitation-exposure` | Cualquier exposición a material de explotación infantil en la wallet | +100 de puntuación, `DECLINED` |
| `aml-wallet-risk-score-medium` | Puntuación de riesgo de la wallet según el proveedor entre 40 y 70 | +30 de puntuación |

***

## Paquete de monitorización cripto

Reglas de exposición a nivel de wallet, además de controles de integridad de VASP y relacionados con la Travel Rule.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `crypto-mixer-exposure` | Wallet vinculada a un mezclador o a un servicio de ofuscación | +80 de puntuación, `IN_REVIEW` |
| `crypto-darknet_market-exposure` | Exposición a wallets de mercados de la darknet | +80 de puntuación, `IN_REVIEW` |
| `crypto-sanctioned-exposure` | Exposición a wallets sancionadas | +90 de puntuación, `IN_REVIEW` |
| `crypto-stolen_funds-exposure` | Exposición a wallets con fondos robados | +85 puntos, `IN_REVIEW` |
| `crypto-scam-exposure` | Exposición a wallets vinculadas a estafas | +70 de puntuación, `IN_REVIEW` |
| `crypto-ransomware-exposure` | Exposición a wallets de ransomware | +90 de puntuación, `IN_REVIEW` |
| `crypto-hacked_exchange-exposure` | Exposición a wallets de exchanges hackeados | +80 de puntuación, `IN_REVIEW` |
| `crypto-gambling_unlicensed-exposure` | Exposición a wallets de juego sin licencia | +60 de puntuación, `IN_REVIEW` |
| `high-risk-wallet-exposure` | El riesgo de la wallet está relacionado con mercados de la darknet, sanciones o fondos robados | +70 de puntuación, `IN_REVIEW` |
| `crypto-wallet-risk-score-critical` | Puntuación de la wallet del proveedor ≥ 90 | +90 de puntuación, `IN_REVIEW` |
| `crypto-wallet-risk-score-high` | Puntuación de la wallet del proveedor ≥ 70 | +60 de puntuación, `IN_REVIEW` |
| `crypto-unhosted-wallet-large-outbound` | Transferencia saliente ≥ \$1,000 a una wallet sin custodia | +45 de puntuación, `IN_REVIEW` |
| `crypto-repeated-unhosted-wallet-withdrawals` | ≥5 transferencias salientes a wallets sin custodia en 24 h | +35 puntos, `IN_REVIEW` |
| `crypto-many-new-wallets-per-subject` | El sujeto envía fondos a ≥5 wallets distintas en 24 h | +40 de puntuación, `IN_REVIEW` |
| `crypto-chain-hopping-pattern` | El mismo sujeto mueve fondos entre ≥3 blockchains en 24 h | +45 de puntuación, `IN_REVIEW` |
| `crypto-missing-vasp-id-high-value` | Transferencia de wallet custodiada ≥ \$1,000 sin identificador de VASP | +30 de puntuación, `IN_REVIEW` |

***

## Paquete de Travel Rule

Las reglas de Travel Rule se aplican solo a transacciones `travelRule`.
Cada régimen regional incluye cuatro reglas (contraparte pendiente, acción pendiente, datos faltantes, intercambio fallido).

### Travel Rule global

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `travel-rule-pending-counterparty` | El estado es `AWAITING_COUNTERPARTY` (a la espera del VASP de la contraparte) | +35 de puntuación, `IN_REVIEW` |
| `travel-rule-pending-action` | El estado es `ON_HOLD` (en un exchange gestionado, una transferencia entrante que espera que tú la resuelvas: no hay coincidencia en la libreta de direcciones de wallets, o una consulta espera aprobación manual) | +35 de puntuación, `AWAITING_USER` |
| `travel-rule-missing-required-data` | `travel_rule_required` es `true` y `travel_rule_obligations_count` es mayor que `0`; solo los datos de Travel Rule que registras tú mismo en `travel_rule_details` llevan un recuento de obligaciones, por lo que esta regla nunca se dispara en una transferencia que gestiona el exchange | +50 de puntuación, `IN_REVIEW` |

### Regímenes regionales

La misma plantilla de cuatro reglas se aplica a cada régimen. Sustituye `<regime>` a continuación por cualquiera de estos valores: `australia`, `dubai`, `eu`, `hong_kong`, `india`, `indonesia`, `japan`, `kazakhstan`, `singapore`, `south_africa`, `turkey`, `uk`.

El etiquetado del régimen es automático: Didit asigna `custom_values.travel_rule_regime` a cada transacción de Travel Rule a partir del campo `jurisdiction` de tu [configuración de Travel Rule](https://docs.didit.me/es/transaction-monitoring/travel-rule.md#configuración): `SG` → `singapore`, `GB` → `uk`, y cualquier código de un Estado miembro de la UE o del EEE, como `DE` o `FR` → `eu`. Los códigos sin un paquete regional se asignan en minúsculas (`US` → `us`), para que las reglas personalizadas puedan seguir aplicándose a ellos. Un valor `props.travel_rule_regime` enviado en la transacción siempre prevalece sobre el régimen derivado.

| Plantilla de `library_key` | Disparador |
| - | - |
| `travel-rule-<regime>-pending-counterparty` | Transferencia etiquetada con un régimen a la espera del VASP de la contraparte |
| `travel-rule-<regime>-pending-action` | La transferencia etiquetada con un régimen está en `ON_HOLD` |
| `travel-rule-<regime>-missing-required-data` | La transferencia etiquetada con un régimen es obligatoria pero no está resuelta |
| `travel-rule-<regime>-failed-exchange` | La transferencia etiquetada con un régimen está en `CANCELLED` |

Son 48 reglas específicas por región, además de las tres reglas globales de Travel Rule y las cinco reglas de contraparte que se describen a continuación.
El paquete independiente `travel_rule_eu_tfr` añade cuatro reglas del TFR de la UE, descritas en [Paquete de reglas EU TFR](https://docs.didit.me/es/transaction-monitoring/travel-rule.md#paquete-de-reglas-eu-tfr).

### Diligencia debida de la contraparte

Estas reglas leen lo que tu aplicación sabe sobre el VASP de la contraparte con el que se puso en contacto el exchange: tu propia decisión sobre él, su nivel de riesgo según la diligencia debida, su país y su capacidad de respuesta.
Consulta [Diligencia debida de la contraparte](https://docs.didit.me/es/transaction-monitoring/travel-rule.md#diligencia-debida-de-contrapartes) para saber de dónde procede cada valor.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `travel-rule-counterparty-blocked` | Tu decisión sobre la contraparte (`counterparty_dd_status`) es `BLOCKED` | +90 de puntuación, `DECLINED` |
| `travel-rule-counterparty-restricted` | Tu decisión sobre la contraparte es `RESTRICTED` | +50 de puntuación, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk` | El nivel de riesgo de la contraparte (`counterparty_risk_level`) es `HIGH`: una puntuación de diligencia debida inferior a 40, o tu propio análisis reciente de la contraparte encontró una posible coincidencia en sanciones o medios adversos | +40 de puntuación, `IN_REVIEW` |
| `travel-rule-counterparty-high-risk-jurisdiction` | La contraparte está establecida en un país de la lista predeterminada de alto riesgo (`IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR`) | +60 de puntuación, `IN_REVIEW` |
| `travel-rule-counterparty-unresponsive` | La contraparte respondió a menos del 10 por ciento de las solicitudes de Travel Rule que le enviaron los clientes de Didit en los últimos 90 días, con una decisión tomada en al menos 5 de ellas | +30 de puntuación, `IN_REVIEW` |

***

## Inteligencia de dispositivos y prevención del fraude

Estas reglas convierten las señales del SDK de cliente (huella digital del dispositivo, dirección IP, navegador, antigüedad de la sesión) y el enriquecimiento proporcionado por los proveedores en eventos de detección de fraude.

### Huella digital del dispositivo y multicuentas

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `multi-accounting-shared-fingerprint` | Una misma huella digital de dispositivo reutilizada por ≥3 sujetos distintos en 7 días | +50 de puntuación, `IN_REVIEW` |
| `multiple-device-fingerprints-for-same-subject` | Un mismo sujeto aparece en ≥3 huellas digitales distintas en 24 h | +20 de puntuación |
| `same-fingerprint-transaction-burst` | ≥6 transacciones desde una misma huella digital en 24 h | +30 de puntuación |
| `same-ip-multi-accounting` | Una misma dirección IP compartida por ≥3 sujetos distintos en 7 días | +30 de puntuación |
| `same-ip-transaction-burst` | ≥6 transacciones desde una misma dirección IP en 24 h | +30 de puntuación |
| `same-fingerprint-multiple-payment-methods` | Una misma huella digital alterna entre ≥4 métodos de pago en 7 días | +30 de puntuación |
| `shared-payment-method-across-subjects` | Un mismo método de pago reutilizado por ≥3 sujetos distintos en 7 días | +30 de puntuación |
| `many-ip-addresses-per-subject` | El sujeto usa ≥4 direcciones IP distintas en 24 h | +30 de puntuación |
| `new-browser-and-new-ip-combination` | El sujeto presenta ≥3 navegadores distintos Y ≥3 direcciones IP distintas en 24 h | +30 de puntuación |

### IP, red y VPN

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `vpn-or-proxy-high-value` | VPN o proxy detectado en una transferencia ≥ \$5,000 | +30 de puntuación |
| `impossible-travel-between-transactions` | El sujeto realiza transacciones desde ≥2 países distintos asociados a direcciones IP en 1 hora | +30 de puntuación |

### Señales de comportamiento combinadas

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `browser-spoofing-password-reuse` | Suplantación de navegador detectada Y ≥2 transacciones que reutilizan el mismo hash de contraseña en 30 minutos | +30 de puntuación |
| `remote-access-high-value-transfer` | Herramienta de acceso remoto detectada en una transferencia ≥ \$5,000 | +30 de puntuación |
| `low-session-age-high-value-transfer` | Transferencia ≥ \$5,000 en los 30 segundos posteriores al inicio de la sesión | +30 de puntuación |
| `synthetic-identity-fresh-account-high-value` | Una cuenta abierta en los últimos 7 días realiza transacciones por un importe ≥ \$1,000 | +30 de puntuación |

### Toma de control de cuentas y fraude APP

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `recent-pii-change-and-transaction` | Transferencia ≥ \$1,000 dentro de la ventana de cambio reciente de PII | +45 de puntuación, `IN_REVIEW` |
| `new-payment-method-high-value` | Transferencia ≥ \$5,000 con un método de pago añadido en los últimos 7 días | +30 de puntuación |
| `first-time-payee-high-value` | Transferencia saliente ≥ \$5,000 hacia una contraparte a la que el sujeto nunca ha pagado antes | +40 de puntuación, `IN_REVIEW` |
| `consortium-flagged-counterparty` | Transferencia ≥ \$500 cuya contraparte fue reportada por otra institución | +60 de puntuación, `IN_REVIEW` |

### Abuso de afiliados y bonos

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `repeated-bonus-campaign-from-same-fingerprint` | ≥6 transacciones con la misma campaña + huella digital en 2 h | +35 de puntuación |
| `shared-fingerprint-across-bonus-campaigns` | Una misma huella digital se acoge a ≥3 campañas distintas en 7 días | +30 de puntuación |
| `affiliate-fraud-repeated-fingerprint` | ≥5 transacciones con el mismo afiliado + huella digital en 2 h | +30 de puntuación |

***

## Paquete de juego responsable

Para aplicaciones de iGaming. Estas reglas están diseñadas para detectar tanto señales de protección del jugador como patrones de abuso de bonos.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `responsible-gaming-rapid-deposits` | ≥10 transacciones entrantes de la misma acción en 24 h | +20 de puntuación |
| `responsible-gaming-rapid-withdrawals` | ≥8 transacciones salientes de la misma acción en 24 h | +20 de puntuación |
| `responsible-gaming-cumulative-deposits-7d` | Volumen entrante ≥ \$5,000 en 7 días | +20 de puntuación |
| `responsible-gaming-cumulative-withdrawals-7d` | Volumen saliente ≥ \$5,000 en 7 días | +20 de puntuación |
| `responsible-gaming-self-excluded-activity` | Cualquier transacción desde una cuenta autoexcluida | +20 de puntuación |
| `responsible-gaming-loss-limit-hit` | La actividad continúa después de una señal de límite de pérdidas | +20 de puntuación |
| `responsible-gaming-bonus-hunting` | ≥4 transacciones con la misma campaña + misma huella digital en 24 h | +20 de puntuación |
| `responsible-gaming-multiple-payment-methods` | ≥4 métodos de pago distintos en 7 días | +20 de puntuación |
| `responsible-gaming-off-hours-high-value` | Actividad de juego etiquetada como fuera de horario ≥ \$1,000 | +20 de puntuación |
| `responsible-gaming-failed-withdrawals` | ≥3 intentos de retiro fallidos | +20 de puntuación |
| `responsible-gaming-many-counterparties` | ≥5 contrapartes distintas en 24 h | +20 de puntuación |

***

## Paquete de fraude en iGaming

Para operadores que envían eventos de monitorización además de movimientos de dinero. Estas reglas usan `scope.record_types = ["event"]`, así que los clientes que solo envían transacciones no notan ningún cambio de comportamiento. Cuando existe una regla alternativa basada solo en transacciones, instálala junto a la regla de eventos hasta que tu integración envíe esa categoría de eventos.

| `library_key` | Disparador | Acción predeterminada | Alternativa solo con transacciones |
| - | - | - | - |
| `igaming-account-takeover-drain` | 3+ inicios de sesión fallidos, luego un cambio de MFA, luego un cambio de dirección de retiro y luego una solicitud de retiro, en ese orden y en menos de 24 h | +90 de puntuación, `DECLINED` | `recent-pii-change-and-transaction`, `new-payment-method-high-value` |
| `igaming-minimal-play-laundering` | Solicitud de retiro ≥ \$1,000 cuando las apuestas de la cuenta suman ≤ 5% de sus depósitos completados en las 24 h anteriores | +60 de puntuación, `IN_REVIEW` | `rapid-in-and-out-movement` |
| `igaming-chargeback-deposit-ratio` | Los contracargos abiertos alcanzan al menos el 50% de los depósitos completados en 30 días | +80 de puntuación, `DECLINED` | `ecommerce-chargeback-indicator` |
| `igaming-chip-dumping-pair-net-winner` | El mismo par P2P liquida al menos 2 manos, rondas o partidas distintas en 7 días **y** el resultado neto de una de las partes suma ≥ \$400 | +70 de puntuación, `IN_REVIEW` | Requiere eventos |
| `igaming-opposite-betting-same-market` | Apuestas en ambos lados del mismo partido y mercado realizadas por 2+ cuentas distintas que comparten una huella digital de dispositivo, en menos de 1 h | +65 de puntuación, `IN_REVIEW` | Requiere eventos |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` informa una puntuación de bot ≥ 90 y una variación de tiempos ≤ 10 ms | +55 de puntuación, `IN_REVIEW` | Requiere eventos |
| `igaming-self-exclusion-evasion` | Coincidencia en el registro de autoexclusión con `exclusion_status: active` en un intento de nuevo registro | +100 de puntuación, `DECLINED` | `responsible-gaming-self-excluded-activity` |
| `igaming-chat-rain-farming` | Segunda reclamación del **mismo** bono de chat rain por parte de una cuenta en 24 h, realizada en menos de 500 ms | +45 de puntuación, `IN_REVIEW` | `responsible-gaming-bonus-hunting` |
| `igaming-repeated-bonus-claims-one-device` | Tercera reclamación del **mismo** bono desde una misma huella digital de dispositivo en 7 días | +50 de puntuación, `IN_REVIEW` | `repeated-bonus-campaign-from-same-fingerprint`, `shared-fingerprint-across-bonus-campaigns`, `responsible-gaming-bonus-hunting` |
| `igaming-affiliate-self-referral` | Atribución a un código de afiliado que 3+ cuentas distintas han usado desde una misma huella digital de dispositivo en 7 días | +50 de puntuación, `IN_REVIEW` | `affiliate-fraud-repeated-fingerprint` |
| `igaming-multi-accounting-device` | Inicio de sesión o registro desde una huella digital de dispositivo usada por 3+ cuentas distintas en 24 h | +60 de puntuación, `IN_REVIEW` | `multi-accounting-shared-fingerprint` |
| `igaming-shared-proxy-ip` | Inicio de sesión desde una dirección IP usada por 3+ cuentas distintas en 24 h | +40 de puntuación, `IN_REVIEW` | `same-ip-multi-accounting` |

### Señales de eventos que necesita cada regla

Cada una de las reglas anteriores lee campos de eventos concretos. Cuando falta un campo obligatorio, la regla simplemente no coincide: nunca aproxima la señal a partir de otro dato y nunca recurre por sí sola a los datos de transacciones. Envía las claves siguientes en el `payload` y el `device_context` del evento (consulta [Eventos](https://docs.didit.me/es/transaction-monitoring/events.md) para ver el contrato de envío completo y [Reglas de eventos](https://docs.didit.me/es/transaction-monitoring/event-rules.md) para ver las rutas de campos de las reglas).

| `library_key` | Acciones de evento que lee | Campos que necesita la regla |
| - | - | - |
| `igaming-account-takeover-drain` | `security.login_failed`, `security.mfa_changed`, `payment.withdrawal_address_changed`, `payment.withdrawal_requested` | `changed_field`, `withdrawal_address_hash` y las claves de pago estándar |
| `igaming-minimal-play-laundering` | `payment.withdrawal_requested`, `gameplay.bet_placed`, `payment.deposit_completed` | `amount` en cada uno de esos eventos |
| `igaming-chargeback-deposit-ratio` | `dispute.chargeback_opened`, `payment.deposit_completed` | `payment_reference_id`, más `dispute_id` o `chargeback_id` |
| `igaming-chip-dumping-pair-net-winner` | `gameplay.p2p_settlement` | `counterparty_vendor_data`, `net_result_amount` y uno de `hand_id` / `round_id` / `match_id` |
| `igaming-opposite-betting-same-market` | `gameplay.bet_placed` | `match_id`, `market_id`, `side`, `device_context.fingerprint` |
| `igaming-bot-rta-cadence` | `session.bot_signal_observed` | `device_context.bot_score`, `timing_variance_ms` |
| `igaming-self-exclusion-evasion` | `responsible_gambling.self_exclusion_match` | `exclusion_status`, `re_registration_attempt`, más los obligatorios `registry_source` y `identity_match_ref` |
| `igaming-chat-rain-farming` | `bonus.bonus_claimed` | `bonus_id`, `bonus_type`, `claim_delay_ms` |
| `igaming-repeated-bonus-claims-one-device` | `bonus.bonus_claimed` | `bonus_id`, `device_context.fingerprint` |
| `igaming-affiliate-self-referral` | `affiliate.affiliate_attributed` | `affiliate_code`, `device_context.fingerprint` |
| `igaming-multi-accounting-device` | `security.login_succeeded`, o un `security.registration_attempt` personalizado | `device_context.fingerprint` |
| `igaming-shared-proxy-ip` | `security.login_succeeded` | `device_context.network_context.ip_address` |

Usa el paquete `igaming_fraud` cuando tu integración emita eventos de inicio de sesión, juego, bonos, afiliados, pagos, disputas, seguridad y juego responsable. Las reglas siguen siendo opcionales: añadirlas a la biblioteca no las instala en las aplicaciones existentes ni cambia los presets actuales de ningún cliente activo.

***

## Paquete de comercio electrónico

Para marketplaces y aplicaciones que actúan como comerciante registrado (merchant of record).

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `ecommerce-card-testing-microtransactions` | ≥10 transacciones ≤ \$5 desde la misma huella de dispositivo en 1h | +30 de puntuación |
| `ecommerce-high-order-velocity` | ≥8 transacciones con una misma huella de dispositivo en 30 minutos | +30 de puntuación |
| `ecommerce-chargeback-indicator` | El proveedor o el flujo ha marcado un indicador de contracargo | +30 de puntuación |
| `ecommerce-billing-country-mismatch` | Discrepancia del país de facturación en una transacción ≥ \$500 | +30 de puntuación |
| `ecommerce-shared-payment-method` | Método de pago reutilizado por ≥3 sujetos de comercio electrónico en 7 días | +30 de puntuación |
| `ecommerce-shared-ip-multi-accounting` | Una dirección IP compartida por ≥4 sujetos de comercio electrónico en 24h | +30 de puntuación |
| `ecommerce-remote-checkout-high-value` | Acceso remoto detectado durante el checkout ≥ \$1,000 | +30 de puntuación |
| `ecommerce-affiliate-burst` | ≥5 transacciones con el mismo afiliado y la misma huella de dispositivo en 2h | +30 de puntuación |

***

## Paquete de fraude con cheques

Para aplicaciones que envían transacciones de depósito de cheques. Cada regla se dispara a partir de los indicadores `custom_values.check_*` que establece quien realiza la solicitud cuando un cheque presenta una señal de riesgo conocida (lavado de cheques, MICR ausente, número de serie publicado en la dark web, etc.).

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `check-amount-out-of-range` | Importe del cheque marcado como fuera del rango habitual de la cuenta Y ≥ \$1,000 | +40 de puntuación, `IN_REVIEW` |
| `check-missing-or-invalid-number` | El cheque llegó con un número de cheque ausente, incoherente o no secuencial | +35 de puntuación, `IN_REVIEW` |
| `check-duplicate-presentation` | Parece que el mismo cheque se ha depositado dos veces (depósito móvil + sucursal) | +70 de puntuación, `IN_REVIEW` |
| `check-on-dark-web-watchlist` | El número de serie o la imagen del cheque se encontró en una fuente de cheques robados de la dark web o de Telegram | +90 de puntuación, `DECLINED` |
| `check-altered-or-washed` | El cheque muestra borrado químico, alteración del MICR u otros indicios de lavado | +70 de puntuación, `IN_REVIEW` |
| `check-deposit-rapid-multi-bank` | El mismo sujeto deposita cheques en ≥3 bancos de contraparte distintos en 24h (kiting) | +45 de puntuación, `IN_REVIEW` |

***

## Paquete BNPL

Para proveedores de compra ahora, paga después (BNPL). Detecta patrones de fraude de primera parte (impago) y de uso compartido de identificadores propios de los préstamos a plazos.

| `library_key` | Disparador | Acción predeterminada |
| - | - | - |
| `bnpl-failed-repayment-velocity` | ≥2 pagos de cuotas fallidos recientes del sujeto: señal de fraude de primera parte | +45 de puntuación, `IN_REVIEW` |
| `bnpl-shared-identifier-across-accounts` | El teléfono, el correo electrónico o la dirección se han visto en varios sujetos BNPL distintos | +40 de puntuación, `IN_REVIEW` |
| `bnpl-high-installment-on-fresh-account` | Cuota ≥ \$500 de una cuenta abierta en los últimos 7 días | +35 de puntuación |

***

## Referencia: estándares en los que se basa la biblioteca

Cada preset de la biblioteca de Didit corresponde a una tipología AML, de fraude o de cumplimiento ampliamente aceptada. Estos son los estándares en los que nos apoyamos:

| Fuente | Tipologías aportadas a la biblioteca |
| - | - |
| **Recomendaciones del FATF** | Estructuración, movimiento rápido de fondos, exposición a jurisdicciones de alto riesgo, verificación de contrapartes frente a listas de sanciones |
| **Avisos de FinCEN** | Umbrales de reporte BSA / CTR, reactivación de cuentas inactivas, patrones sospechosos con efectivo |
| **Reglas de NACHA** | Umbrales específicos de ACH y patrones fuera del horario habitual |
| **Principios de Wolfsberg** | Tipologías de banca corresponsal y banca privada |
| **Tipologías del Egmont Group** | Patrones transfronterizos y de estratificación (layering) |
| **Buenas prácticas del sector** | Ventanas de velocidad, viaje imposible, pagos a beneficiarios por primera vez, reutilización de la huella de dispositivo, señales de fraude de primera parte en BNPL |

Didit implementa solo las tipologías que son estándares aceptados del sector y expone todos los umbrales para que los ajustes.

***

## Personalizar los presets

Cada preset puede ser:

* **Ajustado**: cambia umbrales, ventanas, valores de puntuación o acciones por aplicación
* **Desactivado**: cambia un preset al modo `DISABLED` y deja de evaluarse sin perder su identidad
* **Probado**: cambia un preset al modo `TEST` para evaluarlo en modo sombra sin afectar al resultado de las transacciones
* **Ampliado**: crea reglas personalizadas que complementen o sustituyan a los presets

Consulta [Reglas y puntuación](https://docs.didit.me/es/transaction-monitoring/rules.md) para conocer la anatomía de las reglas, los endpoints de la API y ejemplos prácticos de creación de reglas personalizadas.


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