Log antifraude
Requisitos previos de acceso
- Permiso (módulo):
viewAntifraud - Licencia/Feature: Ninguna
- Contenedor del menú: GENERAL → grupo Auditoría
Qué es / cuándo usar
La pantalla Log antifraude (/antifraud-log) lista las transacciones financieras analizadas por el motor antifraude (PIX, Cripto, Conversiones, retiros, transferencias internas/externas y acciones de admin). Para cada operación el sistema calcula un score de riesgo, registra las reglas activadas e indica si la operación fue bloqueada.
Use esta pantalla para investigar transacciones sospechosas, entender por qué una operación fue bloqueada (qué reglas se activaron) y evaluar la liberación/reintento.
Para la referencia completa del motor de reglas, pesos, umbrales de score y arquitectura, consulte Módulo de Antifraude.
Requisitos previos
- Permiso: módulo
viewAntifraud. El permiso es doble — enum CPM en el backend + módulo dinámico en la DB. - Licencia/Feature: ninguna.
- Dependencias de otras pantallas: los logs son escritos automáticamente por AntifraudService en cada operación evaluada.
Paso a paso
- Acceda al menú GENERAL → Auditoría → Log antifraude (guía integrada disponible — ícono de libro).
- La tabla carga las transacciones analizadas (paginación local: 10/20/50 por página).
- Cada fila muestra chips de las reglas activadas, con ícono y severidad (crítico / atención / informativo / seguro).
- Haga clic en Ver detalles para abrir el modal con todos los campos de la transacción (IP, dispositivo, billeteras, documentos, score, motivo del bloqueo).
Filtros y columnas
| Filtro / Columna | Qué muestra | Origen del dato |
|---|---|---|
| Operación | Tipo + dirección (ej.: PIX • retiro) | operationType / operationDirection |
| Monto / Moneda | Monto de la operación | amount / currency |
| Reglas activadas (chips) | Cada regla que se activó, con ícono, severidad y categoría (amount, velocity, pattern, counterparty, identity, whitelist, admin) | triggeredRules (parser + catálogo de reglas) |
| Score de riesgo | Suma de los pesos de las reglas | riskScore |
| Bloqueada | Si la operación fue bloqueada automáticamente | wasBlocked / blockReason |
| Puede reintentar | Si la operación es elegible para un nuevo intento | canRetry / retryApprovedBy / retryReason |
| Acciones | Abre los detalles | — |
Campos (modal de detalles)
Muestra los datos completos de la transacción evaluada: userId, ip, deviceId, geoLocation, walletIdFrom/To, accountIdFrom/To, senderTaxId, receiverTaxId, recipient, riskScore, lista de triggeredRules, wasBlocked, blockReason, canRetry, retryApprovedBy y retryReason.
Acciones y modales
- Actualizar: recarga los logs.
- Ver detalles: abre el
AntifraudLogDetailsModalcon la transacción completa. - Guía integrada (ícono de libro): abre la ayuda contextual (
helpGuide.antifraudLog).
Reglas de negocio / precauciones
Atención
- El score es la suma de los pesos de las reglas activadas. Rangos de referencia: Bajo (< 40), Medio (40–99) y Alto (≥ 100 → bloqueo automático). Detalles y pesos por regla en Módulo de Antifraude.
- Las reglas de peso negativo (ej.:
hasPreviouslyApprovedSimilarTransaction, peso-999) funcionan como excepciones — reducen el score cuando la transacción ya fue aprobada anteriormente con parámetros similares. - Las reglas de la categoría
admin(ej.:isApprovalVelocityHigh,isApprovalPairRecurrent,isBulkActionBurst) monitorean el comportamiento de los propios administradores (insider/collusion), no solo de los clientes. - La lista negra de billeteras se alimenta automáticamente a partir de listas de sanciones OFAC — una operación puede ser bloqueada por origen/destino sancionado sin intervención manual.
- Montos financieros: los montos son tratados con precisión (BigNumber) durante la evaluación — no redondee al interpretar el log.