Come funziona
Il cliente preme Acquista nella pagina Prezzi (o fa un upgrade dalla sua area cliente), sceglie come pagare e paga. Quando il pagamento è confermato il CRM, da solo:
- segna l'ordine come pagato e registra l'incasso in Finance › Pagamenti;
- attiva il piano, le licenze e la scadenza nell'account del cliente e crea il suo CRM (se non aveva già la prova: in quel caso il CRM resta lo stesso, con i suoi dati);
- porta il cliente a opportunità vinta (con il rinnovo, se previsto dal piano ricorrente);
- avvisa il gestore del contratto (il commerciale assegnato; se manca, gli amministratori) con una notifica e un'e-mail interna;
- invia al cliente l'e-mail di ringraziamento (testo modificabile in *Testi delle e-mail*: «payment_thanks»).
Configurazione
In Amministrazione › Metodi di pagamento accendi o spegni carta, PayPal e bonifico, scrivi i dati bancari e l'IVA.
Le chiavi si inseriscono nel pannello del server (cPanel › Setup Python App › Environment variables), mai nel CRM:
| Variabile | Dove si trova |
|---|---|
STRIPE_SECRET_KEY | Stripe › Sviluppatori › Chiavi API › chiave segreta (sk_live_…) |
STRIPE_WEBHOOK_SECRET | Stripe › Sviluppatori › Webhook › il tuo endpoint › chiave di firma (whsec_…) |
PAYPAL_CLIENT_ID, PAYPAL_SECRET | developer.paypal.com › Apps & Credentials › la tua app «Live» |
PAYPAL_MODE | live per i pagamenti veri, sandbox per le prove |
Dopo aver salvato le variabili premi Restart nella stessa pagina.
Rinnovo automatico (abbonamenti)
Se il cliente sceglie il rinnovo automatico, il pagamento con carta crea un abbonamento Stripe e quello con PayPal un abbonamento PayPal: i rinnovi arrivano da soli e il CRM registra ogni rinnovo come ordine pagato, prolunga la scadenza e invia l'e-mail di ringraziamento. Per PayPal aggiungi la variabile PAYPAL_WEBHOOK_ID e crea il webhook (indirizzo ed eventi sono in Amministrazione › Metodi di pagamento).
Webhook di Stripe
In Stripe › Sviluppatori › Webhook › Aggiungi endpoint:
- URL:
https://IL-TUO-DOMINIO/api/pagamenti/stripe - eventi:
checkout.session.completed,checkout.session.async_payment_succeeded,checkout.session.async_payment_failed,invoice.paid,invoice.payment_failed,customer.subscription.deleted.
Il webhook conferma il pagamento anche se il cliente chiude la pagina prima di tornare sul sito. Ogni avviso è verificato con la firma: quelli senza firma valida vengono rifiutati.
Modalità prova
Finché la modalità prova è accesa, i metodi senza chiavi mostrano una pagina di pagamento simulato: nessun addebito reale, ma tutto il resto (piano, e-mail, notifiche) funziona. Spegnila prima di aprire le vendite.
Seguire ordini e incassi
Finance › Ordini online elenca gli ordini con stato e metodo; Finance › Pagamenti gli incassi. Si possono filtrare ed esportare in Excel o CSV. Nel dettaglio di un ordine puoi:
- registrare il pagamento a mano (ad esempio quando arriva un bonifico: indica il CRO);
- annullare un ordine non pagato;
- segnare un rimborso (il rimborso vero si fa dal pannello di Stripe o PayPal);
- aggiungere una nota.
Ogni operazione finisce nel registro delle modifiche.
Cambiare il piano a mano
In Clienti › Account dei clienti solo un amministratore (livello Impostazioni) può cambiare a mano piano, licenze, durata e scadenza di un cliente (per esempio dopo un accordo commerciale), indicando una nota. La modifica finisce nel registro delle modifiche. Nell'elenco Lead e clienti il filtro Pagamento online mostra chi ha pagato o ha un ordine in attesa.
Updated on 21/10/2026