Introducción

El módulo de acuerdos y promociones es el lugar donde se configuran las condiciones comerciales especiales de pago para ofrecer a los compradores, como pagos en cuotas, descuentos o promociones por tipo de tarjeta.

Cada vez que un comprador elige pagar en cuotas o accede a una promoción en la tienda, Koin consulta los acuerdos configurados para saber qué reglas aplicar. Si el acuerdo no está bien configurado o no está activo, esa promoción no aparecerá en el checkout.

Existen dos roles de usuario del portal:

Escritura: permite crear, activar, editar, ver el listado, ver el detalle, mover la prioridad y eliminar acuerdos.
Solo lectura: permite únicamente ver el listado y el detalle de los acuerdos.

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 acuerdos y promociones o no se cuenta con los permisos esperados, contactar al equipo de Soporte.

Desde el módulo de acuerdos y promociones se podrá:)

Requisitos previos

Antes de comenzar a usar el módulo de acuerdos y promociones, es necesario que las siguientes configuraciones hayan sido completadas con el equipo de Soporte de Koin. Sin estas configuraciones, no será posible crear acuerdos o algunas opciones no estarán disponibles en el portal.

#	Requisito	Descripción	Obligatorio
1	Usuarios y roles	Compartir con el equipo de Soporte los usuarios que utilizarán el portal, indicando el rol asignado a cada uno (escritura o solo lectura). Sin esta configuración, el módulo no será visible o no se contará con los permisos esperados.	Sí
2	Adquirentes y afiliaciones	Solicitar al equipo de Soporte la configuración de los adquirentes y sus afiliaciones. Sin esta configuración, no aparecerán opciones disponibles en el campo "Adquirente - afiliación" del formulario de creación.	Sí
3	Grupos de tarjeta	Solicitar al equipo de Soporte la carga de los grupos de tarjeta (conjuntos de BINs). Sin esta configuración, no será posible asociar tarjetas a los acuerdos.	Sí
4	Etiquetas	Solicitar al equipo de Soporte la carga de las etiquetas que se deseen mostrar en el checkout junto a las cuotas (Ej: "Sin interés", "¡Promoción!").	No

Si alguno de los requisitos obligatorios no ha sido configurado, contactar al equipo de Soporte de Koin antes de continuar.

Términos clave

Término	Descripción
Acuerdo	Una configuración que define las condiciones de pago especiales (cuotas, descuentos, intereses) entre la tienda de comercio electrónico, la entidad financiera y las marcas de tarjeta.
Adquirente	Es la entidad financiera o procesadora de pagos que procesa las transacciones con tarjeta de la tienda de comercio electrónico.
Checkout	La pantalla donde el comprador elige cómo pagar al finalizar su compra.
Vigencia	El período de tiempo durante el cual un acuerdo es válido (fecha/hora de inicio y fecha/hora de fin).
Estado activo (verde)	El acuerdo está habilitado y puede aparecer en el checkout.
Estado suspendido (gris)	El acuerdo existe pero no está habilitado. No aparecerá en el checkout.
Grupo de tarjeta	Es un conjunto de BINs (los primeros 8 dígitos de una tarjeta) agrupados bajo un mismo nombre. Estos BINs son proporcionados por el sello o entidad financiera con los que la tienda tiene el acuerdo. Por ejemplo, un grupo podría incluir todos los BINs de Visa Gold o todos los BINs de Mastercard Black. Los grupos de tarjeta permiten definir a qué tarjetas aplica cada acuerdo.

Acceder al módulo de acuerdos y promociones

Ingresar al portal de pagos de Koin.
En el menú de navegación superior, hacer clic en "Acuerdos y promociones".
Se ingresará a la pantalla principal del módulo.

Si es la primera vez que se ingresa o todavía no se han creado acuerdos, se visualizará una pantalla vacía con un mensaje indicándolo. Esto es normal; desde allí se puede crear el primer acuerdo.

Si no se visualiza la opción "Acuerdos y promociones", o si se visualiza la opción pero no es posible crear ni editar acuerdos, contactar al equipo de Soporte de Koin para solicitar los permisos correspondientes.

