Autogestión de Reglas

Introducción

El módulo de Autogestión de Reglas es tu centro de control donde puedes visualizar, crear y administrar reglas personalizadas para rechazar transacciones sospechosas otorgándote control directo sobre la protección de tu negocio.

Esta herramienta te permite responder rápidamente ante amenazas específicas, proporcionándote la capacidad de frenar automáticamente transacciones que presenten características definidas por ti como riesgosas o inusuales para tu operación.

Desde el módulo de Reglas se podrá:

  • Visualizar todas las reglas activas e inactivas
  • Crear nuevas reglas de rechazo personalizadas
  • Editar y configurar reglas existentes
  • Activar/desactivar reglas según necesidades del negocio
  • Reordenar prioridad de evaluación de reglas

Existen tres roles de usuario del portal:

  • Lectura: permite visualizar todas las reglas creadas por el comercio. No puede editarlas ni crearlas.
  • Edición: permite crear, modificar, reordenar y suspender reglas del comercio.
  • Edición Administrador: incluye permisos de Edición más la posibilidad de tomar el control del panel cuando otro usuario ya está editando.

Importante sobre los roles de usuario: los usuarios y sus roles deben ser configurados previamente con el equipo de Soporte de Koin. Si no se visualiza el módulo de autogestión de reglas o no se cuenta con los permisos esperados, contactar al equipo de Soporte.



Términos clave

Término

Descripción

Regla

Configuración que evalúa datos específicos de una transacción y ejecuta una acción (rechazar) cuando se cumplen ciertas condiciones.

Variable

Dato específico de la transacción que será evaluado por la regla (ej: monto, email, país, IP).

Operador lógico

Conector que permite combinar múltiples condiciones en una misma regla:

  • AND (Y): Todas las condiciones deben cumplirse
  • OR (O): Al menos una condición debe cumplirse

Estado de regla

  • Activa: La regla está evaluando transacciones
  • Suspendida: La regla está creada pero no evaluando


Crear una regla

Una vez tengas el permiso para visualizar y editar reglas, en la pestaña Reglas debes seguir los siguientes pasos:

Paso 1: Activar modo edición

  1. Haz click en el botón "Editar panel", ubicado en la esquina superior derecha
  2. El sistema reservará la vista exclusivamente para ti y habilitará los botones de edición
  3. Ahora podrás crear, modificar reglas e incluso modificar su ubicación

Paso 2: Iniciar creación

Tienes dos opciones:

OpciónAcciónResultado
Nueva regla al finalClick en "Crear regla"Regla nueva al final de la lista
Nueva regla hijaClick en ícono "branch"Regla nueva dentro del grupo

Paso 3: Configurar información básica

Independientemente de la opción que elijas, debes completar el formulario de creación de reglas. Es el mismo, la diferencia esta en el universo al que impacta la regla.

Campos requeridos:

Nombre de la regla: identificador claro y descriptivo. Ejemplo: "Bloqueo compras nocturnas alto valor"

Variable: existen 25 variables disponibles para crear reglas de rechazo. Ejemplo: Email, telefono del comprador, telefono, monto de transacción

Operador: operador lógico. Ejemplo: Igual que, Mayor que, Contiene

Valor: será el campo o la condición que la regla deberá respetar para rechazar. Dependiendo de la variable este valor se adapta.Ejemplo: testexample.com, 2000, 123456

Acción: qué hacer cuando se cumplan las condiciones. El alcance de esta versión de autogestion de reglas es de Rechazo.

Descripcion: Explicación del propósito de la regla

Status de la regla:por default estará como activa, puedes crear una regla inactiva y activarla cuando creas necesario.

Siempre será necesario guardar la regla para que aparezca en el listado de reglas general. En este estado es cuando puedes eliminarla. Una vez que subas a producción solo podras inactivarla.


Condiciones múltiples

Puedes agregar hasta 5 condiciones en una misma regla usando operadores lógicos.

Operador AND (Y): todas las condiciones deben cumplirse simultáneamente.

Ejemplo:

Condición 1: Amount es mayor que 50000
Y
Condición 2: Country es igual a "Extranjero"

Operador OR (O): al menos una condición debe cumplirse.

Ejemplo:

Condición 1: Email es igual a "[email protected]"
O
Condición 2: Email es igual a "[email protected]"


Activar y desactivar reglas

