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.

📄 Licenza e condizioni di utilizzo

Il modulo è distribuito con licenza GNU General Public License v3 o successiva (GPL v3+); il testo completo si trova nel file COPYING fornito con il modulo.

Le Condizioni di Utilizzo complete sono fornite con il modulo e consultabili dalla sua scheda « Informazioni » in Dolibarr. Le nostre Condizioni Generali di Vendita sono disponibili all'indirizzo https://www.mb-informatique.fr/cgv.html.

👨 💻 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.