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. Con la versione 2.1.0 il pagamento a partire da un ordine cliente funziona pienamente: il link viene creato alla convalida dell'ordine, punta proprio a quell'ordine e parte con l'e-mail di invio dell'ordine, esattamente come per le fatture. È 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 o all'ordine, 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.
• Il cliente conosce l'intero piano delle rate prima di inserire la carta: nessuna sorpresa, nessuna contestazione.
• Una modalità test permette di validare l'intera catena prima di incassare il primo euro.
• Modulo e documentazione tradotti in sei lingue complete: inglese, francese, tedesco, spagnolo, italiano e portoghese.

⚙️ 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.
• Importo ricalcolato al momento dell'incasso: la somma addebitata è determinata dal modulo a partire dal documento, e non dalla pagina mostrata al cliente.

📦 Pagamento a partire da un ordine

• Link creato alla convalida dell'ordine: permette di saldare proprio quell'ordine, e non un altro documento.
• Invio con l'ordine: il link raggiunge il cliente quando l'ordine viene trasmesso per e-mail, come per le fatture.
• Creazione della fattura dall'ordine: effettuata automaticamente quando l'incasso riguarda un ordine.
• Acconto e rate sugli ordini: le stesse opzioni disponibili sulle fatture si applicano agli ordini cliente.

✉️ Automazione delle e-mail

• Invio automatico del link: il link di pagamento parte al momento dell'invio della fattura o dell'ordine, 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.

🧾 Acconto, rate 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.
• Piano delle rate annunciato prima dell'inserimento della carta: la pagina di pagamento indica l'importo pagato subito, nonché la data e l'importo di ogni addebito successivo.
• Carta verificata per tutta la durata del piano: una carta che scade prima dell'ultima rata viene rifiutata al momento dell'acquisto, quando il cliente può ancora presentarne un'altra.
• Registrazione automatica dell'incasso: al ritorno dalla banca, creazione del pagamento, scrittura sul conto bancario configurato e passaggio della fattura allo stato pagata.

🛡️ Sicurezza e architettura

• Link divenuto senza oggetto rifiutato automaticamente: una fattura saldata, abbandonata o ancora in bozza, così come un ordine già fatturato, annullato o ancora in bozza, non è più pagabile.
• Protezione contro il doppio incasso: finché un piano di rate è in corso presso la banca, la riapertura del link viene rifiutata; una volta concluso il piano, il saldo resta pagabile in una sola volta.
• Gestione affidabile delle notifiche della banca: una notifica duplicata non crea un secondo incasso, un importo superiore al saldo non viene mai registrato tale e quale, 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.
• Multi-entità: gli incassi effettuati su un'entità secondaria vengono collegati correttamente.
• Modalità test: permette di validare l'integrazione senza movimenti reali.
• Permessi dedicati: tre permessi distinti, consultazione, creazione o modifica, eliminazione.

🆕 Novità recenti (2.2.0 / 2.1.0 / 2.0.1)

• Il pagamento a partire da un ordine cliente funziona realmente: il link è creato alla convalida dell'ordine, apre proprio quell'ordine e viene inviato al cliente insieme all'ordine trasmesso per e-mail.
• La pagina di pagamento annuncia l'intero piano rateale — importo del giorno, data e importo di ogni prelievo futuro — prima che il cliente inserisca la carta, e rifiuta una carta che scade prima dell'ultima rata.
• Un link divenuto senza oggetto viene rifiutato: fattura saldata, abbandonata o in bozza, ordine già fatturato, annullato o in bozza; un piano rateale in corso presso la banca blocca ogni riapertura del link.
• L'importo incassato è ricalcolato sul lato server a partire dal documento, e un avviso della banca superiore al saldo non viene più registrato tale e quale.
• Il modulo e la sua documentazione sono ora disponibili in sei lingue complete: inglese, francese, tedesco, spagnolo, italiano e portoghese.
• Pagina di pagamento personalizzata con i colori della vostra azienda, oppure reindirizzamento alla pagina di pagamento online nativa di Dolibarr; 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.

