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:
|
Estado de regla |
|
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
- Haz click en el botón "Editar panel", ubicado en la esquina superior derecha
- El sistema reservará la vista exclusivamente para ti y habilitará los botones de edición
- Ahora podrás crear, modificar reglas e incluso modificar su ubicación
Paso 2: Iniciar creación
Tienes dos opciones:
| Opción | Acción | Resultado |
|---|---|---|
| Nueva regla al final | Click en "Crear regla" | Regla nueva al final de la lista |
| Nueva regla hija | Click 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
- En modo edición, selecciona la regla
- Activa el interruptor en la configuración
- Guarda los cambios
Desactivar regla
- En modo edición, selecciona la regla
- Desactiva el interruptor en la configuración
- Guarda los cambios
Reordenar prioridad
Las reglas se evalúan de arriba hacia abajo. Para cambiar la prioridad:
- En modo edición, haz click sostenido en el botón de los puntos ubicado en el listado de reglas. Existe uno por regla
- Arrastra hacia arriba o abajo
- Suelta en la nueva posición
- 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
| Estado | Descripción | Acciones disponibles |
|---|---|---|
| Activa | Evaluando transacciones | Editar, Desactivar, Reordenar |
| Inactiva | Creada pero no evaluando | Editar, Activar |
| Sin guardar | Cambios pendientes | Guardar, 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:
- Revisa todas las reglas con punto naranja, ya que ese punto indica que esa regla es nueva o tiene un cambio
- Haz click en "Guardar cambios"
- El sistema enviará notificación automática al equipo
- Descartar cambios
Si decides no aplicar las modificaciones:
- Haz clic en "Salir del modo edición"
- Confirma la acción en el modal
- 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
| Variable | Tipo |
|---|---|
| Teléfono del pagador | Numérico |
| Tipo de documento del pagador | Texto |
| Número de documento del pagador | Alfanumérico |
| Email del pagador | Alfanumérico |
| Nombre del pagador | Texto |
| Apellido del pagador | Texto |
| Nombre completo del pagador | Texto |
| Teléfono del comprador | Numérico |
| Tipo de documento del comprador | Texto |
| Número de documento del comprador | Alfanumérico |
| Email del comprador | Alfanumérico |
| Nombre del comprador | Texto |
| Apellido del comprador | Texto |
| Nombre completo del comprador | Texto |
Variables Transaccionales
| Variable | Tipo |
|---|---|
| Marca de la tarjeta | Texto |
| Últimos 4 dígitos de la tarjeta | Numérico |
| Primeros 6 dígitos de la tarjeta (BIN) | Alfanumérico |
| Moneda de la transacción | Texto |
| Monto de la transacción | Numérico |
| Número de cuotas | Numérico |
| País de la transacción | Texto |
Variables de Contexto y seguridad
| Variable | Tipo |
|---|---|
| Dirección IP del comprador | Alfanumérico |
| Canal de venta | Texto |
| Ciudad de entrega | Alfanumérico |
| Dirección completa de entrega | Alfanumé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.
Updated 12 days ago