Ver el listado de acuerdos

Una vez dentro del módulo, se visualizará el listado de todos los acuerdos. Esta es la pantalla de control central.

En la parte superior se encontrarán tres tarjetas que permiten filtrar rápidamente:

Todas: muestra todos los acuerdos sin importar su estado.
Activas: muestra solo los acuerdos activos (en verde).
Inactivas: muestra solo los acuerdos suspendidos (en gris).

Debajo de las tarjetas se visualizará una tabla con todos los acuerdos creados. Cada fila representa un acuerdo y muestra la siguiente información:

Identificador interno: código único que identifica el acuerdo en el sistema. Es posible utilizarlo como referencia al contactar al equipo de Soporte de Koin si se necesita consultar sobre un acuerdo específico.
Vigencia: fecha/hora de inicio y fecha/hora de fin del acuerdo.
Nombre del acuerdo: el nombre descriptivo que fue asignado al crearlo.
Proveedor: la entidad financiera (adquirente) a la que aplica el acuerdo.
Estado: activo (verde) o suspendido (gris).
Acciones: íconos para gestionar cada acuerdo (activar, ver detalle/editar, eliminar y cambiar prioridad).

Crear un nuevo acuerdo

En la pantalla principal, hacer clic en el botón "Nuevo acuerdo" (esquina superior derecha). Se abrirá un formulario. Completar los siguientes campos:

Información general

Nombre de la política (se mostrará como "Nombre" en el listado): un nombre descriptivo para identificar fácilmente este acuerdo. Ejemplo: "Promoción Visa 3 cuotas sin interés".
Descripción: explicación breve del propósito del acuerdo.
Tipo de acuerdo: elegir entre una de las siguientes opciones:
- Plan: acuerdos bajo planes de financiación específicos (aparecerá una lista con los planes disponibles).
- Bank: acuerdos vinculados a entidades bancarias.
- Store: acuerdos propios de la tienda.
País: país donde aplica el acuerdo.
Moneda: moneda en la que operará el acuerdo.
Adquirente - afiliación: seleccionar la entidad financiera que procesa los pagos bajo este acuerdo.
Zona horaria: huso horario que se usará para calcular la vigencia del acuerdo.

Importante sobre adquirentes y afiliaciones: los adquirentes y sus afiliaciones deben ser configurados previamente con el equipo de Soporte de Koin para que aparezcan como opciones en el portal. Si no se visualiza ninguna opción disponible, contactar al equipo de Soporte antes de continuar.

Vigencia y aplicación

Vigencia: definir la fecha y hora de inicio y la fecha y hora de fin del acuerdo. Es posible configurar un acuerdo con fecha futura; se activará en esa fecha si el acuerdo está activo. Si se desea que el acuerdo no tenga fecha de fin, es posible dejar el campo vacío o eliminarlo haciendo clic en la X ubicada a la derecha del campo. Esto aplica tanto al crear como al editar un acuerdo.
Días de la semana: elegir en qué días de la semana aplica la promoción (por ejemplo: solo lunes y martes). Se debe seleccionar al menos un día.
Grupos de tarjeta: seleccionar uno o varios grupos de tarjeta que aplicarán para la promoción.

Una vez seleccionado el grupo de tarjetas y luego de hacer clic en "Agregar", el grupo seleccionado se sumará a la tabla de grupos de tarjeta configurados. Cada fila representa un grupo de tarjetas. Es posible repetir el proceso de agregar grupos de tarjetas tantas veces como sea necesario hasta configurar todas las opciones deseadas.

Si se necesita eliminar un grupo de tarjetas, hacer clic en el ícono de la papelera al final de la fila correspondiente.

Importante sobre grupos de tarjeta: los grupos de tarjeta deben ser configurados previamente con el equipo de Soporte de Koin para que aparezcan como opciones en el portal. Si no se visualiza ninguna opción disponible, contactar al equipo de Soporte antes de continuar.

