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.
¿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
Detección de Fraude
Identifica transacciones fraudulentas en tiempo real usando patrones de comportamiento y reglas personalizadas
Monitoreo AML
Cumple con regulaciones anti-lavado de dinero detectando transacciones sospechosas y estructuración
Configuración de Reglas
Aprende a crear reglas sync y async, establecer límites y umbrales personalizados
Monitoreo de Merchants
Supervisa merchants para adquirentes: detección de chargebacks, fraude, phishing y cumplimiento
Arquitectura del Sistema
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
Referencia API
Documentación completa del endpoint con ejemplos en cURL, JavaScript y Python
Detección de Fraude
Reglas y patrones para detectar fraude en tiempo real
Monitoreo AML
Cumplimiento regulatorio y detección de lavado de dinero
Monitoreo de Merchants
Supervisión de comercios para adquirentes y subadquirentes