Portafoglio Cliente e Credito Negozio per PrestaShop 8 e 9

Presentazione

DataFirefly Portafoglio cliente aggiunge a PrestaShop 8 e 9 un saldo per cliente. Vi accrediti rimborsi, note di credito e gesti commerciali; il cliente lo spende nella fase di pagamento degli ordini successivi e può ricaricarlo. Il saldo è trattato come un metodo di pagamento: un ordine pagato in parte con il portafoglio conserva il totale, la fattura e la base IVA, e la parte del portafoglio compare come riga di pagamento.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e trascina dfwallet-1.1.1.zip.
2. All’installazione il modulo crea le sue tabelle, una scheda Clienti > Portafogli, un prodotto virtuale nascosto DFWALLET-TOPUP usato per le ricariche, e si posiziona per primo tra i metodi di pagamento.
3. In Pagamento > Preferenze, verifica che il modulo sia abilitato per valute, paesi e gruppi di clienti.

Per aggiornare, carica il nuovo ZIP: saldi, cronologia e impostazioni vengono conservati, e gli script di aggiornamento aggiungono le nuove colonne.

Configurazione

Pagamento

• Consenti l’uso parziale al pagamento: se il saldo non copre l’intero ordine, il cliente può applicarlo e pagare il resto con un altro metodo.
• Stato dell’ordine quando il portafoglio paga l’intero ordine: Pagamento accettato per impostazione predefinita.

Ricarica da parte del cliente

• Importi suggeriti: separati da virgole, nella valuta predefinita. Esempio: 20,50,100.
• Importo libero, con ricarica minima e massima.
• Bonus di ricarica: scaglioni nel formato importo:bonus. Con 50:5,100:15, una ricarica di 100 € accredita 115 €. Il bonus viene accreditato al pagamento della ricarica e ripreso se l’ordine viene annullato o rimborsato.

La ricarica è venduta senza IVA, trattandosi di un pagamento anticipato. Il saldo viene accreditato solo quando l’ordine di ricarica passa a uno stato pagato.

Rimborsi e annullamenti

• Restituisci la parte del portafoglio quando un ordine viene annullato e quando passa a Rimborsato.
• Accredita automaticamente ogni nuova nota di credito sul portafoglio: disattivato per impostazione predefinita. Lascialo disattivato se rimborsi anche con bonifico o buono nativo; le note di credito si accreditano allora una per una dalla pagina dell’ordine.

Gli accrediti legati a un ordine (restituzioni e rimborsi) hanno come tetto il suo importo: attivare la restituzione automatica e accreditare la nota di credito dello stesso ordine non accredita mai due volte.

Scadenza dei gesti commerciali

• Validità in mesi, 0 per nessuna scadenza. Si applica a gesti commerciali, rettifiche a credito e bonus di ricarica. Rimborsi, pagamenti restituiti e ricariche non scadono mai.
• Email di promemoria prima della scadenza: giorni prima della data, 0 per nessun promemoria.

Un pagamento usa sempre per primi gli importi che scadono prima.

Attività cron

L’URL mostrato in cima alla pagina di configurazione, protetto da token, fa scadere gli accrediti scaduti e invia i promemoria. Richiamalo una volta al giorno:

0 6 * * * curl -s "https://il-tuo-negozio.it/module/dfwallet/cron?token=IL_TUO_TOKEN" > /dev/null

Senza cron, la stessa elaborazione viene eseguita al massimo una volta all’ora all’apertura dell’elenco dei portafogli, e gli accrediti scaduti di un cliente vengono elaborati appena il suo portafoglio viene visualizzato.

Accreditare un portafoglio

Dalla pagina dell’ordine

Il pannello Portafoglio cliente mostra il saldo, i movimenti legati all’ordine, un pulsante Accredita sul portafoglio per ogni nota di credito e un modulo di accredito (gesto commerciale, rimborso, rettifica). Se l’ordine è stato pagato in parte con il portafoglio, un pulsante permette di restituire quel pagamento.

