MBI Monetico

🎯 Presentación del módulo

MBI Monetico cobra sus facturas y sus pedidos con tarjeta bancaria, en línea, a través de Monetico, la solución de pago de CIC y de Crédit Mutuel. El módulo propone un enlace de pago a su cliente desde la ficha de la factura o del pedido, lo conduce a la plataforma segura de su banco y, a continuación, registra el cobro en Dolibarr en cuanto el pago es autorizado. La factura pasa al estado pagada, el cobro se concilia con su cuenta bancaria y su cliente recibe su confirmación por correo electrónico, sin intervención por su parte.

Funciona exclusivamente con un contrato Monetico Paiement activo de CIC o de Crédit Mutuel: las tres credenciales de comercio — número de TPV, código de sociedad y clave MAC — las facilita el banco. Además, las páginas de notificación y de retorno del módulo deben ser accesibles desde Internet, en HTTPS y sin autenticación previa, y la dirección de notificación debe declararse en su back-office Monetico.

🌐 Demo: https://demo.mbicloud.fr 🛒 Descubra nuestros otros módulos en Dolistore.

💡 Ventajas

• Sus clientes pagan en línea, de inmediato, con tarjeta bancaria.
• El cobro, la conciliación bancaria y el paso de la factura al estado pagada son automáticos.
• El pago puede iniciarse desde un pedido: la factura se crea por sí sola al recibirse el cobro.
• Su cliente recibe su confirmación de pago por correo electrónico, con la factura adjunta, sin intervención por su parte.
• Un modo de prueba permite validar toda la cadena antes de cobrar el primer euro.

⚙️ Funcionalidades clave

💳 Cobro con tarjeta bancaria vía Monetico

• Pago Monetico propuesto al cliente: en la página de pago en línea pública de Dolibarr, con un botón específico y la indicación del tipo de tarjeta aceptada.
• Botón de pago en la ficha de la factura: disponible siempre que la factura ya no esté en borrador y quede un importe pendiente de pago.
• Botón de pago en la ficha del pedido: disponible mientras no haya ninguna factura vinculada.
• Redirección segura hacia el banco: el formulario de pago se sella con la clave de su contrato antes de presentarse al cliente.
• Modo de prueba: dirige el conjunto de las transacciones hacia la plataforma de ensayo de Monetico.

🧾 Del pedido a la factura pagada

• Registro automático del cobro: al recibirse la confirmación bancaria, creación de un pago con tarjeta bancaria, conciliación en la cuenta bancaria seleccionada y paso de la factura al estado pagada cuando el saldo queda a cero.
• Cadena completa desde un pedido: el pedido aún en borrador se valida, se crea la factura correspondiente, el cobro se registra en ella y el pedido se clasifica como facturado.
• Validación automática de una factura en borrador: realizada antes del registro del cobro.
• Facturación posible pese a un artículo retirado del catálogo: la línea afectada se recupera como línea libre en lugar de bloquear la creación de la factura.

✉️ Confirmación al cliente y trazabilidad

• Correo electrónico de confirmación al cliente: enviado tras el cobro, basado en una plantilla de mensaje que usted elige, con el PDF de la factura adjunto cuando existe.
• Trazabilidad en la agenda: cada envío de confirmación se registra como evento, vinculado a la factura y al cliente.
• Página de retorno personalizada: confirma al cliente la aceptación o el rechazo del pago, con los colores y los datos de contacto de su empresa.

🔐 3-D Secure y controles previos

• Opciones 3-D Secure: usted indica al banco su preferencia en materia de autenticación del titular de la tarjeta — desactivación, desafío deseado, desafío obligatorio, ausencia de desafío o solicitud de exención.
• Control previo de la dirección del cliente: el pago no se propone cuando la calle, el código postal o la ciudad están incompletos, y un mensaje lo indica en pantalla.
• Administración en cuatro pestañas: ajustes, acerca de, historial de modificaciones y activación, con la dirección de notificación que debe copiarse en su back-office Monetico mostrada lista para su uso.

🛡️ Seguridad y arquitectura

• Multientidad: la entidad correspondiente se transmite de principio a fin, y en los ajustes solo se proponen las cuentas bancarias de la entidad en curso.
• Control de autenticidad de las confirmaciones bancarias: mediante un sello calculado con la clave de su contrato, una notificación no conforme nunca se registra.
• Protección frente a los cobros duplicados: una confirmación reenviada dos veces por el banco nunca crea un segundo cobro.
• Tratamiento fiable de principio a fin: la respuesta esperada por el banco se emite en todos los casos, incluso cuando otro módulo provoca un error durante el tratamiento.
• Módulo concebido para integrarse en la interfaz estándar de Dolibarr, sin sobrecargar el núcleo.

🆕 Novedades recientes (1.9.3 / 1.9.2 / 1.9.1)

