MBI Up2pay ETransactions

🎯 Panoramica del modulo

MBI Up2pay ETransactions incassa le vostre fatture e i vostri ordini con carta bancaria, online, tramite la soluzione di pagamento Up2Pay E-Transactions del Crédit Agricole. Il modulo aggiunge a Dolibarr una modalità di pagamento « Carta Internet », genera un link di pagamento per ogni documento e lo invia al vostro cliente via e-mail. Non appena la banca conferma la transazione, l'incasso viene registrato automaticamente e la fattura passa allo stato pagata. È conforme alla normativa PSD2 e supporta 3-D Secure v2.

Funziona esclusivamente con un contratto Up2Pay E-Transactions presso il Crédit Agricole: le credenziali del negozio (numero di sito, rango, identificativo e chiave segreta) sono fornite dalla banca. Le pagine di ritorno del modulo devono inoltre essere raggiungibili da Internet, poiché la banca le contatta direttamente per notificare l'esito delle transazioni.

🌐 Demo: https://demo.mbicloud.fr 🛒 Scoprite i nostri altri moduli su Dolistore.

💡 Vantaggi

• I vostri clienti pagano online, immediatamente, senza che dobbiate reinserire alcun dato.
• L'incasso, la scrittura bancaria e il passaggio della fattura allo stato pagata sono automatici.
• Il link di pagamento parte insieme alla fattura, in un'e-mail che redigete una volta per tutte.
• Potete richiedere un acconto, oppure proporre un pagamento in due o tre rate, senza uscire da Dolibarr.
• Una modalità test permette di validare l'intera catena prima di incassare il primo euro.

⚙️ Funzionalità chiave

💳 Incasso con carta bancaria

• Modalità di pagamento « Carta Internet »: aggiunta a Dolibarr e utilizzabile sulle fatture e sugli ordini cliente.
• Link di pagamento sicuro: generato per ogni documento, con un'impronta monouso.
• Pagina di pagamento a scelta: una pagina con i colori della vostra azienda, oppure la pagina di pagamento online nativa di Dolibarr.

✉️ Automazione delle e-mail

• Invio automatico del link: il link di pagamento parte al momento dell'invio della fattura, con oggetto e modello di messaggio personalizzabili ed eventuale copia agli indirizzi di vostra scelta.
• Immagine di fiducia: visualizzata nell'e-mail, riporta il numero di telefono del cliente.
• E-mail di fattura quietanzata: inviata dopo l'incasso, con il PDF in allegato, oggetto e modello personalizzabili.

🧾 Incassi e scritture

• Acconto: un campo aggiuntivo permette di incassare solo una parte dell'importo, con un limite pari al saldo ancora dovuto.
• Pagamento in due o tre rate: l'importo è diviso in parti uguali e ogni rata viene addebitata un mese dopo la precedente.
• Registrazione automatica dell'incasso: al ritorno dalla banca, creazione del pagamento, scrittura sul conto bancario configurato e passaggio della fattura allo stato pagata.
• Creazione della fattura dall'ordine: effettuata automaticamente quando l'incasso riguarda un ordine.

🛡️ Sicurezza e architettura

• Multi-entità: gli incassi effettuati su un'entità secondaria vengono collegati correttamente.
• Gestione affidabile delle notifiche della banca: una notifica duplicata non crea un secondo incasso e un incidente durante la registrazione viene ripreso correttamente, invece di lasciare una scrittura incompleta.
• Verifica della firma: i ritorni della banca sono controllati tramite chiave a 2048 bit.
• Modalità test: permette di validare l'integrazione senza movimenti reali.
• Permessi dedicati: tre permessi distinti, consultazione, creazione o modifica, eliminazione.

🆕 Novità recenti (2.0.1 / 2.0 / 1.6.0)

• Pagina di pagamento personalizzata con i colori della vostra azienda, oppure reindirizzamento alla pagina di pagamento online nativa di Dolibarr.
• Acconto e pagamento in due o tre rate ora disponibili anche sugli ordini, e non più soltanto sulle fatture.
• Sicurezza rafforzata: correzione di una vulnerabilità sulla pagina di pagamento pubblica, verifica della firma con chiave a 2048 bit e nessun foglio di stile caricato da un terzo durante il pagamento.
• Incassi più affidabili: nessun doppio incasso in caso di notifica duplicata, importi con centesimi frazionati corretti, acconto limitato al saldo dovuto e pagamenti su entità secondaria non più persi.
• Avvio del pagamento da un ordine di vendita, con creazione automatica della fattura.

✅ Compatibilità