✅ 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.
• Lingue disponibili: inglese, francese, tedesco, spagnolo, italiano, portoghese.
• 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, Tedesco, Spagnolo, Italiano, Portoghese
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.
• Il pagamento in due o tre rate è un'opzione del vostro contratto Up2pay e non un'impostazione del modulo: senza di essa la banca rifiuta il pagamento.
• L'estensione PHP openssl è facoltativa, ma consigliata: è utilizzata per la verifica della firma dei ritorni.
• L'interfaccia del modulo è disponibile in inglese, francese, tedesco, spagnolo, italiano e portoghese.
• 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.2.0 (2026-08-06)

• Correzione: il nome del titolare trasmesso alla banca per l'autenticazione 3-D Secure è di nuovo compilato. Uno dei due campi del nome partiva vuoto sulla quasi totalità delle schede aziendali, il che peggiora il punteggio di autenticazione e può far rifiutare il pagamento.
• Correzione: il numero di cellulare trasmesso per l'autenticazione 3-D Secure non è più errato. Il prefisso e il numero venivano uniti in un numero inesistente, un cellulare estero veniva dichiarato francese e una linea fissa poteva partire come cellulare. Un numero che il modulo non riesce a leggere non interrompe più la pagina di pagamento.
• Miglioramento: una scheda cliente il cui nome non può essere trasmesso al servizio di pagamento ora arresta la pagina di pagamento con un messaggio esplicito, invece di lasciare che la banca rifiuti l'autenticazione senza spiegazioni. Il motivo e la scheda interessata sono registrati nel giornale, il che permette di correggerla.
• Correzione: la seconda riga di indirizzo annunciata nella 2.1.0 non viene trasmessa per il momento, a seguito di un incidente di autenticazione in produzione.

UPDATE 2.1.0 (2026-08-02)

• ⚠️ Azione richiesta: disattivate e poi riattivate il modulo dopo l'aggiornamento, affinché il campo « Link di pagamento » venga aggiunto agli ordini.
• Novità: il link di pagamento del modulo funziona ora sugli ordini. Finora apriva una fattura senza rapporto con l'ordine, oppure segnalava un link scaduto.
• Novità: il link di pagamento di un ordine viene generato alla sua convalida e inviato al cliente quando l'ordine è trasmesso per email, come per le fatture.
• Sicurezza: l'importo incassato viene ora ricalcolato sul server. Proveniva da un campo del modulo di pagamento, che un cliente poteva modificare per pagare meno dell'importo dovuto.
• Sicurezza: un saldo parzialmente pagato non viene più suddiviso di nuovo in due o tre rate. Un cliente che riapriva il proprio link di pagamento poteva avviare un secondo piano rateale oltre a quello già detenuto dalla banca, e vedersi addebitare più dell'importo dovuto. Dopo il primo pagamento, il saldo viene incassato in un'unica soluzione.
• Correzione: la fattura creata da un ordine non eredita più il pagamento in due o tre rate di quest'ultimo, il cui piano appartiene all'ordine.
• Correzione: le date delle rate non sconfinano più nel mese successivo. Una scadenza calcolata da un 31 cadeva tre giorni troppo tardi; ora cade l'ultimo giorno del mese previsto.
• Correzione: nel pagamento in due o tre rate, una carta che scade prima dell'ultima rata viene ora rifiutata al momento dell'acquisto, quando il cliente può ancora presentarne un'altra. Prima veniva accettata e le rate successive fallivano diverse settimane dopo la vendita.
• Sicurezza: una fattura interamente pagata, abbandonata o ancora in bozza non è più pagabile dal link del modulo. Il link, creato alla convalida, non scadeva mai e continuava ad accettare pagamenti su una fattura che non doveva più nulla.
• Sicurezza: il link viene rifiutato quando un pagamento rateale è già in corso. Le rate restanti sono detenute dalla banca, che le preleva da sola: riaprire il link faceva pagare una seconda volta una somma già impegnata. Un pagamento registrato manualmente, invece, lascia il link utilizzabile per il saldo.
• Miglioramento: la pagina di pagamento annuncia l'intero piano rateale — importo del giorno e data di ogni prelievo futuro — prima che il cliente inserisca la carta. Mostrava solo la prima rata, sotto la dicitura « importo totale del pagamento ».
• Miglioramento: la pagina di configurazione ricorda che il pagamento in due o tre rate è un'opzione del vostro contratto Up2pay e non un'impostazione del modulo. Senza di essa la banca rifiuta il pagamento e il vostro cliente legge solo « pagamento rifiutato », senza alcun motivo.
• Correzione: un importo troppo piccolo per essere frazionato — meno di 2 € in due rate, meno di 3 € in tre — viene ora incassato in un'unica soluzione. Il pagamento era bloccato, con un messaggio che indicava erroneamente un importo inferiore a 1 €, mentre lo era solo la rata.
• Sicurezza: un avviso della banca con un importo superiore al saldo della fattura non viene più registrato tale e quale. Il saldo viene incassato e l'eccedenza segnalata nel registro: una fattura non può dovere più del suo saldo, e registrarlo falserebbe la riconciliazione bancaria.
• Miglioramento: conformità al kit di integrazione ufficiale Up2pay e-Transactions — il nome del titolare della carta è sempre indicato, la seconda riga dell'indirizzo viene trasmessa, e sia l'elenco dei dati di ritorno sia la verifica della firma sono allineati all'esempio fornito dalla banca.
• Miglioramento: un importo inferiore al minimo di un euro accettato dalla banca viene segnalato chiaramente al cliente, invece di sfociare in un errore della pagina di pagamento.
• Miglioramento: l'avviso di pagamento della banca viene confermato non appena il pagamento è registrato, prima della generazione del PDF e dell'invio dell'email. Gli avvisi « Warning e-Transactions » dovuti al tempo di attesa scompaiono.
• Correzione: un ordine già fatturato, annullato o ancora in bozza non è più pagabile dal link del modulo.