Configuración de cuotas

Para agregar cuotas, hacer clic en "+ Agregar" y se abrirá un formulario donde se deberá completar:

Cantidad de cuotas: número de cuotas disponibles para esta promoción. Las cuotas se pueden especificar de las siguientes formas:
- Valor único: una sola cuota (Ej: 3).
- Lista de valores: varias cuotas separadas por coma (Ej: 3, 6, 12).
- Rango: un intervalo continuo de cuotas separado por guión (Ej: 1-5).
- Combinación: mezcla de valores individuales y rangos (Ej: 3, 6, 9-12).
- Solo se permitirán en el sitio web las cuotas que se definan aquí.
Interés: se ingresa como coeficiente multiplicador sobre el valor de la cuota.
- Sin interés: ingresar 1 (el comprador paga el precio original).
- 5% de interés: ingresar 1.05 (el comprador paga un 5% más).
- 10% de interés: ingresar 1.10 (el comprador paga un 10% más).
- Fórmula: coeficiente = 1 + (porcentaje / 100)
- Ejemplo: si el producto vale $1.000 y se configuran 3 cuotas con coeficiente 1.10 (10% de interés), el interés se calcula sobre el monto total. El comprador pagará $1.100 en total ($366,67 por cuota). El valor mínimo permitido es 1.
Descuento: se ingresa como coeficiente multiplicador sobre el valor de la transacción.
- Sin descuento: ingresar 1 (el comprador paga el precio original).
- 20% de descuento: ingresar 0.8 (el comprador paga un 20% menos).
- 30% de descuento: ingresar 0.7 (el comprador paga un 30% menos).
- Fórmula: coeficiente = 1 – (porcentaje / 100)
- Ejemplo: si el producto vale $1.000 y se configura un descuento con coeficiente 0.8 (20% de descuento), el comprador pagará $800.
Monto mínimo: importe mínimo de la transacción para que aplique esta cuota.
Etiquetas: texto corto que se mostrará en el checkout para destacar una cuota (Ej: "Sin interés", "Promoción", "10% OFF", etc.).

Importante sobre las cuotas: no es posible tener más de una configuración con la misma cantidad de cuotas. Si se detectan cuotas duplicadas, el botón "Crear acuerdo" permanecerá deshabilitado hasta que se eliminen todas las configuraciones duplicadas.

Una vez completado el formulario de cuotas y luego de hacer clic en "+ Agregar", las cuotas se sumarán a la tabla de cuotas configuradas. Cada fila representa una cuota y muestra el resumen de sus condiciones: cantidad de cuotas, monto mínimo, descuento, interés y etiquetas. Es posible repetir el proceso de agregar cuotas tantas veces como sea necesario hasta configurar todas las opciones que se deseen ofrecer.

Si se necesita eliminar una cuota, hacer clic en el ícono de la papelera al final de la fila correspondiente.

Importante sobre etiquetas: al igual que los grupos de tarjeta, las etiquetas deben ser configuradas previamente con el equipo de Soporte de Koin para que aparezcan como opciones en el portal.

Una vez completado todo el formulario de acuerdos, hacer clic en "Crear acuerdo".

El acuerdo se creará con estado "suspendido" (gris). Esto es intencional para evitar que una promoción aparezca en el checkout antes de estar listo. Cuando se desee que el acuerdo esté disponible, se deberá activar manualmente desde el listado.

Activar un acuerdo

Para que un acuerdo sea visible en el checkout, se debe activar manualmente. La fecha de inicio sola no es suficiente.

Desde el listado de acuerdos, buscar el acuerdo que se desea activar.
Hacer clic en el ícono de interruptor (switch) que está en la fila del acuerdo.
El estado cambiará de gris (suspendido) a verde (activo).

Cuándo aparecerá el acuerdo en el checkout

Un acuerdo se mostrará en el checkout solo si se cumplen ambas condiciones al mismo tiempo:

Condición 1: el acuerdo está en estado activo (verde). Condición 2: la fecha actual es igual o posterior a la fecha de inicio configurada.

