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. Con la versión 2.1.0, el pago desde un pedido de cliente funciona plenamente: el enlace se crea al validar el pedido, apunta a ese mismo pedido y se envía junto con el correo electrónico de envío del pedido, exactamente igual que en las facturas. 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 o con el pedido, 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.
• El cliente conoce el calendario completo de vencimientos antes de introducir su tarjeta: sin sorpresas ni reclamaciones.
• Un modo de prueba permite validar toda la cadena antes de cobrar el primer euro.
• Módulo y documentación traducidos a seis idiomas completos: inglés, francés, alemán, español, italiano y portugués.

⚙️ 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.
• Importe recalculado en el momento del cobro: la cantidad que se cobra la determina el módulo a partir del documento, y no la página mostrada al cliente.

📦 Pago desde un pedido

• Enlace creado al validar el pedido: permite saldar ese mismo pedido, y no otro documento.
• Envío junto con el pedido: el enlace llega al cliente cuando el pedido se envía por correo electrónico, igual que en las facturas.
• Creación de la factura a partir del pedido: realizada automáticamente cuando el cobro corresponde a un pedido.
• Anticipo y plazos en los pedidos: las mismas opciones disponibles en las facturas se aplican a los pedidos de cliente.

✉️ 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 o del pedido, 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.

🧾 Anticipo, plazos 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.
• Calendario anunciado antes de la introducción de la tarjeta: la página de pago indica el importe que se cobra hoy, así como la fecha y el importe de cada cargo posterior.
• Tarjeta comprobada durante toda la duración del calendario: una tarjeta que caduque antes del último vencimiento se rechaza en el momento de la compra, cuando el cliente todavía puede presentar otra.
• 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.

🛡️ Seguridad y arquitectura

• Enlace sin objeto rechazado automáticamente: una factura saldada, abandonada o todavía en borrador, así como un pedido ya facturado, anulado o todavía en borrador, deja de poder pagarse.
• Protección contra el doble cobro: mientras un calendario de vencimientos está en curso en el banco, la reapertura del enlace se rechaza; una vez terminado el calendario, el saldo sigue pudiendo pagarse de una sola vez.
• Tratamiento fiable de las notificaciones del banco: una notificación duplicada no crea un segundo cobro, un importe superior al saldo nunca se registra tal cual, 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.
• Multientidad: los cobros realizados en una entidad secundaria se vinculan correctamente.
• 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.1.0 / 2.0.1 / 2.0)

• El pago desde un pedido de cliente funciona realmente: el enlace se crea al validar el pedido, abre ese mismo pedido y se envía al cliente junto con el pedido remitido por correo electrónico.
• La página de pago anuncia el calendario completo — importe del día, fecha e importe de cada cargo futuro — antes de que el cliente introduzca su tarjeta, y rechaza una tarjeta que caduque antes del último vencimiento.
• Un enlace que ya no tiene objeto se rechaza: factura saldada, abandonada o en borrador, pedido ya facturado, anulado o en borrador; y un calendario de vencimientos en curso en el banco bloquea toda reapertura del enlace.
• El importe cobrado se recalcula en el servidor a partir del documento, y un aviso del banco superior al saldo ya no se registra tal cual.
• El módulo y su documentación están ahora disponibles en seis idiomas completos: inglés, francés, alemán, español, italiano y portugués.
• Página de pago personalizada con los colores de su empresa, o redirección a la página de pago en línea nativa de Dolibarr; 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.

✅ 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.
• Idiomas disponibles: inglés, francés, alemán, español, italiano, portugués.
• 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, Alemán, Español, Italiano, Portugué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.
• El pago en dos o tres plazos es una opción de su contrato Up2pay y no un ajuste del módulo: sin ella, el banco rechaza el pago.
• 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, francés, alemán, español, italiano y portugué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.1.0 (2026-08-02)