• Dolibarr: 12.0+ (testato fino a Dolibarr 23)
• PHP: 7.2+
• Contratto Up2Pay E-Transactions (Crédit Agricole): obbligatorio, con le credenziali del negozio fornite dalla banca (numero di sito, rango, identificativo e chiave segreta), un conto bancario configurato in Dolibarr e pagine di ritorno del modulo raggiungibili da Internet.
• Estensione PHP openssl: facoltativa, utilizzata per la verifica della firma dei ritorni.
• Altri moduli: nessun altro modulo Dolibarr è richiesto e non è dichiarata alcuna incompatibilità nota. Il modulo si integra nell'interfaccia standard di Dolibarr, senza sovrascrittura del core.

Module version: auto
Editore/Licenza: MB Informatique / GPL-v3
Lingua dell'interfaccia: Inglese, Francese
Assistenza: MB Informatique
Prerequisiti:

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

🔧 Installazione

1. Scaricare l'archivio ZIP del modulo senza decomprimerlo.
2. In Dolibarr, andare in Home > Configurazione > Moduli/Applicazioni.
3. Aprire la scheda Distribuisci/installa modulo esterno.
4. Caricare l'archivio ZIP del modulo.
5. Cercare e attivare MBI Up2pay ETransactions.
6. Configurare le opzioni del modulo dalla sua pagina di amministrazione: credenziali del negozio fornite dal Crédit Agricole, conto bancario di destinazione degli incassi, oggetti e modelli delle e-mail.
7. Assegnare i permessi necessari agli utenti interessati.
8. (In alternativa) Per un'installazione manuale, copiare la cartella mbietransactions in /htdocs/custom/.

ℹ️ Note di utilizzo

• Il modulo richiede obbligatoriamente un contratto Up2Pay E-Transactions presso il Crédit Agricole e un conto bancario configurato in Dolibarr, sul quale saranno registrati gli incassi.
• Le pagine di ritorno del modulo devono essere raggiungibili da Internet: la banca le contatta direttamente per notificare l'esito delle transazioni.
• Prima della messa in produzione, attivare la modalità test e pagare una fattura dall'inizio alla fine per verificare che il ritorno della banca venga elaborato correttamente, quindi disattivare la modalità test.
• L'estensione PHP openssl è facoltativa, ma consigliata: è utilizzata per la verifica della firma dei ritorni.
• L'interfaccia del modulo è disponibile in inglese e in francese.
• Effettuare un backup del database e dei file Dolibarr prima di ogni aggiornamento, quindi installare il nuovo archivio sopra la versione esistente. Alcune versioni richiedono di disattivare e riattivare il modulo affinché le modifiche abbiano effetto; il ChangeLog lo indica esplicitamente all'inizio della versione interessata.
• La disattivazione del modulo libera l'attivazione della licenza e rimuove le costanti, i permessi e le dichiarazioni del modulo. I dati creati restano conservati: la tabella delle impronte di pagamento e i campi aggiuntivi aggiunti alle fatture e agli ordini non vengono eliminati, al fine di preservare lo storico delle transazioni.

🎓 Servizi

• Formazione sul modulo disponibile a 80 € IVA esclusa.
• Assistenza e aggiornamenti inclusi per tutta la durata della licenza.

📄 Condizioni Generali di Utilizzo

Articolo 1 — Editore. Il modulo MBI Up2pay ETransactions è edito da MB Informatique, società a responsabilità limitata, iscritta al RCS de Mulhouse (registro delle imprese di Mulhouse) con il numero 834 342 362 (SIRET 834 342 362 00029, TVA intracommunautaire FR07834342362), la cui sede legale si trova in 120 rue de l'Île Napoléon, 68170 Rixheim, France. Telefono: 03 67 262 242 — Email: info@mb-informatique.fr — Sito: https://www.mb-informatique.fr.

Articolo 2 — Oggetto e accettazione. Le presenti Condizioni Generali di Utilizzo (CGU) disciplinano l'utilizzo del modulo MBI Up2pay ETransactions (« il Modulo ») per Dolibarr ERP/CRM nonché i servizi associati forniti da MB Informatique SARL (assistenza, aggiornamenti, attivazione). L'installazione, l'attivazione o l'utilizzo del Modulo comporta l'accettazione piena e integrale delle presenti CGU. Esse si applicano in aggiunta alle condizioni di vendita della piattaforma tramite la quale il Modulo è stato acquistato (es. DoliStore), che disciplinano l'atto di acquisto.

Articolo 3 — Licenza del codice. Il codice sorgente del Modulo è distribuito con licenza GNU General Public License versione 3 o successiva (GPL v3+), il cui testo completo figura nel file COPYING fornito con il Modulo. Le presenti CGU non limitano i diritti conferiti all'Utente da tale licenza; esse disciplinano i servizi forniti da MB Informatique SARL e le condizioni di utilizzo del Modulo.

