DataFirefly Subscriptions — Guida completa (PrestaShop 8 & 9)
Installazione, metodi di pagamento (carta, addebito diretto SEPA, PayPal, fatturazione offline), piani, pianificatore, solleciti, area cliente e back-office del modulo di abbonamenti per PrestaShop 8 e 9.
Presentazione
DataFirefly Subscriptions vende i tuoi prodotti in abbonamento su PrestaShop 8 e 9. Crei dei piani (frequenza, sconto, prova gratuita, quota di iscrizione, vincolo, numero di consegne); il cliente sceglie il proprio piano nella scheda prodotto, paga il primo ordine e poi ogni scadenza crea automaticamente un vero ordine PrestaShop, pagato automaticamente con il metodo di pagamento che ha salvato (carta, addebito diretto SEPA o PayPal) oppure inviato in attesa di pagamento (fatturazione offline).
- Prezzo di abbonamento visibile ovunque: sconto, prova gratuita e quota di iscrizione vengono applicati nel carrello, al pagamento, nell’ordine e in fattura.
- Un unico motore di fatturazione: il pianificatore del negozio; ogni abbonamento viene riservato prima del rinnovo, e due esecuzioni simultanee non addebitano mai due volte.
- Il cliente gestisce tutto dal proprio account: salto di una consegna, pausa, cambio di piano, quantità, indirizzo, metodo di pagamento, disdetta.
- Back-office completo: dashboard, elenco degli abbonati, scheda con cronologia, editor dei piani con anteprima.
Novità della 3.0.0: addebito diretto SEPA (tramite Stripe o con file bancario pain.008) e PayPal, fatturazione offline e modalità test, quota di iscrizione, prova davvero gratuita, sconto applicato fin dal 1° ordine, pausa con ripresa automatica, cambio di piano e di quantità da parte del cliente, cambio del metodo di pagamento, disdetta alla fine del vincolo, promemoria prima del rinnovo, gruppo clienti «abbonati», nuova dashboard, e-mail in 8 lingue, cron da riga di comando.
Abbonamento o ordine ricorrente? DataFirefly Subscriptions crea gli ordini alla scadenza e li fa pagare automaticamente (oppure li fattura). Se preferisci inviare al cliente un carrello pronto da pagare prima di ogni scadenza, senza addebito, valuta invece il modulo DF Recurring Orders.
Installazione e aggiornamento
- Scarica lo ZIP dal tuo account DataFirefly.
- Back-office: Moduli → Gestione moduli → Carica un modulo, seleziona lo ZIP.
- Compare il menu Ordini → Abbonamenti: Dashboard, Abbonati, Piani, Attività, Impostazioni, Addebiti diretti SEPA.
Requisiti: PrestaShop da 8.0 a 9.x, PHP da 7.4 a 8.5, un’attività pianificata (cron) presso il tuo hosting; a seconda dei metodi scelti: un account Stripe (carta, addebito diretto SEPA tramite Stripe), un conto PayPal Business idoneo al vault PayPal (pagamenti avviati dal commerciante), oppure un identificativo del creditore (ICS) SEPA e una banca che accetti i file di addebito pain.008. Nessuna dipendenza Composer.
Aggiornamento dalla 2.x: installa lo ZIP 3.0.0 sopra la versione esistente. La migrazione aggiunge le nuove colonne, corregge le date vuote salvate dalla 2.x, recupera negozio, valuta e lingua di ogni abbonamento, conserva le tue impostazioni (un negozio 2.x con Stripe mantiene la carta come metodo di pagamento) ed elimina i file non più necessari. Nessun abbonamento va perso.
Alla disinstallazione, gli abbonamenti vengono conservati per impostazione predefinita e ritrovati dopo la reinstallazione; l’opzione «Elimina tutti i dati degli abbonamenti alla disinstallazione del modulo» cancella tutto.
Scegliere i metodi di pagamento
Abbonamenti → Impostazioni → Pagamento offre due modalità:
- Metodo di pagamento salvato: rinnovi automatici — selezioni i metodi proposti al pagamento; il cliente ne sceglie uno, che viene salvato al 1° ordine e poi usato automaticamente a ogni rinnovo. Per un carrello che contiene un abbonamento vengono proposti solo questi metodi.
- Fatturazione offline — il 1° ordine si paga con uno qualsiasi dei tuoi metodi di pagamento (bonifico, assegno…). L’abbonamento parte quando l’ordine passa a uno stato pagato. Ogni rinnovo crea un ordine «in attesa di pagamento» (per impostazione predefinita «In attesa di pagamento con bonifico bancario», che invia le tue coordinate bancarie); il cliente riceve dei solleciti e l’abbonamento viene sospeso se l’ordine resta non pagato.
Metodi disponibili nella modalità «metodo di pagamento salvato» (ogni scheda indica «Pronto» o «Da configurare»):
- Carta (Stripe) — carta salvata con 3-D Secure, addebitata a ogni rinnovo.
- Addebito diretto SEPA (Stripe) — l’IBAN viene inserito nel modulo sicuro di Stripe, che gestisce il mandato. Un addebito viene confermato dalla banca dopo alcuni giorni: l’ordine resta «In attesa di addebito diretto SEPA» e passa a «Pagamento accettato» quando Stripe lo conferma; il pianificatore verifica l’esito, senza bisogno di webhook aggiuntivi.
- PayPal — il cliente approva una sola volta in PayPal; il suo conto viene salvato nel vault PayPal e i rinnovi vengono addebitati senza nuova approvazione. Crea un’app REST nell’area sviluppatori di PayPal (credenziali sandbox, poi di produzione); il tuo conto PayPal Business deve essere abilitato ai pagamenti salvati («Vault»).
- Addebito diretto SEPA (file bancario) — il cliente firma un mandato SEPA sul tuo negozio (titolare, IBAN verificato, BIC facoltativo, casella di firma). Sei tu a trasmettere gli addebiti alla tua banca: vedi «Addebiti diretti SEPA» più avanti. Indica il nome del creditore, il tuo identificativo del creditore (ICS) SEPA, l’IBAN e il BIC del conto di accredito.
- Modalità test — carte simulate (numeri di test Stripe), nessun pagamento reale: per provare l’intero ciclo prima della messa in produzione.
Gli addebiti diretti SEPA vengono proposti solo per i carrelli in euro.

