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

# Monitoreo Transaccional

> Detección de fraude y AML en tiempo real para transacciones financieras — en el producto de monitoreo transaccional gu1 para fraude y AML.

## ¿Qué es el Monitoreo Transaccional?

El Monitoreo Transaccional de gu1 es un sistema completo de análisis en tiempo real que evalúa cada transacción financiera contra reglas personalizadas de riesgo, cumplimiento y fraude. Permite a empresas financieras, fintechs, adquirentes y subadquirentes detectar actividades sospechosas, prevenir fraude y cumplir con regulaciones AML/CFT.

## Características Principales

### 🚀 Análisis en Tiempo Real

* **Respuesta \< 500ms**: Decisiones instantáneas durante el flujo de pago
* **Reglas Síncronas**: Bloqueo o aprobación en tiempo real
* **Sin latencia**: Integración transparente en tu flujo existente

### 🎯 Motor de Reglas Flexible

* **Reglas Síncronas (Sync)**: Se evalúan en tiempo real y afectan la decisión de la transacción
* **Reglas Asíncronas (Async)**: Se evalúan en segundo plano para análisis y alertas sin impactar el flujo
* **Condiciones Complejas**: Operadores AND/OR, comparaciones múltiples, agregaciones
* **Priorización**: Control total sobre el orden de evaluación

### 🔔 Sistema de Alertas Inteligente

* **Generación Automática**: Las reglas pueden generar alertas cuando detectan patrones sospechosos
* **Consolidación en Investigaciones**: Las alertas se agrupan automáticamente en investigaciones
* **Severidad Configurable**: INFO, WARNING, HIGH, CRITICAL
* **Tablero de Intelligence**: Visualización y gestión centralizada

### 💱 Soporte Multi-Moneda

* **Conversión Automática**: Todas las transacciones se convierten a tu moneda base
* **Tasas en Tiempo Real**: Integración con proveedores de tasas de cambio
* **Comparación Consistente**: Reglas que funcionan independientemente de la moneda

### 🔗 Resolución de Entidades

* **Auto-creación**: Crea automáticamente entidades de origen y destino
* **Vinculación**: Conecta transacciones con personas, empresas y cuentas
* **Contexto Completo**: Acceso a historial y patrones de comportamiento

## Casos de Uso

<CardGroup cols={2}>
  <Card title="Detección de Fraude" icon="shield-halved" href="/es/use-cases/transaction-monitoring/fraud-detection">
    Identifica transacciones fraudulentas en tiempo real usando patrones de comportamiento y reglas personalizadas
  </Card>

  <Card title="Monitoreo AML" icon="scale-balanced" href="/es/use-cases/transaction-monitoring/aml-monitoring">
    Cumple con regulaciones anti-lavado de dinero detectando transacciones sospechosas y estructuración
  </Card>

  <Card title="Configuración de Reglas" icon="sliders" href="/es/use-cases/transaction-monitoring/rules-configuration">
    Aprende a crear reglas sync y async, establecer límites y umbrales personalizados
  </Card>

  <Card title="Monitoreo de Merchants" icon="store" href="/es/use-cases/transaction-monitoring/merchant-monitoring">
    Supervisa merchants para adquirentes: detección de chargebacks, fraude, phishing y cumplimiento
  </Card>
</CardGroup>

## Arquitectura del Sistema

```mermaid theme={null}
sequenceDiagram
    participant Client as Tu Sistema
    participant API as gu1 API
    participant Rules as Motor de Reglas
    participant Alerts as Sistema de Alertas
    participant Intel as Intelligence

    Client->>API: POST /transaction/analyze
    API->>API: Validar payload
    API->>API: Resolver entidades origen/destino
    API->>API: Conversión de moneda (si aplica)
    API->>API: Crear entidad transacción
    API->>Rules: Ejecutar reglas SYNC
    Rules->>Rules: Evaluar condiciones
    Rules-->>Alerts: Generar alertas (si aplica)
    Alerts-->>Intel: Consolidar en investigación
    Rules->>API: Retornar decisión
    API->>Client: Respuesta (APPROVE/REJECT/HOLD)

    Note over Rules: Reglas ASYNC se ejecutan<br/>en paralelo sin bloquear
```

## Flujo de Procesamiento

### 1. Validación Completa

Todos los campos de la transacción son validados exhaustivamente:

* Formato de datos (ISO 8601, ISO 4217, etc.)
* Rangos de valores (montos, coordenadas, etc.)
* Campos requeridos y opcionales
* Validación de referencias a entidades

### 2. Resolución de Entidades

* **Origen**: Identifica o crea la entidad que origina la transacción
* **Destino**: Identifica o crea la entidad receptora
* **Vinculación**: Conecta la transacción con las entidades involucradas

### 3. Conversión de Moneda

* Detecta si la transacción está en una moneda diferente a tu base
* Obtiene la tasa de cambio en tiempo real
* Convierte el monto para análisis consistente
* Almacena ambos valores (original y convertido)

### 4. Creación de Transacción

Se persiste la transacción con:

* Datos de la transacción
* Información de conversión
* Datos de dispositivo
* Metadata y tags personalizados
* Referencias a entidades

### 5. Ejecución de Reglas

#### Reglas Síncronas (SYNC)

* Se ejecutan inmediatamente
* Pueden cambiar el estado de la transacción
* Retornan decisión: APPROVE, REJECT, HOLD, REVIEW\_REQUIRED
* Bloquean la respuesta hasta completar

#### Reglas Asíncronas (ASYNC)

* Se ejecutan en paralelo
* No afectan la decisión inmediata
* Generan alertas y eventos
* Aparecen solo en el tablero de Intelligence

### 6. Generación de Alertas

Cuando una regla detecta un patrón sospechoso:

* Crea una alerta con severidad (INFO/WARNING/HIGH/CRITICAL)
* La alerta se persiste como una entidad
* Se vincula con la transacción que la generó
* El Motor de Consolidación agrupa alertas relacionadas
* Se crea automáticamente una investigación

### 7. Respuesta al Cliente

Formato de respuesta estructurado con:

* Decisión de la transacción
* Risk score y nivel de riesgo
* Lista de alertas generadas
* Acciones recomendadas
* Información de conversión
* Metadata de procesamiento

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Referencia API" icon="code" href="/es/use-cases/transaction-monitoring/api-reference">
    Documentación completa del endpoint con ejemplos en cURL, JavaScript y Python
  </Card>

  <Card title="Detección de Fraude" icon="shield" href="/es/use-cases/transaction-monitoring/fraud-detection">
    Reglas y patrones para detectar fraude en tiempo real
  </Card>

  <Card title="Monitoreo AML" icon="building-columns" href="/es/use-cases/transaction-monitoring/aml-monitoring">
    Cumplimiento regulatorio y detección de lavado de dinero
  </Card>

  <Card title="Monitoreo de Merchants" icon="shop" href="/es/use-cases/transaction-monitoring/merchant-monitoring">
    Supervisión de comercios para adquirentes y subadquirentes
  </Card>
</CardGroup>