Setup de Mobbex

Mobbex es una pasarela de pagos electrónica utilizada por Plenario v14 para generar órdenes de pago, suscripciones (débitos recurrentes) y procesar cobros mediante WebHooks. La pantalla Setup de Mobbex centraliza las credenciales y la URL de la API que el sistema necesita para autenticarse contra los servicios de Mobbex.

Sin un setup activo y con credenciales válidas, las operaciones contra Mobbex (orden de pago, alta de suscripción, alta de suscriptor, consultas) devuelven un error indicando que la configuración está inactiva.

Con el setup activo, el sistema genera los links de pago con los que los clientes pagan sus cuotas desde la web MisCreditos, la web de clientes y la API. Cuántas cuotas ofrece ese link y cuánto tiempo vale se define con dos parámetros del sistema: ver Cuotas y vencimiento del link de pago, más abajo.

Se ingresa desde el menú Herramientas → Mobbex → Setup de la aplicación de escritorio. El botón valida el permiso correspondiente antes de abrir el formulario; si el usuario no tiene permiso, la pantalla no se abre.

La misma configuración también se puede editar desde la versión web del sistema, en la opción Configuracion Mobbex del menú lateral (junto a Configuracion Nosis y Configuracion RiesgoNet).

Formulario modal de tamaño fijo titulado "Setup de Mobbex". Carga automáticamente la única fila de configuración existente (si la hay) o presenta los campos vacíos para crear una nueva. Los datos se editan directamente sobre los controles y se confirman con el botón Aceptar de la barra superior.

Nota: No se deben divulgar los valores reales de X Api Key ni de X Access Token; son credenciales sensibles entregadas por Mobbex para cada cuenta de comercio.

Cuotas y vencimiento del link de pago

Las cuotas que ofrece el link de pago y el tiempo que vale no se cargan en esta pantalla: se definen con dos parámetros del sistema, en el ABM de Parámetros (categoría Terceros). Aplican a todos los links de pago de Mobbex: los de la web MisCreditos, los de la web de clientes y los que genera la API. No afectan las suscripciones (débito automático).

Importante: desde septiembre de 2026 (changeset 23620) el link sale por defecto con un solo pago y vence en el día. Antes ofrecía todas las cuotas de la cuenta y duraba 10 días. Para volver a eso, cargar 0 en los dos parámetros.

Los dos se crean solos al actualizar la versión, o la primera vez que se genera un link. Su descripción en el ABM explica qué cargar.

Cuotas máximas

Mobbex no acepta un "máximo de cuotas": recibe una lista de planes, y cada cuenta los nombra distinto (1, 1_debit, ahora_3…). Por eso, antes de generar el link, el sistema le consulta a Mobbex qué planes tiene la cuenta para ese importe y le manda solo los de esa cantidad de cuotas o menos. Así funciona con cualquier cuenta, incluidas las tarjetas de débito, cuyo plan de un pago suele llamarse 1_debit.

• Tarjetas que quedan afuera: si una tarjeta no tiene ningún plan de esa cantidad de cuotas o menos, no se puede usar en ese link. Por ejemplo, con 1, una tarjeta que solo ofrece 6 cuotas queda afuera.
• Si no se puede filtrar, el link se genera igual sin limitar las cuotas y queda un aviso en el log de errores. Pasa si falla la consulta a Mobbex o si la cuenta no tiene ningún plan de esa cantidad de cuotas o menos para ese importe. El cliente siempre puede pagar.
• Interés: quién paga el costo financiero de las cuotas se define en la cuenta de Mobbex, no en Plenario. La cuota del crédito se imputa siempre por el importe del link.

Días de vigencia

Se usa 1 día porque las cuotas devengan punitorios todos los días: con un link viejo, el cliente pagaría menos de lo que corresponde. Mobbex maneja el vencimiento por fecha, sin hora, y el link deja de valer a las 00:00 de esa fecha. El sistema manda la fecha de hoy más los días configurados: con 1 manda la fecha de mañana, o sea que el link vale hasta la medianoche de hoy.

Importante: si se le manda la fecha del mismo día, Mobbex la ignora y aplica sus 10 días. Por eso el mínimo útil es 1.

Cuándo toma efecto: en los links que se generan después del cambio; los ya enviados conservan sus cuotas y su vencimiento. La web MisCreditos, la web de clientes y la API guardan los parámetros en memoria: después de cambiarlos hay que reciclar sus AppPool.

Configuraciones típicas

Al presionar Aceptar, el sistema valida el formulario y guarda la configuración (alta si no existía, o modificación de la fila existente). Si el guardado es exitoso, la ventana se cierra. Si falla, se muestra el mensaje "No se pudo guardar". Ante un error inesperado, se registra en el log de la aplicación y se muestra el aviso genérico de error para avisar a Sistemas.

• Cargar credenciales: completar Api Uri Root, X Api Key y X Access Token.
• Activar / desactivar la integración: marcar o desmarcar la casilla Activo.
• Guardar: botón Aceptar de la barra superior; persiste los cambios y cierra el formulario.
• Definir cuotas y vencimiento del link de pago: no se hace en esta pantalla sino en el ABM de Parámetros (ver Cuotas y vencimiento del link de pago).

1. El operador recibe de Mobbex las credenciales de su cuenta (API Key, Access Token) y la URL de la API.
2. Ingresa a Herramientas → Mobbex → Setup.
3. Completa Api Uri Root con la URL provista, pega la X Api Key y el X Access Token.
4. Marca Activo.
5. Presiona Aceptar. La integración queda lista para generar órdenes de pago y suscripciones.

• Mantené Activo desmarcado mientras cargás o rotás credenciales para evitar que se envíen solicitudes con datos incompletos.
• Verificá que la Api Uri Root corresponda al ambiente correcto (producción) antes de operar con cobros reales.
• Solo existe una fila de configuración: editar el setup pisa la configuración anterior.
• Las solicitudes a Mobbex se envían sobre TLS 1.2.

Para abrir el formulario de escritorio el usuario debe tener habilitado el permiso Herramientas.Mobbex.Setup (categoría padre Herramientas.Mobbex). Descripción del permiso en el sistema: "Permite el ingreso al formulario Setup de Mobbex".

En la versión web, el permiso Herramientas.Mobbex.Ver habilita ver la configuración y también guardarla.

Basada en el análisis del formulario real de la v14

Formularios principales

Managers y clases

Parámetros del link de pago

Los crea Script.PostDeployment.sql (bloque MOBBEX) si no existen; si no, nacen en la primera lectura (Generic_Base_Manager.GetParameter).

Permisos reales

Tablas de base de datos principales

Relación con otros módulos / manuales

Notas para soporte

• El cliente REST (Rest_Mobbex) arma los encabezados x-api-key y x-access-token con los valores del setup solo cuando Activo está en verdadero.
• Las solicitudes se envían con SecurityProtocolType.Tls12.
• La configuración de cuotas y vencimiento solo se aplica con el setup Activo, y no pisa cuotas ni vencimiento que ya haya cargado quien genera el link.
• Los avisos de configuración (valor inválido, consulta de planes fallida, cuenta sin planes) se registran una sola vez por proceso: si el problema sigue, no se repite en el log hasta reciclar el AppPool.
• Para ver qué tomó Mobbex: con Web.Mobbex.Request.RegisterLogTrace habilitado, el log de la API (LogTraceRestApi\LogTrace_yyyyMMdd.txt) guarda la respuesta con los installments y el dueDate del link.
• Formulario de tecnología legacy (WinForms/DevExpress sobre EF). Verificar contra el binario instalado en el cliente.