Chiavi e webhook Stripe
Inserisci le chiavi pubblicabili e segrete della modalità scelta (test o live); le chiavi segrete salvate non vengono mai più mostrate (lasciare il campo vuoto conserva la chiave). Crea poi in Stripe un webhook verso l’URL indicato, con gli eventi payment_method.detached, charge.refunded e charge.dispute.created, quindi incolla il segreto di firma whsec_…. Gli eventi non firmati vengono rifiutati e ogni evento viene elaborato una sola volta.
Creare un piano
Abbonamenti → Piani → Nuovo piano (oppure dalla scheda Moduli della pagina prodotto):
- Prodotto (ricerca per nome, riferimento o ID) e, se necessario, una sola combinazione.
- Rinnovo: settimanale, ogni due settimane, mensile, trimestrale, ogni sei mesi o annuale, con un moltiplicatore («Mensile» ogni 2 = ogni 2 mesi).
- Sconto abbonamento (%): applicato a ogni consegna, dopo le tue promozioni del catalogo.
- Quota di iscrizione (IVA escl.): addebitata una sola volta con il 1° ordine.
- Prova gratuita (giorni): la 1ª consegna è gratuita, il 1° addebito avviene alla fine della prova.
- Vincolo: numero di consegne pagate prima di poter disdire.
- Numero totale di consegne: 0 = fino alla disdetta; altrimenti l’abbonamento termina da solo (ad es. 12 numeri).
- Visualizzazione: nome e breve presentazione per lingua, «Il più scelto», ordine, attivazione.
L’anteprima a destra mostra la scheda del piano così come apparirà. Un piano usato da abbonamenti non può essere eliminato: disattivalo (gli abbonamenti in corso continuano).


