Integración FPP

Visión general

La Fraud Prevention Platform (FPP) es el módulo de la Suite Guardline responsable de la evaluación de transacciones, para prevención de fraudes y para prevención de lavado de dinero (AML). La integración con la FPP permite que el sistema de la institución envíe transacciones para evaluación, reciba decisiones (aprobar, bloquear o generar alerta) y dé seguimiento a las alertas generadas por el motor de reglas y por el análisis de comportamiento (UBA). El modelo funcional de la AML está descrito en la sección AML.

Flujo de evaluación

El flujo típico de evaluación de una transacción sigue estos pasos:

1. El sistema de la institución envía los datos de la transacción a la FPP.
2. El motor de reglas evalúa la transacción con base en las políticas configuradas y en el análisis de comportamiento.
3. La FPP devuelve la decisión de fraude (aprobar, bloquear o alertar) acompañada del score y del desglose de las reglas que puntuaron, y notifica a la institución vía webhook. Las alertas de fraude se tratan en el workbench de la FPP.
4. En el dominio de AML, la misma transacción se evalúa inmediatamente después, fuera de la llamada. Una alerta de AML de severidad media o alta es despachada por la FPP a la CMP, que abre o actualiza el caso.

Modos de integración

La FPP admite tres modos de integración, que pueden combinarse según la necesidad de la operación:

Síncrono: la institución envía la transacción y recibe la decisión en la misma llamada. El SLA contractual para este modo es de 300ms en el percentil 95 (P95). Es el modo indicado para transacciones que requieren una decisión en tiempo real antes de que se efectúen.

Asíncrono: la institución envía la transacción y recibe una confirmación de recepción. La evaluación se procesa en segundo plano y el resultado se entrega vía webhook. Indicado para escenarios en los que la decisión no necesita ser inmediata.

Lote: la institución envía conjuntos de transacciones a una cola, que los procesa en orden de fecha de negocio, con estado por ítem e informe de rechazos. Indicado para carga inicial, histórico y reprocesamiento en AML, con replay en dos fases: el histórico forma el perfil de comportamiento y después las transacciones se puntúan.

Tipos de transacción

La FPP acepta cualquier transacción monetaria (transferencias, pagos, retiros, Pix, TED, boletos) y también eventos de cliente que puedan indicar riesgo (modificación de datos de registro, cambio de dispositivo, cambio en el patrón de acceso). La institución define qué eventos enviar según su política de riesgo.

Respuesta de la evaluación

Cada evaluación devuelve tres elementos:

• Decisión: aprobar, bloquear o alertar.
• Score: puntuación numérica calculada por el motor de reglas.
• Desglose: detalle de las reglas que contribuyeron al score, con el peso y la justificación de cada una.

Este detalle permite que la institución comprenda los factores que llevaron a la decisión y alimente sus procesos internos de revisión.

Notificaciones

La institución recibe notificaciones vía webhook sobre los principales eventos relacionados con la evaluación de transacciones de fraude: resultado de evaluaciones, bloqueos y alertas generadas. La configuración de qué eventos recibir se realiza durante el setup de la integración. Las alertas de AML siguen a la Mesa de Decisión, y no al integrador de fraude.

Todas las notificaciones incluyen firma HMAC para la validación de autenticidad, como se describe en los conceptos de integración.