# Pagamento con acconto: acconto all'ordine e saldo alla consegna > Installazione Installate il modulo da Moduli > Gestione moduli > Carica un modulo inviando il file ZIP, oppure copiate la cartella dfdeposit nella directory /modules/ del negozio e cliccate su… - Pagina: - Lingua: it - Aggiornato il: 2026-10-07 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfdeposit/index.md), [en](https://www.datafirefly.com/en/documentation/dfdeposit/index.md), [es](https://www.datafirefly.com/es/documentation/dfdeposit/index.md), [de](https://www.datafirefly.com/de/documentation/dfdeposit/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdeposit/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdeposit/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdeposit/index.md) - Indice: ## Installazione Installate il modulo da **Moduli > Gestione moduli > Carica un modulo** inviando il file ZIP, oppure copiate la cartella `dfdeposit` nella directory `/modules/` del negozio e cliccate su Installa. All'installazione, il modulo: - crea le sue tabelle (acconti, transazioni Stripe, regole delle percentuali); - crea cinque stati dell'ordine: **In attesa dell'acconto**, **Acconto ricevuto, saldo da pagare**, **Saldo richiesto**, **Pronto per il ritiro, saldo da pagare** e **Spedito, saldo da pagare**; - aggiunge il menù **Ordini > Acconti** e la schermata **Percentuali di acconto**, raggiungibile da quel menù e dalla configurazione; - registra i suoi hook: metodi di pagamento, scheda prodotto, carrello, conferma d'ordine, account cliente, pagina ordine del back office e fattura PDF. Alla disinstallazione le tabelle vengono conservate di proposito: la numerazione delle fatture di acconto e delle note di credito deve restare progressiva se reinstallate il modulo. ## Verifica della configurazione La pagina di configurazione si apre con un elenco di controlli in verde, arancione o rosso: metodo di pagamento pronto, chiave Stripe accettata da Stripe, modalità test ancora attiva, segreto del webhook inserito e data dell'ultimo evento ricevuto, ultima esecuzione del cron, stati che richiedono il saldo presenti, uno di essi contrassegnato come pagato, note legali delle fatture. Correggete ogni riga rossa prima di aprire le vendite. Il pulsante **Testa la chiave Stripe** interroga Stripe con la chiave della modalità selezionata. Il test parte anche automaticamente al salvataggio quando la chiave cambia. Gli URL del webhook e del cron si copiano con il pulsante **Copia**. ## Regole di acconto ### Percentuale e importo minimo **Percentuale di acconto**: quota dei prodotti idonei pagata all'ordine, tra 1 e 99 %. **Importo minimo dell'ordine** (IVA inclusa): al di sotto, l'opzione acconto è nascosta. 0 significa nessun minimo. ### Categorie idonee e altri prodotti Lasciate l'elenco vuoto per proporre l'acconto su tutto il catalogo, oppure selezionate le categorie interessate. L'impostazione **Altri prodotti nel carrello** stabilisce cosa succede ai prodotti non idonei in un carrello misto: **Pagati per intero con l'acconto** (aggiunti al 100 % all'importo dell'acconto) oppure **Nascondi l'opzione acconto**. ### Spese di spedizione e arrotondamento Le spese di spedizione possono essere **pagate con il saldo** (predefinito), **pagate con l'acconto** o **ripartite secondo la percentuale di acconto**. L'arrotondamento avviene al centesimo o all'unità superiore, per importi come 748 € invece di 747,35 €. ### Gruppi di clienti e visualizzazione **Gruppi di clienti**: solo i gruppi selezionati vedono l'opzione, per esempio i professionisti per le attrezzature professionali. Vuoto = tutti i clienti. **Mostra nelle schede prodotto** aggiunge sotto il pulsante del carrello una riga come «Ordina con un acconto del 30 %: 747,00 € ora, 1.743,00 € alla spedizione o al ritiro». **Mostra nel carrello** aggiunge la ripartizione acconto / saldo al riepilogo. ## Percentuali per prodotto, categoria o marca Aprite **Percentuali di acconto** dall'elenco degli acconti o dalla configurazione, poi **Aggiungi una percentuale**. Ogni regola riguarda una sola destinazione: un prodotto (ricerca per nome, riferimento o ID), una categoria o una marca, con una percentuale tra 0 e 99 %. Ordine di priorità: la regola del prodotto, poi quella della categoria più profonda tra le categorie del prodotto, poi quella della marca, infine la percentuale predefinita della configurazione. Una percentuale dello **0 %** esclude la destinazione: il prodotto viene pagato per intero con l'acconto. Una regola si applica anche se la categoria del prodotto non è tra le categorie idonee. Se un carrello contiene prodotti con percentuali diverse, l'acconto è calcolato riga per riga. La percentuale mostrata al cliente e in fattura è allora quella effettiva, per esempio 48,39 %. ## Saldo ### Stati che richiedono il saldo Quando un ordine con acconto pagato passa a uno di questi stati, il cliente riceve l'email di richiesta del saldo con il link di pagamento. Per impostazione predefinita: **Saldo richiesto**, **Pronto per il ritiro, saldo da pagare** e **Spedito, saldo da pagare**. Non usate lo stato nativo **Spedito** per un ordine con saldo non pagato: in PrestaShop è contrassegnato come pagato e il resto viene registrato automaticamente come saldato. Usate **Spedito, saldo da pagare**. La verifica della configurazione segnala uno stato che richiede il saldo contrassegnato come pagato. ### Stato a pagamento completato Stato applicato quando il saldo arriva a zero (Pagamento accettato per impostazione predefinita) e un secondo per gli ordini già spediti (Spedito per impostazione predefinita). In quel momento PrestaShop genera la fattura finale. ### Promemoria e notifiche **Promemoria ogni** X giorni e **Numero massimo di promemoria** regolano le email di sollecito inviate dal cron. **Notifiche al team**: indirizzi, separati da virgole, avvisati quando un cliente paga un acconto o un saldo online, quando arriva un acconto con un importo inatteso e quando viene effettuato un ordine con bonifico. ### Altri modi per pagare il saldo Testo libero per lingua mostrato nella pagina del saldo e nelle email, per esempio «Il saldo può essere pagato anche con carta o in contanti al ritiro in laboratorio». ## Pagamento con carta (Stripe) 1. Attivate **Attiva il pagamento con carta** e scegliete la modalità **Test** o **Live**. 2. Incollate la chiave segreta della modalità scelta (`sk_test_`, `sk_live_` o una chiave limitata `rk_`). Le chiavi salvate sono mascherate. 3. Nella dashboard Stripe, Sviluppatori > Webhook, create un endpoint con l'URL mostrato nella configurazione e gli eventi `checkout.session.completed` e `checkout.session.async_payment_succeeded`. 4. Copiate il segreto di firma `whsec_` nel campo **Segreto di firma del webhook**. Il cliente viene reindirizzato a una pagina Stripe Checkout. Al ritorno, l'ordine viene creato subito. Se il cliente chiude la scheda prima di tornare, è il webhook a creare l'ordine. Ogni sessione viene elaborata una sola volta. Dopo il primo pagamento di test, la riga «Ultimo evento Stripe ricevuto» della verifica deve diventare verde. Se resta arancione, controllate URL ed eventi dell'endpoint. ## Bonifico bancario Attivate **Proponi l'acconto con bonifico** e inserite intestatario, IBAN, BIC e nome della banca. L'ordine viene creato in **In attesa dell'acconto**; il cliente vede le vostre coordinate nella pagina di conferma e le riceve via email, con il riferimento dell'ordine come causale. **Mostra le coordinate bancarie per il saldo** aggiunge il bonifico come modo di pagare il saldo. **Annulla gli ordini con bonifico non pagati dopo** X giorni: il cron annulla gli ordini ancora in attesa dell'acconto senza alcun pagamento, e le scorte tornano in vendita. 0 disattiva questo annullamento. ## Fattura di acconto **Prefisso di numerazione** (AC per impostazione predefinita) e **Prefisso delle note di credito** (AVAC per impostazione predefinita) devono essere diversi. **Numero successivo (minimo)** permette di proseguire una numerazione esistente: la fattura successiva prende questo valore se è superiore all'ultimo numero emesso. **Note legali**: testo per lingua stampato in fondo a ogni fattura di acconto (ragione sociale, capitale, partita IVA, condizioni di pagamento). ## Cron Pianificate una volta al giorno l'URL del cron mostrato nella configurazione, per esempio alle 6. Invia i promemoria del saldo e annulla gli ordini con bonifico scaduti, per tutti i negozi. La verifica della configurazione indica la sua ultima esecuzione. ## Il percorso del cliente 1. Al checkout, il cliente sceglie «Paga un acconto di X € con carta» o «con bonifico». Il dettaglio mostra totale, acconto, saldo e una barra di ripartizione. 2. Dopo il pagamento con carta, l'ordine passa a **Acconto ricevuto, saldo da pagare** e la fattura di acconto viene emessa e allegata all'email. Con il bonifico, l'ordine attende la vostra conferma. 3. Quando l'ordine raggiunge uno stato che richiede il saldo, il cliente riceve il link alla pagina del saldo: pagamento con carta, coordinate bancarie e vostre istruzioni. 4. Una volta pagato il saldo, l'ordine passa allo stato finale e il cliente riceve un'email di conferma. Un avanzamento in tre passaggi (Acconto versato, Ordine pronto e saldo richiesto, Interamente pagato) compare nella conferma, nel dettaglio ordine dell'account cliente e nella pagina del saldo. Il cliente può pagare il saldo dal suo account prima ancora che venga richiesto. ## Gestire gli acconti nel back office ### Ordini > Acconti In alto, quattro indicatori: saldi ancora da incassare, saldi richiesti, bonifici da confermare e acconti incassati questo mese. Per ogni ordine l'elenco mostra percentuale, totale, acconto, importo pagato, saldo da pagare, stato e fattura di acconto. Selezionate più ordini e poi **Richiedi il saldo** per inviare i link in una volta, per esempio il giorno in cui un lotto è pronto per il ritiro. ### Riquadro «Acconto e saldo» della pagina ordine - **Conferma l'acconto**: per un bonifico ricevuto, inserite importo, metodo e riferimento. Il pagamento viene registrato e la fattura di acconto emessa e inviata. - **Richiedi il saldo ora** o **Invia di nuovo il link di pagamento**, con il link del saldo da copiare. - **Registra un pagamento del saldo**: bonifico, assegno, contanti, carta in negozio o alla consegna. Quando il saldo arriva a zero, l'ordine passa allo stato finale e il cliente viene avvisato. - **Annulla la fattura di acconto (nota di credito)**: per un ordine annullato, emette una nota di credito numerata. Il rimborso si effettua da Stripe o con bonifico. ## Fatturazione La fattura di acconto riporta indirizzo di fatturazione, riferimento dell'ordine, percentuale, una riga per aliquota IVA con imponibile, IVA e totale, metodo di pagamento e saldo restante. La ripartizione IVA è calcolata in proporzione alle aliquote dell'ordine, spedizione e confezione regalo comprese, e fissata all'emissione. Il cliente la scarica dal suo account, l'amministratore dall'elenco o dalla pagina ordine. La fattura PrestaShop finale viene generata al pagamento del saldo, con un riquadro che richiama la fattura di acconto. La nota di credito riporta gli importi della fattura di acconto in negativo e il riferimento della fattura annullata. ## Risoluzione dei problemi ### L'opzione acconto non compare al checkout Controllate nell'ordine: un metodo di pagamento pronto (chiave Stripe o IBAN), il gruppo del cliente, l'importo minimo, le categorie idonee e le regole allo 0 %, e l'impostazione «Nascondi l'opzione acconto» se il carrello contiene un prodotto non idoneo. ### Un pagamento con carta non ha creato l'ordine Il segreto del webhook probabilmente manca o è errato, oppure l'endpoint non ascolta gli eventi giusti. Il pagamento resta visibile in Stripe. Una volta corretto il webhook, reinviate l'evento dalla dashboard Stripe: l'ordine viene creato. ### L'ordine è in «Errore di pagamento» L'importo pagato con carta non corrisponde all'acconto previsto, di solito perché il carrello è cambiato durante il pagamento. Controllate i pagamenti dell'ordine, poi confermate l'acconto dal riquadro della pagina ordine o rimborsate il cliente. ### I promemoria non partono Il cron non viene eseguito oppure l'intervallo dei promemoria è a 0. La verifica della configurazione indica la data dell'ultima esecuzione. ### Il saldo risulta pagato ma il cliente non ha versato nulla All'ordine è stato applicato uno stato contrassegnato come pagato (Pagamento accettato, Spedito): PrestaShop registra allora il resto come pagato. Controllate i pagamenti dell'ordine e per i prossimi ordini usate gli stati del modulo. ## Compatibilità - PrestaShop da 8.0 a 9.x, lo stesso ZIP copre entrambe le versioni. - Multinegozio, multivaluta (valute senza decimali gestite per Stripe) e multilingua. - Architettura ModuleAdminController, API Stripe chiamata direttamente, senza dipendenze Composer. - Interfaccia, email e PDF in francese, inglese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.