Detalle
| Campo | Valor |
|---|---|
| Manual de Usuario | Setup de Mobbex |
| Módulo | Herramientas |
| Formulario | FormMobbex_Setup |
| Tipo de pantalla | Configuración de integración (pasarela de pagos) |
Introducción
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.
Acceso al módulo
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.
Pantalla principal
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.
Parámetros
| Campo | Descripción |
|---|---|
| Api Uri Root | URL base de la API de Mobbex contra la que se envían las solicitudes (por ejemplo, el endpoint productivo de Mobbex). Es la raíz que el cliente REST usa para construir las llamadas a órdenes de pago y suscripciones. |
| X Api Key | Clave de API (x-api-key) provista por Mobbex. Se envía como encabezado de autenticación en cada solicitud. |
| X Access Token | Token de acceso (x-access-token) provisto por Mobbex. Acompaña a la X Api Key en los encabezados de autenticación. |
| Activo | Casilla que habilita o deshabilita la integración. Si está desactivada, el sistema no envía solicitudes a Mobbex y devuelve un mensaje indicando que la configuración está inactiva. |
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.
Resultado del proceso
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.
Acciones disponibles
- 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.
Ejemplo práctico
- El operador recibe de Mobbex las credenciales de su cuenta (API Key, Access Token) y la URL de la API.
- Ingresa a Herramientas → Mobbex → Setup.
- Completa Api Uri Root con la URL provista, pega la X Api Key y el X Access Token.
- Marca Activo.
- Presiona Aceptar. La integración queda lista para generar órdenes de pago y suscripciones.
Consejos útiles
- 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.
Preguntas frecuentes
¿Qué pasa si dejo la casilla Activo desmarcada?
El sistema no enviará solicitudes a Mobbex. Cualquier operación (orden de pago, suscripción) devolverá un error indicando que la configuración de Mobbex está inactiva.¿De dónde obtengo la X Api Key y el X Access Token?
Son credenciales que entrega Mobbex al dar de alta la cuenta de comercio. Se gestionan desde el panel de Mobbex y se pegan tal cual en este setup.¿Puedo tener más de una configuración de Mobbex?
El formulario trabaja sobre una única fila de configuración. Al guardar, se actualiza esa fila o se crea si todavía no existía.¿Por qué los cobros entran por WebHook y no se ven en este setup?
Este formulario solo configura las credenciales y la URL. La recepción de cobros y notificaciones de Mobbex se procesa por WebHooks y se registra en las tablas de log de Mobbex, que se consultan desde otras pantallas.Permisos
Para abrir el formulario 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".
Información técnica
Basada en el análisis del formulario real de la v14
Formularios principales
| Form | Rol |
|---|---|
| FormMobbex_Setup | Pantalla de configuración de credenciales y URL de la pasarela Mobbex |
Permisos reales
| Permiso | Acción |
|---|---|
| Herramientas.Mobbex.Setup | Permite el ingreso al formulario Setup de Mobbex |
Tablas de base de datos principales
| Tabla | Uso |
|---|---|
| Mobbex_Setup | Almacena la configuración: ApiUriRoot, X_Api_Key, X_Acces_Token, Activo |
| Mobbex_Log | Log de solicitudes/respuestas hacia Mobbex (consumido por el cliente REST, no por este form) |
| Mobbex_Hooks | Notificaciones (WebHooks) recibidas de Mobbex |
| Mobbex_Hooks_Cobros | Detalle de cobros asociados a cada WebHook |
Relación con otros módulos / manuales
| Manual relacionado | Vínculo operativo |
|---|---|
| Configuración SETUP (NOSIS/VERAZ/AFIP/SMS) - Herramientas | Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad. |
Notas para soporte
- El cliente REST (
Rest_Mobbex) arma los encabezadosx-api-keyyx-access-tokencon los valores del setup solo cuando Activo está en verdadero. - Las solicitudes se envían con
SecurityProtocolType.Tls12. - Formulario de tecnología legacy (WinForms/DevExpress sobre EF). Verificar contra el binario instalado en el cliente.