Articolo 4 — Requisiti e compatibilità. Il Modulo è progettato per gli ambienti indicati nella sua documentazione (Dolibarr 12.0 minimo, testato fino a Dolibarr 23, PHP 7.2 minimo). Il suo funzionamento non è garantito al di fuori di tali versioni, in caso di modifica del core di Dolibarr, né in presenza di moduli di terze parti in conflitto. Spetta all'Utente verificare la compatibilità del proprio ambiente prima dell'installazione.

Articolo 5 — Obblighi dell'Utente. L'Utente si impegna a: (a) effettuare un backup completo (file e database) prima di ogni installazione o aggiornamento; (b) testare il Modulo su un ambiente di prova prima della messa in produzione, quando ciò è possibile; (c) utilizzare il Modulo conformemente alla sua documentazione e alla normativa vigente; (d) mantenere la propria istanza Dolibarr in normali condizioni di sicurezza e di aggiornamento.

Articolo 6 — Assistenza e aggiornamenti. L'assistenza è fornita via email all'indirizzo info@mb-informatique.fr, alle condizioni e per la durata eventualmente precisate al momento dell'acquisto. Sono esclusi dall'assistenza: i malfunzionamenti dovuti a una modifica del Modulo o del core di Dolibarr da parte dell'Utente o di terzi, a un ambiente non conforme ai requisiti, o a un conflitto con un modulo di terze parti. Alcuni aggiornamenti possono richiedere una versione di Dolibarr più recente.

Articolo 7 — Garanzie. Il Modulo è fornito « così com'è », conformemente agli articoli 15 e 16 della licenza GPL e nei limiti consentiti dalla legge. MB Informatique SARL non garantisce che il Modulo sia esente da anomalie, funzioni senza interruzioni o risponda a un'esigenza particolare dell'Utente. Le garanzie legali imperative applicabili non sono pregiudicate dal presente articolo.