Ejemplo práctico: hoy es 10 de junio. Se creó un acuerdo con fecha de inicio el 15 de junio.

Si se activa hoy (10 de junio): el acuerdo se mostrará automáticamente en el checkout el 15 de junio.
Si no se activa y llega el 15 de junio: el acuerdo NO aparecerá en el checkout, aunque la fecha ya haya llegado.

Gestionar acuerdos existentes

Editar un acuerdo

Solo es posible editar acuerdos que estén en estado "suspendido". Si el acuerdo está activo, no se puede modificar (aunque tenga fecha de vigencia a futuro).

Desde el listado, buscar el acuerdo que se desea editar (debe estar en estado suspendido).
Hacer clic en el ícono de la lupa en la fila del acuerdo.
Se abrirá el mismo formulario de creación con todos los datos ya cargados y los campos habilitados para edición.
Modificar los campos que sea necesario.
Hacer clic en el botón "Actualizar acuerdo" para guardar los cambios. El sistema registrará la modificación automáticamente y redirigirá al listado de acuerdos.

Importante sobre las cuotas: no es posible tener más de una configuración con la misma cantidad de cuotas. Si se detectan cuotas duplicadas, el botón "Actualizar acuerdo" permanecerá deshabilitado hasta que se eliminen todas las configuraciones duplicadas.

¿Qué pasa si se necesita modificar un acuerdo activo? Los acuerdos activos no pueden editarse. Si se necesita corregir algo en un acuerdo activo, se deberá eliminarlo y crear uno nuevo con la configuración correcta. Las transacciones que ya estén en curso con el acuerdo original no se verán afectadas.

Ver el detalle de un acuerdo

Desde el listado, hacer clic en el ícono de la lupa en la fila del acuerdo que se desea consultar.
Se abrirá el formulario del acuerdo con toda la información configurada.

Lo que se visualice y pueda hacerse depende del rol asignado y del estado del acuerdo:

Si se cuenta con rol de solo lectura, se visualizarán todos los campos pero no será posible modificar nada.
Si se cuenta con rol de escritura y el acuerdo está suspendido, será posible editar los campos desde esta misma vista.
Si se cuenta con rol de escritura y el acuerdo está activo, solo será posible consultarlos.

Ordenar o priorizar los acuerdos

Cuando un comprador llega al checkout, Koin recorre los acuerdos de arriba hacia abajo según el orden del listado. En cuanto encuentra el primer acuerdo que cumple con todas las condiciones de la transacción (adquirente, grupo de tarjeta, monto mínimo, día de la semana, etc.), aplica ese acuerdo y no evalúa los siguientes.

Ejemplo 1: se tienen dos acuerdos activos para Visa en 3 cuotas. El acuerdo A está en la posición 1 (con 10% de interés) y el acuerdo B está en la posición 2 (sin interés). Si la transacción cumple con las condiciones de ambos, Koin aplicará el acuerdo A porque está primero. El acuerdo B será ignorado para esa transacción.

Ejemplo 2: se tienen dos acuerdos activos para el mismo grupo de tarjeta. El acuerdo A (posición 1) ofrece 6 cuotas con 5% de interés. El acuerdo B (posición 2) ofrece 3, 6 y 9 cuotas sin interés.

En este caso, la prioridad se aplica por cada cantidad de cuotas. En el checkout el comprador verá:

3 cuotas sin interés → del acuerdo B (no hay conflicto, solo el acuerdo B ofrece 3 cuotas).
6 cuotas con 5% de interés → del acuerdo A (ambos ofrecen 6 cuotas, pero el acuerdo A tiene mayor prioridad).
9 cuotas sin interés → del acuerdo B (no hay conflicto, solo el acuerdo B ofrece 9 cuotas).

Esto significa que la prioridad solo entra en juego cuando dos o más acuerdos ofrecen la misma cantidad de cuotas. En las cuotas donde no hay conflicto, se aplica el acuerdo que las tenga configuradas sin importar su posición.