Percorso del cliente
Scheda prodotto
Il blocco «Opzioni di acquisto» mette a confronto l’acquisto singolo e ciascun piano: prezzo barrato, prezzo per consegna, risparmio per consegna e all’anno, badge (prova, vincolo, quota), indicazione relativa al 1° ordine. La scelta viene memorizzata anche prima della prima aggiunta al carrello.


Carrello e pagamento
Il carrello mostra il prezzo di abbonamento e un riepilogo: piano, prova, quota, importo ricorrente e data del prossimo rinnovo. Al pagamento, il cliente vede quanto paga oggi e l’autorizzazione all’addebito per i rinnovi. Un abbonamento richiede un account cliente: a un ospite viene chiesto di accedere o di creare un account.



Addebiti diretti SEPA (file bancario)
Gli ordini pagati con mandato SEPA restano in attesa in Abbonamenti → Addebiti diretti SEPA:
- seleziona gli incassi, scegli la data di incasso (rispettando i tempi richiesti dalla tua banca) e fai clic su Crea il file di addebito;
- scarica il file XML pain.008 e caricalo nel tuo home banking (i primi addebiti FRST e gli addebiti ricorrenti RCUR vengono raggruppati automaticamente);
- quando la banca ha pagato, fai clic su Segna come pagato: gli ordini passano a «Pagamento accettato», l’abbonamento parte oppure il rinnovo viene conteggiato;
- un addebito rifiutato si segna come «respinto»: l’ordine passa a «Errore di pagamento» e l’abbonamento segue le tue regole di sollecito.
Gli IBAN vengono salvati in forma cifrata; vengono mostrati solo il paese e le ultime 4 cifre. Il file viene rigenerato a ogni download.

Rinnovi e pianificatore
Il pianificatore elabora i rinnovi in scadenza, ritenta i pagamenti non riusciti, riprende gli abbonamenti la cui pausa è terminata, segue gli ordini offline non pagati e gli addebiti diretti SEPA in corso, e invia i promemoria. Eseguilo una volta al giorno (o ogni ora). Da riga di comando (consigliato; il token può anche essere passato tramite la variabile DFSUBSCRIPTION_CRON_TOKEN):
0 6 * * * php /percorso/del/negozio/modules/dfsubscription/cli/run.php --token=IL_TUO_TOKEN
oppure tramite URL: https://iltuonegozio.it/module/dfsubscription/cron?token=IL_TUO_TOKEN. Codici di uscita della riga di comando: 0 = OK, 2 = token non valido, 3 = modulo disattivato, 5 = pagamenti non riusciti o errori. Il pannello «Pianificatore» delle impostazioni mostra l’ultima esecuzione e consente di avviare un’esecuzione o di rigenerare il token.
A ogni rinnovo: carrello ricostruito nel negozio, nella valuta, nella lingua e all’indirizzo dell’abbonamento, corriere originale se disponibile, prezzo di abbonamento (prezzo attuale meno lo sconto, oppure prezzo bloccato in base alle tue impostazioni), addebito, poi ordine PrestaShop standard ed e-mail al cliente. Se il prodotto è esaurito o non disponibile, il rinnovo viene posticipato di un giorno senza addebito né tentativo fallito conteggiato, e ricevi un avviso.
Pagamenti non riusciti e solleciti
- L’addebito non va a buon fine: l’abbonamento passa a «Pagamento non riuscito» e il cliente riceve un’e-mail con un link per aggiornare il proprio metodo di pagamento. Per un addebito diretto SEPA, l’ordine respinto passa a «Errore di pagamento» e segue le stesse regole.
- Nuovo tentativo automatico dopo l’intervallo impostato (per impostazione predefinita 3 tentativi a 3 giorni di distanza).
- Dopo l’ultimo tentativo: sospensione (impostazione predefinita) o disdetta, a seconda delle tue impostazioni; ricevi un avviso.
- Non appena il cliente salva un nuovo metodo di pagamento, l’abbonamento torna attivo e viene addebitato all’esecuzione successiva.