• Funcionamiento en multiempresa consolidado: la entidad se conserva de principio a fin en el pago y en la página de retorno, y la pantalla de ajustes solo lista las cuentas bancarias de la entidad en curso.
• El envío del correo electrónico de confirmación al cliente se registra en la agenda, vinculado a la factura y al cliente correspondientes.
• El correo electrónico de confirmación incluye un identificador de seguimiento, de modo que puede localizarse de nuevo entre los intercambios.
• Un pedido aún en borrador se valida automáticamente antes de la creación de su factura, al recibirse el cobro.
• Las advertencias generadas por las versiones recientes de PHP ya no aparecen.

✅ Compatibilidad

• Dolibarr: 12.0+ (probado hasta Dolibarr 23, sin versión máxima declarada)
• PHP: 7.2+
• Contrato Monetico Paiement (CIC / Crédit Mutuel): obligatorio, con las tres credenciales de comercio facilitadas por el banco (número de TPV, código de sociedad y clave MAC). El módulo no funciona con ningún otro adquirente.
• Accesibilidad desde Internet: las páginas de notificación y de retorno del módulo deben ser accesibles en HTTPS y sin autenticación previa, la dirección pública de su instancia debe estar correctamente indicada en la configuración de Dolibarr y la dirección de notificación debe declararse en su back-office Monetico.
• Extensiones PHP json, hash, curl y openssl: obligatorias, así como un acceso saliente en HTTPS hacia el servidor de activación de MB Informatique.
• Modo de pago CB: debe existir en el diccionario de los modos de pago de la entidad correspondiente.
• Otros módulos: no se requiere ningún otro módulo de Dolibarr y no se declara ninguna incompatibilidad.

Module version: auto
Editor/Licencia: MB Informatique / GPL-v3
Idioma de la interfaz: Inglés, Francés
Asistencia: MB Informatique
Requisitos previos:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Instalación

1. Descargar el archivo ZIP del módulo sin descomprimirlo.
2. En Dolibarr, ir a Inicio > Configuración > Módulos/Aplicaciones.
3. Abrir la pestaña Desplegar/Instalar un módulo externo.
4. Enviar el archivo ZIP del módulo.
5. Buscar y luego activar MBI Monetico.
6. Abrir la pestaña Activación de la página de administración del módulo, introducir la referencia de su pedido y activar la licencia: mientras el módulo no esté activado, la pantalla de ajustes permanece cerrada.
7. Abrir la pestaña Ajustes, introducir las tres credenciales de comercio facilitadas por su banco, elegir la cuenta bancaria de conciliación, la plantilla de correo electrónico de confirmación y las opciones 3-D Secure deseadas, y copiar la dirección de notificación mostrada en la parte inferior de la pantalla para declararla en su back-office Monetico.
8. (Como alternativa) Para una instalación manual, copiar la carpeta mbimonetico en /htdocs/custom/.

ℹ️ Observaciones de uso

• El módulo requiere obligatoriamente un contrato Monetico Paiement activo con CIC o con Crédit Mutuel; no funciona con ningún otro adquirente.
• Las páginas de notificación y de retorno deben ser accesibles desde Internet, en HTTPS y sin autenticación previa: el banco llama a la primera para confirmar las transacciones y el navegador de su cliente abre la segunda.
• Un acceso saliente en HTTPS hacia el servidor de activación de MB Informatique es necesario para activar el módulo y mantener su licencia válida; sin él, el módulo deja de proponer el pago al término del período de validez en curso.
• Antes de la puesta en producción, activar el modo de prueba y pagar una factura de principio a fin para comprobar que la confirmación del banco se procesa correctamente, y luego desactivar el modo de prueba.
• Sin cuenta bancaria seleccionada, el cobro sí se registra en la factura, pero no se concilia con un apunte bancario. Dejar vacía la plantilla de correo electrónico desactiva el envío de la confirmación al cliente.
• Una base de datos MySQL o MariaDB aporta la protección más estricta frente a un cobro duplicado cuando dos confirmaciones llegan exactamente en el mismo instante. Algunas opciones 3-D Secure, en particular la solicitud de exención por análisis de riesgo, requieren una opción específica de su contrato de comercio.
• La interfaz del módulo está disponible en inglés y en francés; las traducciones alemana, española e italiana son parciales.
• Realizar una copia de seguridad de la base de datos y de los archivos de Dolibarr antes de cualquier actualización, y a continuación instalar el nuevo archivo sobre la versión existente. Algunas versiones requieren desactivar y volver a activar el módulo para que surtan efecto; el ChangeLog lo indica explícitamente al principio de la versión correspondiente.
• La desactivación del módulo libera la activación de la licencia, borra la referencia de pedido y la clave de licencia conservadas localmente, y retira los permisos y las declaraciones del módulo. Los ajustes funcionales se conservan, y los datos producidos — pagos, apuntes bancarios, facturas creadas a partir de pedidos y eventos de agenda — se mantienen, ya que son datos contables.

🎓 Servicios