• ⚠️ Acción requerida: desactive y vuelva a activar el módulo después de la actualización, para que se añada el campo « Enlace de pago » en los pedidos.
• Novedad: el enlace de pago del módulo ya funciona en los pedidos. Antes abría una factura sin relación con el pedido, o anunciaba un enlace caducado.
• Novedad: el enlace de pago de un pedido se genera al validarlo, y se envía al cliente cuando el pedido se envía por correo electrónico, igual que en las facturas.
• Seguridad: el importe cobrado se recalcula ahora en el servidor. Procedía de un campo del formulario de pago, que un cliente podía modificar para pagar menos del importe debido.
• Seguridad: un saldo parcialmente pagado ya no vuelve a fraccionarse en dos o tres plazos. Un cliente que reabriera su enlace de pago podía lanzar un segundo calendario sobre el ya programado por el banco, y que se le cobrara más del importe debido. Pasado el primer cobro, el saldo se cobra de una sola vez.
• Corrección: la factura creada a partir de un pedido ya no hereda el pago en dos o tres plazos de este, cuyo calendario pertenece al pedido.
• Corrección: las fechas de vencimiento ya no se desbordan al mes siguiente. Un vencimiento calculado desde un día 31 caía tres días tarde; ahora cae el último día del mes previsto.
• Corrección: en un pago en dos o tres plazos, una tarjeta que caduque antes del último vencimiento se rechaza ahora en el momento de la compra, cuando el cliente todavía puede presentar otra. Antes se aceptaba, y los vencimientos siguientes fallaban varias semanas después de la venta.
• Seguridad: una factura totalmente pagada, abandonada o todavía en borrador ya no puede pagarse desde el enlace del módulo. El enlace, creado en la validación, no caducaba nunca y seguía aceptando cobros sobre una factura que ya no debía nada.
• Seguridad: el enlace se rechaza cuando ya hay un pago a plazos en curso. Los vencimientos restantes están en poder del banco, que los cobra por sí solo: reabrir el enlace hacía pagar por segunda vez un importe ya comprometido. Un cobro registrado a mano, en cambio, deja el enlace utilizable para el saldo.
• Mejora: la página de pago anuncia el calendario completo — importe del día y fecha de cada cargo futuro — antes de que el cliente introduzca su tarjeta. Solo mostraba el primer vencimiento, bajo la etiqueta « importe total del pago ».
• Mejora: la página de configuración recuerda que el pago en dos o tres plazos es una opción de su contrato Up2pay, y no un ajuste del módulo. Sin ella, el banco rechaza el pago y su cliente solo lee un « pago rechazado » sin motivo.
• Corrección: un importe demasiado pequeño para fraccionarse — menos de 2 € en dos plazos, menos de 3 € en tres — se cobra ahora de una sola vez. El pago quedaba bloqueado, con un mensaje que anunciaba erróneamente que el importe era inferior a 1 € cuando solo lo era el plazo.
• Seguridad: un aviso del banco con un importe superior al saldo de la factura ya no se registra tal cual. Se cobra el saldo y el exceso se indica en el registro: una factura no puede deber más que su saldo, y anotarlo falsearía la conciliación bancaria.
• Mejora: conformidad con el kit de integración oficial Up2pay e-Transactions — el nombre del titular siempre se rellena, la segunda línea de la dirección se transmite, y tanto la lista de datos de retorno como la verificación de firma se ajustan al ejemplo facilitado por el banco.
• Mejora: un importe inferior al mínimo de un euro aceptado por el banco se indica claramente al cliente, en lugar de terminar en un error de la página de pago.
• Mejora: el aviso de pago del banco se confirma en cuanto se registra el cobro, antes de generar el PDF y de enviar el correo electrónico. Desaparecen las alertas « Warning e-Transactions » debidas al tiempo de espera.
• Corrección: un pedido ya facturado, cancelado o todavía en borrador ya no puede pagarse desde el enlace del módulo.

UPDATE 2.0.1 (2026-07-30)

• Seguridad: las páginas de resultado del pago ya no cargan una hoja de estilos desde Google, por lo que el navegador de su cliente no es requerido por un tercero durante el cobro.
• Corrección: la hoja de estilos de pago en línea configurada en Dolibarr se aplica ahora a las páginas de resultado; 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 requerida: desactive y vuelva 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 con la imagen de su empresa, 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 solo en las facturas.
• Seguridad: corregida una vulnerabilidad en la página de pago pública y reforzada la verificación de firma, ahora con clave de 2048 bits.
• Mejora: un aviso duplicado de la pasarela ya no crea un segundo cobro, y un fallo durante el registro se reintenta limpiamente en lugar de dejar un cobro incompleto.
• Corrección: las opciones de anticipo y de pago fraccionado se ignoraban desde la 1.6 y no eran modificables en la ficha; ambas quedan restablecidas.
• Corrección: un importe con una fracción de céntimo 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 que queda por pagar.
• Corrección: los pagos realizados en una entidad secundaria se perdían, ahora quedan registrados.
• Compatibilidad: compatible con 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, creándose la factura automáticamente.
• Mejora: el enlace de pago puede generarse al validar un cobro a través de la API de Dolibarr.
• Corrección: anomalía menor de validación del número de teléfono.

UPDATE 1.5.0 (2024-09-25)

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

UPDATE 1.4.0 (2024-08-20)

• Novedad: ajuste que determina en qué momento una factura se marca como pagada.
• Compatibilidad: compatible con la última versión de Dolibarr y con el multiempresa.

UPDATE 1.3.0 (2023-11-15)

• Corrección: comprobación del modo de pago frente al núcleo de Dolibarr.
• Mejora: código limpiado y optimizado.

UPDATE 1.2.0 (2023-10-06)

• Seguridad: añadida la clave pública y activada la verificación de firma.
• Seguridad: refuerzo general de la protección.
• Corrección: diversas anomalías 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: diversas anomalías.

UPDATE 1.0

• Versión inicial.