MBI Up2pay ETransactions

🎯 Presentación del módulo

MBI Up2pay ETransactions cobra sus facturas y sus pedidos con tarjeta bancaria, en línea, a través de la solución de pago Up2Pay E-Transactions de Crédit Agricole. El módulo añade a Dolibarr un modo de pago « Tarjeta Internet », genera un enlace de pago para cada documento y lo envía a su cliente por correo electrónico. En cuanto el banco confirma la transacción, el cobro se registra automáticamente y la factura pasa al estado pagada. Cumple con la normativa DSP2 y admite 3-D Secure v2.

Funciona exclusivamente con un contrato Up2Pay E-Transactions de Crédit Agricole: las credenciales de comercio (número de sitio, rango, identificador y clave secreta) las facilita el banco. Además, las páginas de retorno del módulo deben ser accesibles desde Internet, ya que el banco las llama directamente para notificar el resultado de las transacciones.

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

💡 Ventajas

• Sus clientes pagan en línea, de inmediato, sin que usted tenga que volver a introducir ningún dato.
• El cobro, el apunte bancario y el paso de la factura al estado pagada son automáticos.
• El enlace de pago se envía junto con la factura, en un correo electrónico que usted redacta una sola vez.
• Puede solicitar un anticipo, o proponer un pago en dos o tres plazos, sin salir de Dolibarr.
• Un modo de prueba permite validar toda la cadena antes de cobrar el primer euro.

⚙️ Funcionalidades clave

💳 Cobro con tarjeta bancaria

• Modo de pago « Tarjeta Internet »: añadido a Dolibarr y utilizable en las facturas y en los pedidos de cliente.
• Enlace de pago seguro: generado por documento, con una huella de un solo uso.
• Página de pago a elegir: una página con los colores de su empresa, o la página de pago en línea nativa de Dolibarr.

✉️ Automatización de los correos electrónicos

• Envío automático del enlace: el enlace de pago se envía en el momento del envío de la factura, con un asunto y una plantilla de mensaje personalizables y una eventual copia a las direcciones que usted elija.
• Imagen de confianza: mostrada en el correo electrónico, recoge el número de teléfono del cliente.
• Correo electrónico de factura pagada: enviado tras el cobro, con el PDF adjunto y asunto y plantilla personalizables.

🧾 Cobros y apuntes

• Anticipo: un campo adicional permite cobrar únicamente una parte del importe, limitada al saldo pendiente.
• Pago en dos o tres plazos: el importe se divide en partes iguales y cada vencimiento se cobra un mes después del anterior.
• Registro automático del cobro: al recibir la respuesta del banco, creación del pago, apunte en la cuenta bancaria configurada y paso de la factura al estado pagada.
• Creación de la factura a partir del pedido: realizada cuando el cobro corresponde a un pedido.

🛡️ Seguridad y arquitectura

• Multientidad: los cobros realizados en una entidad secundaria se vinculan correctamente.
• Tratamiento fiable de las notificaciones del banco: una notificación duplicada no crea un segundo cobro, y una incidencia durante el registro se recupera correctamente en lugar de dejar un apunte incompleto.
• Verificación de firma: las respuestas del banco se controlan mediante clave de 2048 bits.
• Modo de prueba: permite validar la integración sin movimientos reales.
• Permisos dedicados: tres permisos distintos, consulta, creación o modificación, eliminación.

🆕 Novedades recientes (2.0.1 / 2.0 / 1.6.0)

• Página de pago con los colores de su empresa, o redirección a la página de pago en línea nativa de Dolibarr.
• Anticipo y pago en dos o tres plazos ahora disponibles también en los pedidos, y no solamente en las facturas.
• Seguridad reforzada: corrección de una vulnerabilidad en la página de pago pública, verificación de firma mediante clave de 2048 bits y ninguna hoja de estilo cargada desde un tercero durante el pago.
• Cobros más fiables: ningún cobro duplicado en caso de notificación repetida, corrección de los importes con céntimos fraccionados, anticipo limitado al saldo pendiente y pagos en entidad secundaria que ya no se pierden.
• Inicio del pago desde un pedido de cliente, con creación automática de la factura.

✅ Compatibilidad

• Dolibarr: 12.0+ (probado hasta Dolibarr 23)
• PHP: 7.2+
• Contrato Up2Pay E-Transactions (Crédit Agricole): obligatorio, con las credenciales de comercio facilitadas por el banco (número de sitio, rango, identificador y clave secreta), una cuenta bancaria configurada en Dolibarr y las páginas de retorno del módulo accesibles desde Internet.
• Extensión PHP openssl: opcional, utilizada para la verificación de firma de las respuestas.
• Otros módulos: no se requiere ningún otro módulo de Dolibarr y no se declara ninguna incompatibilidad conocida. El módulo se integra en la interfaz estándar de Dolibarr, sin sobrecargar el núcleo.

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 Up2pay ETransactions.
6. Configurar las opciones del módulo desde su página de administración: credenciales de comercio facilitadas por Crédit Agricole, cuenta bancaria de destino de los cobros, asuntos y plantillas de los correos electrónicos.
7. Asignar los permisos necesarios a los usuarios correspondientes.
8. (Como alternativa) Para una instalación manual, copiar la carpeta mbietransactions en /htdocs/custom/.