Articolo 8 — Responsabilità. Nei limiti consentiti dalla legge, MB Informatique SARL non può essere ritenuta responsabile dei danni indiretti (in particolare perdita di dati, perdita di esercizio, perdita di fatturato, danno all'immagine), né dei danni derivanti da: un utilizzo non conforme del Modulo; l'assenza di un backup preventivo; una modifica del Modulo da parte dell'Utente o di terzi; un caso di forza maggiore. Per gli Utenti professionali, la responsabilità complessiva di MB Informatique SARL, per qualsiasi causa, è limitata all'importo effettivamente pagato per il Modulo nel corso degli ultimi dodici (12) mesi. Nulla nelle presenti esclude la responsabilità che non può essere legalmente esclusa, in particolare in caso di dolo o colpa grave.

Articolo 9 — Dati personali. Il Modulo funziona all'interno dell'istanza Dolibarr dell'Utente: i dati funzionali che tratta restano archiviati sui sistemi dell'Utente, che ne rimane titolare del trattamento ai sensi del GDPR. In occasione della verifica della versione o dell'attivazione del Modulo, informazioni tecniche comprendenti il nome e la versione del Modulo, la chiave di licenza, l'indirizzo IP e il dominio dell'istanza possono essere trasmesse al server di MB Informatique SARL, ai soli fini della gestione delle licenze, dell'attivazione e degli aggiornamenti, e conservate per la durata necessaria a tali finalità. Nessun dato aziendale contenuto nell'istanza Dolibarr viene trasmesso in questo ambito. L'Utente può esercitare i propri diritti di accesso, rettifica, cancellazione, limitazione e opposizione scrivendo a info@mb-informatique.fr.

Articolo 10 — Proprietà intellettuale e marchi. « Dolibarr » è un marchio appartenente ai rispettivi titolari. Il Modulo è uno sviluppo indipendente di MB Informatique SARL, non affiliato all'associazione Dolibarr né approvato da essa. Le menzioni di copyright presenti nei file del Modulo non devono essere rimosse, conformemente alla licenza GPL.

Articolo 11 — Durata ed evoluzione. Le presenti CGU si applicano a decorrere dal primo utilizzo del Modulo e per tutta la durata del suo utilizzo. MB Informatique SARL può far evolvere le CGU per le versioni future del Modulo; la versione applicabile è quella fornita con la versione del Modulo utilizzata. La cessazione dei servizi non pregiudica i diritti conferiti dalla licenza GPL.

Articolo 12 — Legge applicabile e controversie. Le presenti CGU sono soggette al diritto francese. In caso di difficoltà, l'Utente è invitato a inviare preventivamente un reclamo scritto a MB Informatique SARL al fine di ricercare una soluzione amichevole. In mancanza di risoluzione amichevole, ogni controversia con un Utente professionale rientra nella competenza esclusiva del Tribunal de commerce de Mulhouse (tribunale di commercio di Mulhouse), anche in caso di procedimento d'urgenza, chiamata in garanzia, domanda incidentale o pluralità di convenuti. Gli Utenti consumatori conservano il beneficio delle norme imperative di competenza e possono ricorrere gratuitamente al dispositivo di mediazione del consumo alle condizioni previste dagli articoli L.612-1 e seguenti del Code de la consommation (codice del consumo francese). Le informazioni aggiornate relative alla mediazione del consumo applicabile ai servizi di MB Informatique SARL figurano nelle sue Condizioni Generali di Vendita, accessibili all'indirizzo https://www.mb-informatique.fr/cgv.html.

Articolo 13 — Varie. Se una clausola delle presenti è dichiarata nulla o inapplicabile, le altre conservano la loro piena validità. Le CGU sono redatte in francese; in caso di divergenza tra la versione francese e una traduzione, prevale la versione francese.

👨 💻 Editore

MBI Up2pay ETransactions è un modulo custom Dolibarr sviluppato da MB Informatique.

Si rivolge alle aziende titolari di un contratto Up2Pay E-Transactions del Crédit Agricole che desiderano incassare le proprie fatture e i propri ordini con carta bancaria direttamente da Dolibarr, senza reinserimento di dati e senza strumenti intermedi.

Editore: MB Informatique
Contatto: info@mb-informatique.fr
Sito web: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 2.0.1 (2026-07-30)

• Sicurezza: le pagine di esito del pagamento non caricano più un foglio di stile da Google, quindi il browser del vostro cliente non viene contattato da un terzo durante il pagamento.
• Correzione: il foglio di stile del pagamento online configurato in Dolibarr viene ora applicato alle pagine di esito del pagamento; veniva costruito e poi scartato.
• Miglioramento: la documentazione del modulo viene mostrata nella lingua dell'utente nella scheda Informazioni, in inglese, francese, tedesco, italiano e spagnolo.

UPDATE 2.0 (2026-06-18)

• ⚠️ Azione richiesta: disattivare e riattivare il modulo dopo l'aggiornamento, per applicare le modifiche introdotte da questa versione.
• Novità: pagina di pagamento personalizzata facoltativa, oppure reindirizzamento alla pagina di pagamento online nativa di Dolibarr (comportamento predefinito invariato).
• Novità: l'acconto e il pagamento in due o tre rate sono ora disponibili anche sugli ordini, e non soltanto sulle fatture.
• Sicurezza: corretta una vulnerabilità sulla pagina di pagamento pubblica e rafforzata la verifica della firma, che utilizza ora una chiave a 2048 bit.
• Miglioramento: una notifica duplicata della banca non crea più un secondo incasso e un errore durante la registrazione viene ripreso correttamente, invece di lasciare un incasso parziale.
• Correzione: le opzioni di acconto e di pagamento in più rate erano ignorate dalla versione 1.6 e non erano modificabili sul documento; entrambe sono ripristinate.
• Correzione: un importo con un centesimo frazionato poteva essere addebitato fino a cento volte più alto.
• Correzione: un acconto superiore al saldo dovuto non può più incassare più di quanto dovuto.
• Correzione: i pagamenti effettuati su un'entità secondaria andavano persi e vengono ora registrati.
• Compatibilità: supporto di PHP 8.5, versione minima di Dolibarr portata a 12.0.

UPDATE 1.6.0 (2025-08-08)

• Novità: il pagamento può essere avviato da un ordine di vendita, con creazione automatica della fattura.
• Miglioramento: il link di pagamento può essere generato quando un pagamento viene validato tramite l'API di Dolibarr.
• Correzione: piccolo problema di convalida del numero di telefono.

UPDATE 1.5.0 (2024-09-25)

• Novità: aggiunte le impostazioni del numero di telefono nella configurazione del modulo.

UPDATE 1.4.0 (2024-08-20)

• Novità: impostazione per controllare il momento in cui una fattura viene contrassegnata come pagata.
• Compatibilità: supporto dell'ultima versione di Dolibarr e del multi-azienda.

UPDATE 1.3.0 (2023-11-15)

• Correzione: verifica della modalità di pagamento rispetto al core di Dolibarr.
• Miglioramento: codice ripulito e ottimizzato.

UPDATE 1.2.0 (2023-10-06)

• Sicurezza: aggiunta della chiave pubblica e attivazione della verifica della firma.
• Sicurezza: protezione complessiva rafforzata.
• Correzione: vari problemi minori.

UPDATE 1.1.0 (2023-07-26)

• Novità: gli oggetti delle e-mail possono essere impostati dalla configurazione del modulo.
• Novità: aggiunte le traduzioni inglesi.
• Miglioramento: aggiornato lo stile di visualizzazione.
• Correzione: vari problemi.

UPDATE 1.0

• Versione iniziale.