Appearance
Configuración del Gateway de Pagos del Portal
Módulo: Config / Sistema Tipo: View Estado: Implementado Fecha: 2026-04-23
Descripción
Vista integrada dentro del módulo de Configuración del Sistema del ERP que permite a los operadores definir, por sucursal, el gateway de pagos online que utilizará el Portal de Clientes.
Cada sucursal puede tener su propio gateway configurado de forma independiente, o puede no tener ninguno, en cuyo caso los clientes de esa sucursal no podrán realizar pagos online desde el portal.
Valor para el negocio:
- Habilita o deshabilita los pagos online del portal sin necesidad de intervención técnica
- Permite operar con distintos gateways por sucursal según las condiciones comerciales de cada una
- Centraliza la configuración sensible de credenciales en un único lugar seguro del ERP
Contexto:
- La sección forma parte de la pantalla de configuración general del sistema, ubicada después de la configuración de correo electrónico
- Aparece plegada por defecto para no distraer la navegación habitual
- El encabezado de la sección muestra el nombre de la sucursal activa para que el operador sepa sobre qué sucursal está operando
- Si la sucursal no tiene la configuración base inicializada, la sección no se muestra
Funcionalidad
Operaciones principales
- Seleccionar gateway: El operador elige entre los gateways disponibles o la opción de deshabilitar pagos online
- Ingresar credenciales: Según el gateway elegido, el formulario solicita las credenciales correspondientes
- Guardar configuración: Persiste los cambios para la sucursal activa
- Visualizar estado actual: Muestra si la sucursal tiene un gateway configurado y cuál es
Gateways disponibles
| Gateway | Descripción |
|---|---|
| PayPerTIC | Gateway de pagos online argentino |
| MercadoPago | Gateway de pagos de Mercado Libre |
| Sin pagos online | Deshabilita los pagos online para la sucursal |
Credenciales por gateway
| Gateway | Credencial 1 | Credencial 2 | Credencial 3 |
|---|---|---|---|
| PayPerTIC | Clave de API (obligatoria) | — | Token de webhook (obligatorio) |
| MercadoPago | Clave de API (obligatoria) | Clave secreta (obligatoria) | Token de webhook (obligatorio) |
| Sin pagos online | — | — | — |
Comportamiento del formulario
- Los campos de credenciales se muestran enmascarados por defecto (como contraseñas), con la posibilidad de revelar cada uno individualmente
- Al cambiar de MercadoPago a otro gateway, la clave secreta se limpia automáticamente
- Cuando se selecciona "Sin pagos online", no se requiere ninguna credencial
Roles y Permisos
| Rol / Permiso | Acción permitida |
|---|---|
| Operador con permiso de visualización de configuración del sistema | Ver si hay un gateway configurado para la sucursal |
| Operador con permiso de modificación de configuración del sistema | Seleccionar gateway, ingresar credenciales y guardar |
Esta sección no es visible para los clientes del portal. Es de uso exclusivo de los operadores del ERP.
Reglas de Negocio
RN-001: Configuración independiente por sucursal
- Cada sucursal tiene su propia configuración de gateway
- Una sucursal puede usar PayPerTIC mientras otra usa MercadoPago, o ninguna puede tener gateway activo
- El operador solo configura la sucursal activa en cada sesión
RN-002: Credenciales obligatorias según gateway
- Si se selecciona PayPerTIC: la clave de API y el token de webhook son obligatorios; la clave secreta no aplica
- Si se selecciona MercadoPago: la clave de API, la clave secreta y el token de webhook son todos obligatorios
- Si se selecciona "Sin pagos online": no se requiere ninguna credencial; permite guardar la configuración vacía
RN-003: Sin gateway configurado, el portal no acepta pagos
- Si la sucursal no tiene gateway configurado, cualquier intento de un cliente de iniciar un pago desde el portal es rechazado
RN-004: Credenciales siempre enmascaradas
- Las credenciales nunca se muestran en texto plano por defecto
- El operador puede optar por revelar cada campo individualmente para verificar su valor
- Son datos sensibles que deben tratarse con el mismo cuidado que contraseñas
RN-005: Limpieza automática de clave secreta al cambiar gateway
- Si el operador cambia de MercadoPago a cualquier otro gateway, la clave secreta se elimina automáticamente del formulario, ya que ese campo no aplica a otros gateways
RN-006: Sección visible solo si la sucursal tiene configuración base
- Si la sucursal no tiene la configuración base del sistema inicializada, la sección de gateway no se muestra
Casos de Uso
UC-001: Habilitar pagos online para una sucursal
Actor: Operador con permiso de modificación de configuración del sistema
Precondiciones:
- La sucursal está activa en el ERP
- La sucursal tiene la configuración base del sistema inicializada
- El operador tiene a mano las credenciales del gateway a configurar
Flujo principal:
- El operador ingresa al módulo de Configuración → Sistema
- El sistema muestra la sección "Configuración del Gateway de Pagos" plegada, con el nombre de la sucursal activa
- El operador despliega la sección
- El operador selecciona el gateway deseado (PayPerTIC o MercadoPago)
- El sistema muestra los campos de credenciales correspondientes al gateway elegido
- El operador completa las credenciales requeridas
- El operador guarda la configuración
- El sistema confirma que los cambios fueron guardados
Postcondiciones:
- La sucursal tiene un gateway configurado
- El Portal de Clientes de esa sucursal puede procesar pagos online
UC-002: Cambiar de gateway
Actor: Operador con permiso de modificación de configuración del sistema
Precondiciones:
- La sucursal ya tiene un gateway configurado
Flujo principal:
- El operador ingresa a la sección de configuración del gateway
- El sistema muestra el gateway actualmente configurado con sus campos enmascarados
- El operador selecciona un gateway diferente
- Si el gateway anterior era MercadoPago, el sistema limpia automáticamente el campo de clave secreta
- El operador completa las credenciales del nuevo gateway
- El operador guarda la configuración
- El sistema confirma los cambios
Postcondiciones:
- La sucursal opera con el nuevo gateway
- Las credenciales del gateway anterior ya no están activas
UC-003: Deshabilitar pagos online para una sucursal
Actor: Operador con permiso de modificación de configuración del sistema
Precondiciones:
- La sucursal tiene un gateway configurado
Flujo principal:
- El operador ingresa a la sección de configuración del gateway
- El operador selecciona la opción "Sin pagos online"
- El sistema limpia los campos de credenciales (no son necesarios)
- El operador guarda la configuración
- El sistema confirma los cambios
Postcondiciones:
- La sucursal no tiene gateway configurado
- Los clientes del portal de esa sucursal no pueden iniciar pagos online
UC-004: Verificar credenciales de un gateway ya configurado
Actor: Operador con permiso de visualización de configuración del sistema
Precondiciones:
- La sucursal tiene un gateway configurado
Flujo principal:
- El operador ingresa a la sección de configuración del gateway
- El sistema muestra los campos de credenciales enmascarados
- El operador activa el toggle de visibilidad en el campo que desea verificar
- El sistema revela el valor de ese campo en texto plano
- El operador verifica el valor y puede ocultar el campo nuevamente
Criterios de Aceptación
- [ ] Dado que la sucursal tiene la configuración base inicializada, cuando el operador ingresa a Configuración → Sistema, entonces la sección de gateway aparece plegada y con el nombre de la sucursal activa en el encabezado
- [ ] Dado que la sucursal NO tiene configuración base inicializada, cuando el operador ingresa a Configuración → Sistema, entonces la sección de gateway no se muestra
- [ ] Dado que el operador selecciona PayPerTIC, cuando guarda sin completar la clave de API o el token de webhook, entonces el sistema no guarda y notifica los campos faltantes
- [ ] Dado que el operador selecciona MercadoPago, cuando guarda sin completar alguna de las tres credenciales, entonces el sistema no guarda y notifica los campos faltantes
- [ ] Dado que el operador selecciona "Sin pagos online", cuando guarda, entonces el sistema acepta la configuración sin exigir credenciales
- [ ] Dado que el operador cambia de MercadoPago a otro gateway, cuando el cambio ocurre, entonces el campo de clave secreta se limpia automáticamente
- [ ] Dado que las credenciales están configuradas, cuando el operador visualiza la sección, entonces todos los campos de credenciales aparecen enmascarados por defecto
- [ ] Dado que el operador activa el toggle de visibilidad de un campo, cuando lo hace, entonces ese campo específico muestra el valor en texto plano
- [ ] Dado que una sucursal no tiene gateway configurado, cuando un cliente del portal intenta iniciar un pago, entonces el portal rechaza la operación
- [ ] Dado que el operador guarda una configuración válida, cuando el sistema responde, entonces muestra confirmación de que los cambios fueron guardados
Notas Adicionales
- La sección está diseñada para aparecer después de la configuración SMTP dentro de la pantalla de Configuración del Sistema
- El gateway no se prueba ni se valida en tiempo de configuración — el operador es responsable de ingresar credenciales correctas
- Cada sucursal debe configurarse de forma separada; no existe una configuración global de gateway que aplique a todas