Dalla scheda cliente e dall’elenco

La scheda cliente mostra il saldo e un modulo di accredito o addebito. Clienti > Portafogli elenca tutti i portafogli, con accredito rapido per email e una scheda dettagliata per cliente.

Per ogni movimento puoi indicare un messaggio mostrato al cliente, una nota interna, una data di validità per i gesti commerciali, e scegliere di avvisare il cliente via email.

Accrediti massivi via CSV

Il blocco Gesti commerciali in blocco accetta un file CSV, un cliente per riga:

email;amount;message;valid_until
jane@example.com;10;Ci scusiamo per il ritardo nella consegna;2027-06-30

Messaggio e data sono facoltativi; le date possono essere AAAA-MM-GG o GG/MM/AAAA, gli importi con virgola o punto. Messaggio e validità predefiniti si applicano alle righe che non li hanno. Ogni riga ha la sua chiave anti-duplicato: inviare due volte lo stesso file non accredita nessuno due volte. Un rapporto indica le righe accreditate, già importate e in errore.

Lato cliente

• Il mio account > Il mio portafoglio: saldo, importi in scadenza, ricarica e cronologia paginata con link agli ordini.
• Pagina carrello: promemoria del saldo disponibile.
• Fase di pagamento: se il saldo copre l’ordine, Paga con il mio portafoglio viene proposto per primo. Altrimenti il pulsante Usa il mio saldo mostra l’importo scalato e il resto da pagare, poi il cliente sceglie un altro metodo.
• Conferma d’ordine: promemoria della parte pagata con il portafoglio e dell’importo ancora dovuto.

Il saldo applicato al carrello compare nel riepilogo come riga Portafoglio. Se il cliente la rimuove con l’icona del cestino, il saldo non viene più usato per quel carrello.

Contabilità

Alla convalida, il saldo usato viene registrato come pagamento dell’ordine. Totale prodotti, IVA e fattura non cambiano. Per pagamenti con bonifico o assegno, le istruzioni inviate al cliente indicano l’importo effettivamente dovuto.

L’elenco dei portafogli mostra il residuo totale per valuta: finché non viene speso è un debito verso i tuoi clienti. Il blocco Esporta i movimenti genera un CSV (UTF-8, separato da punto e virgola) con una riga per movimento: data, cliente, operazione, importo, valuta, saldo, ordine, nota di credito, validità, dipendente, messaggio e nota.

Email

Due modelli sono forniti in 8 lingue in modules/dfwallet/mails/: dfwallet_credit (portafoglio accreditato) e dfwallet_expiry (promemoria prima della scadenza). Sono scritti nella lingua del cliente, importi e date compresi. Puoi personalizzarli in Internazionale > Traduzioni > Traduzioni email o sovrascriverli nel tema.

Disinstallazione e GDPR

Saldi e cronologia vengono conservati alla disinstallazione, perché sono un debito verso i tuoi clienti. Attiva Elimina saldi e cronologia alla disinstallazione solo se vuoi cancellare tutto. I movimenti di un cliente sono inclusi nell’esportazione dati del modulo GDPR ufficiale.

Domande frequenti

Il cliente non vede l’opzione di pagamento con portafoglio

L’opzione compare solo quando il saldo copre l’intero ordine. Altrimenti sopra i metodi di pagamento compare il pulsante Usa il mio saldo, purché l’uso parziale sia attivo. Verifica anche che il modulo sia abilitato per valuta, paese e gruppo del cliente.

Il portafoglio non è utilizzabile con una ricarica

È voluto: un carrello che contiene una ricarica non può essere pagato con il portafoglio.

Il pannello non compare nella pagina ordine per un dipendente

PrestaShop esegue gli hook di un modulo solo se il profilo del dipendente ha il permesso Visualizza su quel modulo. Aggiungilo in Parametri avanzati > Team > Permessi.