Area cliente «I miei abbonamenti»
Il cliente vede i propri abbonamenti in corso e passati e, per ciascuno: stato, prossima data, metodo di pagamento, vincolo residuo, consegne, ordini e cronologia. In base alle tue impostazioni, può:
- Saltare la prossima consegna.
- Mettere in pausa per 1-N consegne (ripresa automatica) o fino alla ripresa, quindi riprendere alla data prevista.
- Cambiare piano tra quelli del prodotto (con effetto dal prossimo rinnovo, senza calcolo pro rata) e cambiare la quantità.
- Cambiare l’indirizzo di consegna e sostituire il metodo di pagamento: nuova carta, nuovo IBAN, nuovo mandato SEPA o un altro conto PayPal (applicato a tutti i suoi abbonamenti pagati nello stesso modo).
- Disdire indicando un motivo; durante un vincolo, può solo programmare la disdetta alla fine del vincolo (e annullarla).
Ogni azione viene inviata in POST con un token di sessione e verifica che l’abbonamento appartenga effettivamente al cliente.


Back-office
Dashboard
Ricavi ricorrenti mensili stimati (IVA escl.), abbonati attivi, prove in corso, tasso di abbandono a 30 giorni, pagamenti non riusciti da seguire, rinnovi a 7 e 30 giorni, fatturato degli ordini di abbonamento, ricavi per abbonato, grafico su 12 mesi, nuovi abbonamenti e disdette, ripartizione per stato, piani principali, prossimi rinnovi, attività recente e motivi di disdetta. Una guida introduttiva viene mostrata finché la configurazione non è completata.

Abbonati e scheda abbonato
L’elenco si filtra per stato (attivi, in prova, in pausa, pagamento non riuscito, in attesa di pagamento, terminati), si esporta in CSV e accetta azioni di gruppo (pausa, ripresa, disdetta). La scheda di un abbonamento riunisce indicatori, azioni (addebitare o fatturare ora, saltare, pausa, ripresa, data del prossimo rinnovo, piano, quantità, disdetta, riattivazione), ordini e cronologia completa.


Altre schermate
- Attività: tutti gli eventi, filtrabili per tipo e per autore (cliente, dipendente, pianificatore).
- Scheda ordine e scheda cliente: pannello degli abbonamenti collegati.
- Gruppo clienti «abbonati» (Impostazioni): i clienti ne fanno parte finché hanno un abbonamento attivo o in pausa; usalo per prezzi riservati o per l’accesso a determinate categorie.
Tutte le e-mail vengono inviate nella lingua del cliente (8 lingue incluse) con gli importi nella sua valuta: abbonamento confermato, rinnovo pagato, addebito diretto SEPA richiesto, ordine in attesa di pagamento e solleciti, pagamento non riuscito, promemoria prima del rinnovo e della fine della prova, pausa, ripresa, modifica, disdetta, fine imminente. Il commerciante riceve i nuovi abbonamenti, le disdette, le sospensioni e i rinnovi posticipati. I testi si modificano in Internazionale → Traduzioni → Traduzioni dei moduli.


Domande frequenti e risoluzione dei problemi
Il blocco di abbonamento non compare nella scheda prodotto
Verifica che esista un piano attivo per questo prodotto (o questa combinazione) e che almeno un metodo di pagamento sia «Pronto» nelle impostazioni (chiavi Stripe o PayPal inserite, dati del creditore SEPA completi; carrello in euro per il SEPA).
PayPal rifiuta i rinnovi
Verifica con PayPal che il tuo conto sia abilitato ai pagamenti salvati (Vault, pagamenti avviati dal commerciante). L’errore restituito da PayPal compare nella cronologia dell’abbonamento.
I rinnovi non vengono eseguiti
Il pannello «Pianificatore» indica l’ultima esecuzione. Esegui il comando manualmente per vedere il resoconto e gli eventuali errori.
Come fare test senza rischi?
Passa alla Modalità test, crea un piano, ordina con la carta 4242 4242 4242 4242, poi usa «Addebita ora» nella scheda dell’abbonamento. La carta 4000 0000 0000 0341 viene accettata all’ordine e poi rifiutata al rinnovo: ideale per testare i solleciti.
Serve aiuto? Apri un ticket dal tuo account DataFirefly: risposta entro 24 ore lavorative, in francese o in inglese.