Por eso es importante revisar el orden de los acuerdos: el que se desee que tenga preferencia debe estar más arriba en el listado.

Para cambiar el orden:

Identificar el acuerdo que se desea mover en el listado.
Hacer clic y mantener presionado el ícono de los seis puntos (⠿) que está al final de la fila.
Arrastrar el acuerdo hacia la posición deseada y soltar.
Repetir el proceso para todos los acuerdos que se necesiten reordenar.
Una vez que se tenga el orden correcto, hacer clic en el botón "Guardar cambios".

Importante: si no se guardan los cambios, el orden volverá al estado anterior.

Eliminar un acuerdo

La eliminación de un acuerdo es permanente e irreversible. Una vez eliminado, no podrá recuperarse.

Desde el listado, hacer clic en el ícono de la papelera en la fila del acuerdo que se desea eliminar.
Aparecerá una ventana de confirmación indicando que:
- La acción no se puede deshacer.
- El acuerdo será eliminado permanentemente.
- Las transacciones que ya están en curso no se verán afectadas.
- Las nuevas transacciones ya no aplicarán las condiciones de ese acuerdo.
Si se confirma la decisión, hacer clic en "Eliminar".

El acuerdo desaparecerá del listado. No aparecerá ni en la sección "Activas" ni en "Inactivas", pero quedará registrado en los sistemas internos de Koin.

Resumen de estados y acciones disponibles

Estado suspendido (gris):

El acuerdo fue creado.
No está habilitado para mostrarse en el checkout.
Acciones disponibles: activar, editar, ver el detalle, mover la prioridad y eliminar.

Estado activo (verde):

El acuerdo está habilitado.
Dependiendo de las características (vigencia, días de la semana, etc.) podría mostrarse en el checkout.
Acciones disponibles: ver el detalle, mover la prioridad y eliminar.
No es posible editar.

Estado eliminado:

El acuerdo fue eliminado permanentemente.
No está habilitado para mostrarse en el checkout.
No aparece en el listado de acuerdos.

Preguntas frecuentes

¿Qué pasa cuando un acuerdo llega a su fecha de fin?

Cuando se alcanza la fecha y hora de fin configurada, el acuerdo deja de mostrarse en el checkout automáticamente. Las transacciones nuevas ya no se aplicarán a esas condiciones, pero las transacciones que ya estaban en curso no se ven afectadas.

¿Los acuerdos se aplican a todas las transacciones automáticamente?

Sí, pero solo a las transacciones que cumplen con todas las condiciones configuradas en el acuerdo: adquirente correcto, grupo de tarjeta habilitado, monto mínimo alcanzado, día de la semana válido, etc. Si alguna condición no se cumple, el acuerdo no se aplica.

¿Es posible crear un acuerdo con fecha de inicio futura?

Sí. Se puede crear el acuerdo hoy y configurar que empiece en una fecha futura. El acuerdo aparecerá en el checkout al llegar esa fecha, siempre y cuando esté en estado activo. Es importante recordar que la activación es obligatoria y manual.

¿Es posible tener varios acuerdos activos al mismo tiempo?

Sí. Se pueden tener múltiples acuerdos activos simultáneamente. El orden de prioridad configurado determinará cuál se aplica primero cuando una transacción cumple con las condiciones de más de un acuerdo.

¿Es posible editar un acuerdo activo?

No. Los acuerdos activos no pueden editarse. Si se necesita corregir algo, se deberá eliminar el acuerdo y crear uno nuevo con la configuración correcta.

¿Qué hacer si no se visualizan las opciones de grupos de tarjeta o etiquetas?

Estas opciones deben ser configuradas previamente con el equipo de Soporte de Koin. Contactar al equipo de Soporte y proporcionar la información de los grupos de tarjeta o etiquetas necesarios. El equipo los habilitará para que aparezcan como opciones en el portal.

¿Es posible recuperar un acuerdo eliminado?

No. La eliminación es permanente e irreversible desde el portal. Si se eliminó un acuerdo por error, se deberá crearlo nuevamente desde cero.