Activar regla

  1. En modo edición, selecciona la regla
  2. Activa el interruptor en la configuración
  3. Guarda los cambios

Desactivar regla

  1. En modo edición, selecciona la regla
  2. Desactiva el interruptor en la configuración
  3. Guarda los cambios

Reordenar prioridad

Las reglas se evalúan de arriba hacia abajo. Para cambiar la prioridad:

  1. En modo edición, haz click sostenido en el botón de los puntos ubicado en el listado de reglas. Existe uno por regla
  2. Arrastra hacia arriba o abajo
  3. Suelta en la nueva posición
  4. Guarda los cambios

Para reordenar existe el boton de la imagen (puntos), de esta forma podras desplazar la regla a la posicion que necesites



Estado de las reglas

Estados disponibles

EstadoDescripciónAcciones disponibles
ActivaEvaluando transaccionesEditar, Desactivar, Reordenar
InactivaCreada pero no evaluandoEditar, Activar
Sin guardarCambios pendientesGuardar, Descartar

Eliminar una regla: solo las reglas que estan en estado Sin guardar pueden ser eliminadas. Una vez que una regla sube a producción solo puede tener el estado activo o inactivo.


Subir a producción

  • Guardar cambios

Cuando realices modificaciones verás un punto naranja (🟠) indicando cambios sin guardar. Puedes crear varias reglas y cuando hagas click en "Guardar Cambios" es que dichas reglas y modificaciones en general subiran a producción.

Para aplicar los cambios:

  1. Revisa todas las reglas con punto naranja, ya que ese punto indica que esa regla es nueva o tiene un cambio
  2. Haz click en "Guardar cambios"
  3. El sistema enviará notificación automática al equipo
  • Descartar cambios

Si decides no aplicar las modificaciones:

  1. Haz clic en "Salir del modo edición"
  2. Confirma la acción en el modal
  3. Todos los cambios no guardados se descartarán

Variables disponibles


Conoce tu integración: Antes de crear reglas, verifica qué datos envía tu sistema y cómo están estructurados. Esto asegura que selecciones las variables correctas y definas valores precisos.

Variables de Usuario

VariableTipo
Teléfono del pagadorNumérico
Tipo de documento del pagadorTexto
Número de documento del pagadorAlfanumérico
Email del pagadorAlfanumérico
Nombre del pagadorTexto
Apellido del pagadorTexto
Nombre completo del pagadorTexto
Teléfono del compradorNumérico
Tipo de documento del compradorTexto
Número de documento del compradorAlfanumérico
Email del compradorAlfanumérico
Nombre del compradorTexto
Apellido del compradorTexto
Nombre completo del compradorTexto

Variables Transaccionales

VariableTipo
Marca de la tarjetaTexto
Últimos 4 dígitos de la tarjetaNumérico
Primeros 6 dígitos de la tarjeta (BIN)Alfanumérico
Moneda de la transacciónTexto
Monto de la transacciónNumérico
Número de cuotasNumérico
País de la transacciónTexto

Variables de Contexto y seguridad

VariableTipo
Dirección IP del compradorAlfanumérico
Canal de ventaTexto
Ciudad de entregaAlfanumérico
Dirección completa de entregaAlfanumérico


Preguntas frecuentes


¿Cómo veo el rendimiento de mis reglas?

Ve a Koin Insights+"Distribución de reglas de rechazo" para ver estadísticas detalladas de cuántas transacciones rechazó cada regla.

¿En qué orden se evalúan las reglas?

Las reglas se evalúan de arriba hacia abajo según aparecen en el panel. Si una transacción es rechazada por una regla, las siguientes no se evalúan.

¿Puedo crear una regla inactiva?

Sí. Puedes crear una regla y mantenerla en estado "Inactiva" hasta que decidas activarla. Por default se crean activas, por lo que será necesario que al momento de crearla hagas el ajuste.

¿Qué pasa si dos reglas se contradicen?

La regla que aparezca más arriba en la lista tendrá prioridad y se ejecutará primero.

¿Hay límite en la cantidad de reglas?

El límite depende de tu plan contratado. Consulta con tu account manager para conocer tu límite específico.

¿Puedo recuperar una regla eliminada?

Solo puedes eliminar una regla en el proceso de creación, una vez que creas una regla y esta en producción solo puedes desactivarla.