Detección de Riesgos

La API implementa tres mecanismos de detección de riesgos que operan de forma automática durante el procesamiento de transacciones.

1. Zona de Alto Riesgo (ZAR)

Se activa al enviar una transferencia saliente hacia una cuenta en zona de alto riesgo.

Cómo funciona:

1. Extraer código de plaza de la CLABE beneficiaria (dígitos 4-6)
   Ej: "646180xxxxxxxxx" → plaza = 618 → estado = "Baja California"

2. Consultar factores de riesgo del estado en catalogoEstadoPlaza:
   - frontera: 0-5 (proximidad a frontera)
   - puerto: 0-5 (proximidad a puerto)
   - delincuencia: 0-5 (índice delictivo)

3. Calcular porcentaje de riesgo:
   porcentaje = (frontera × 25/5) + (puerto × 35/5) + (delincuencia × 40/5)

4. Si porcentaje >= 78:
   → Crear alerta ZAR en BD (URL: /transactions/global)
   → Agregar tag id=11 al usuario
   → Lambda: TRANSACTION_HIGH_RISK_AREA (correo al área PLD)
   → Lambda PubSub: notificación WebSocket al portal admin

Pesos del cálculo:

Factor	Peso	Máximo
Proximidad a frontera	25%	5 puntos
Proximidad a puerto	35%	5 puntos
Tasa de delincuencia	40%	5 puntos

El umbral de >= 78% equivale a que el estado tenga puntajes altos en delincuencia y al menos un factor adicional.

2. Alertas por Porcentaje de Plan

Se activa al procesar transacciones salientes cuando el plan se está agotando.

Después de restar 1 del plan:
  Si remaining_transactions == 50: Lambda LOW_REMAINING_TRANSACTIONS (50 restantes)
  Si remaining_transactions == 20: Lambda LOW_REMAINING_TRANSACTIONS (20 restantes)

3. Perfil de Riesgo Transaccional

Analiza el comportamiento histórico del usuario contra su perfil transaccional definido.

Al procesar una transacción:
  → TransactionalProfileLevelRisk.check(user_id, monto, tipo)
  → Compara con umbrales del perfil del usuario
  → Si supera: crear alerta de nivel de riesgo

4. Alerta de Porcentaje de Monto Mensual

AlertTransaction60PercentAmountMoth:
  Si suma de montos del mes >= 60% del límite mensual del usuario:
    → Crear alerta
    → Notificar al área de cumplimiento

Códigos de alerta

Código	Descripción	URL de navegación
`VRSTP`	Cuenta rechazada por STP	`/users/review`
`ZAR`	Transferencia en zona de alto riesgo	`/transactions/global`
`DLA`	Transferencia requiere aprobación del director	`/transactions/unapproved`
`FABONO`	Umbral de abonos alcanzado	`/account/transactions`
`FCARGO`	Umbral de cargos alcanzado	`/account/transactions`