ℹ️ Observaciones de uso

• El módulo requiere obligatoriamente un contrato Up2Pay E-Transactions con Crédit Agricole y una cuenta bancaria configurada en Dolibarr, en la que se registrarán los cobros.
• Las páginas de retorno del módulo deben ser accesibles desde Internet: el banco las llama directamente para notificar el resultado de las transacciones.
• Antes de la puesta en producción, activar el modo de prueba y pagar una factura de principio a fin para comprobar que la respuesta del banco se procesa correctamente, y luego desactivar el modo de prueba.
• La extensión PHP openssl es opcional, pero recomendable: se utiliza para la verificación de firma de las respuestas.
• La interfaz del módulo está disponible en inglés y en francés.
• 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 y retira las constantes, los permisos y las declaraciones del módulo. Los datos creados se conservan: la tabla de las huellas de pago y los campos adicionales añadidos a las facturas y a los pedidos no se eliminan, con el fin de preservar el historial de las transacciones.

🎓 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 Up2pay ETransactions es un módulo custom de Dolibarr desarrollado por MB Informatique.

Está dirigido a las empresas titulares de un contrato Up2Pay E-Transactions de Crédit Agricole 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 2.0.1 (2026-07-30)

• Seguridad: las páginas de resultado del pago ya no cargan ninguna hoja de estilo desde Google, de modo que el navegador de su cliente no es contactado por un tercero durante el pago.
• Corrección: la hoja de estilo del pago en línea configurada en Dolibarr se aplica ahora a las páginas de resultado del pago; se construía y luego se descartaba.
• Mejora: la documentación del módulo se muestra en el idioma del usuario en la pestaña Acerca de, en inglés, francés, alemán, italiano y español.

UPDATE 2.0 (2026-06-18)

• ⚠️ 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: página de pago personalizada opcional, o redirección a la página de pago en línea nativa de Dolibarr (comportamiento predeterminado sin cambios).
• Novedad: el anticipo y el pago en dos o tres plazos están ahora disponibles también en los pedidos, y no solamente en las facturas.
• Seguridad: corregida una vulnerabilidad en la página de pago pública y reforzada la verificación de firma, que utiliza ahora una clave de 2048 bits.
• Mejora: una notificación duplicada del banco ya no crea un segundo cobro, y un fallo durante el registro se recupera correctamente en lugar de dejar un cobro parcial.
• Corrección: las opciones de anticipo y de pago en varios plazos se ignoraban desde la versión 1.6 y no eran modificables en el documento; ambas quedan restablecidas.
• Corrección: un importe con un céntimo fraccionado podía cobrarse hasta cien veces más alto.
• Corrección: un anticipo superior al saldo pendiente ya no puede cobrar más de lo debido.
• Corrección: los pagos realizados en una entidad secundaria se perdían y ahora se registran.
• Compatibilidad: soporte de PHP 8.5, versión mínima de Dolibarr elevada a 12.0.

UPDATE 1.6.0 (2025-08-08)

• Novedad: el pago puede iniciarse desde un pedido de cliente, con creación automática de la factura.
• Mejora: el enlace de pago puede generarse cuando un pago se valida a través de la API de Dolibarr.
• Corrección: pequeño problema de validación del número de teléfono.

UPDATE 1.5.0 (2024-09-25)

• Novedad: añadidos los ajustes del número de teléfono en la configuración del módulo.

UPDATE 1.4.0 (2024-08-20)

• Novedad: ajuste para controlar el momento en que una factura se marca como pagada.
• Compatibilidad: soporte de la última versión de Dolibarr y del multiempresa.

UPDATE 1.3.0 (2023-11-15)

• Corrección: verificación del modo de pago con respecto al núcleo de Dolibarr.
• Mejora: código depurado y optimizado.

UPDATE 1.2.0 (2023-10-06)

• Seguridad: añadida la clave pública y activada la verificación de firma.
• Seguridad: protección global reforzada.
• Corrección: varios problemas menores.

UPDATE 1.1.0 (2023-07-26)

• Novedad: los asuntos de los correos electrónicos pueden definirse desde la configuración del módulo.
• Novedad: añadidas las traducciones al inglés.
• Mejora: actualizado el estilo de visualización.
• Corrección: varios problemas.

UPDATE 1.0

• Versión inicial.