• Formación sobre el módulo disponible por 80 € IVA excluido.
• Soporte y actualizaciones incluidos durante toda la vigencia de su licencia.

📄 Licencia y condiciones de uso

El módulo se distribuye bajo licencia GNU General Public License v3 o posterior (GPL v3+); el texto completo figura en el archivo COPYING entregado con el módulo.

Las Condiciones Generales de Uso completas se entregan con el módulo y pueden consultarse desde su pestaña «Acerca de» en Dolibarr. Nuestras Condiciones Generales de Venta están disponibles en https://www.mb-informatique.fr/cgv.html.

👨 💻 Editor

MBI Monetico es un módulo custom de Dolibarr desarrollado por MB Informatique.

Está dirigido a las empresas titulares de un contrato Monetico Paiement con CIC o con Crédit Mutuel que deseen cobrar sus facturas y sus pedidos con tarjeta bancaria directamente desde Dolibarr, sin volver a introducir datos y sin herramienta intermedia.

Editor: MB Informatique
Contacto: info@mb-informatique.fr
Sitio web: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 1.9.3 (2026-06-24)

• Mejora: las advertencias generadas por las versiones recientes de PHP ya no aparecen.
• Corrección: la pantalla de ajustes solo lista ahora las cuentas bancarias de la entidad en curso.
• Compatibilidad: el pago y la página de retorno funcionan en una configuración multiempresa, conservándose la entidad de principio a fin.

UPDATE 1.9.2 (2026-05-27)

• Novedad: el envío del correo electrónico de confirmación al cliente se registra en la agenda, vinculado a la factura y al cliente correspondientes.
• Mejora: el correo electrónico de confirmación incluye un identificador de seguimiento, de modo que puede localizarse de nuevo entre los intercambios.

UPDATE 1.9.1 (2026-05-19)

• Mejora: un pedido aún en borrador se valida automáticamente antes de la creación de su factura, al recibirse el cobro.

UPDATE 1.9.0 (2026-04-20)

• Novedad: dos ajustes permiten indicar al banco el nivel de autenticación 3-D Secure del titular de la tarjeta que usted espera.
• Novedad: la opción elegida — desactivación, desafío deseado, desafío obligatorio o solicitud de exención — se transmite al banco en cada transacción.

UPDATE 1.8.0 (2026-04-08)

• ⚠️ Acción necesaria: desactivar y volver a activar el módulo después de la actualización, para aplicar los cambios introducidos por esta versión.
• Novedad: el pago puede iniciarse desde un pedido; la factura se crea automáticamente al recibirse el cobro y el pedido se clasifica como facturado.
• Novedad: un botón de pago Monetico aparece en la ficha del pedido, mientras no haya ninguna factura vinculada a él.
• Novedad: una nueva pestaña muestra el historial de modificaciones del módulo.
• Mejora: la interfaz está disponible en más variantes regionales del inglés y del francés; las traducciones alemana, española e italiana son parciales.
• Corrección: una línea de pedido cuyo producto se ha retirado del catálogo ya no impide la facturación.

UPDATE 1.6.0 (2025-08-07)

• Novedad: el pago puede iniciarse desde un pedido, con creación automática de la factura correspondiente.
• Novedad: una opción añade un botón de pago Monetico en la ficha del pedido.

UPDATE 1.5.3 (2024-10-31)

• Novedad: el pago en 2, 3 o 4 plazos, señalado en pantalla como en desarrollo, se propone con su calendario y sus eventuales gastos adicionales.
• Mejora: la pantalla de ajustes acepta campos de introducción de importes.

UPDATE 1.5.2 (2024-05-29)

• Corrección: pago de los documentos emitidos en un contexto multidivisa.

UPDATE 1.5.1 (2024-05-28)

• Corrección: la cuenta bancaria en la que se registra el cobro.
• Corrección: la factura adjunta al correo electrónico de confirmación no siempre se encontraba.

UPDATE 1.5 (2024-05-17)

• Mejora: los pagos realizados en modo de prueba se registran como los reales, lo que permite validar la conexión de principio a fin.
• Corrección: al pagar, la factura se identificaba por su referencia, lo que podía designar el documento equivocado.

UPDATE 1.4.0 (2024-05-16)

• Mejora: se ha rediseñado la presentación de la interfaz.

UPDATE 1.3.0 (2024-05-15)

• Mejora: los modos de pago propuestos al cliente se han corregido y optimizado.

UPDATE 1.2.0 (2024-04-05)

• Seguridad: se ha reforzado la seguridad del módulo.

UPDATE 1.1.0 (2024-03-07)

• Novedad: una opción añade un botón de pago Monetico en la ficha de la factura.
• Compatibilidad: se ha corregido un problema de compatibilidad con Dolibarr durante el pago.

UPDATE 1.0.2 (2023-09-04)

• Corrección: el pago podía fallar cuando el documento no llevaba ninguna divisa; ahora se utiliza el euro de forma predeterminada.

UPDATE 1.0

• Novedad: versión inicial del módulo.