UPDATE 2.0.1 (2026-07-30)

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

UPDATE 2.0 (2026-06-18)

• ⚠️ Azione richiesta: disattivate e poi riattivate il modulo dopo l'aggiornamento per applicare le modifiche introdotte da questa versione.
• Novità: pagina di pagamento con i colori della vostra azienda in opzione, oppure reindirizzamento alla pagina di pagamento 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 più solo sulle fatture.
• Sicurezza: corretta una vulnerabilità sulla pagina di pagamento pubblica e rafforzata la verifica della firma, ora con chiave a 2048 bit.
• Miglioramento: un doppio avviso del gateway non crea più un secondo pagamento, e un errore durante la registrazione viene ripreso correttamente invece di lasciare un pagamento incompleto.
• Correzione: le opzioni di acconto e di pagamento rateale erano ignorate dalla 1.6 e non modificabili sulla scheda; entrambe sono ripristinate.
• Correzione: un importo comprendente una frazione di centesimo poteva essere addebitato fino a cento volte più del dovuto.
• Correzione: un acconto superiore al saldo dovuto non può più incassare più di quanto resta da pagare.
• Correzione: i pagamenti effettuati su un'entità secondaria andavano persi, ora vengono 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 cliente, con la fattura creata automaticamente.
• Miglioramento: il link di pagamento può essere generato alla convalida di un pagamento tramite l'API di Dolibarr.
• Correzione: anomalia minore nella convalida del numero di telefono.

UPDATE 1.5.0 (2024-09-25)

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

UPDATE 1.4.0 (2024-08-20)

• Novità: impostazione che determina in quale momento 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: controllo 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: rafforzamento generale della protezione.
• Correzione: diverse anomalie minori.

UPDATE 1.1.0 (2023-07-26)

• Novità: gli oggetti delle email possono essere definiti dalla configurazione del modulo.
• Novità: aggiunta delle traduzioni inglesi.
• Miglioramento: aggiornamento dello stile di visualizzazione.
• Correzione: diverse anomalie.

UPDATE 1.0

• Versione iniziale.