🏪 Portale clienti e fornitori

Un link personale — senza password — da cui il cliente trova le sue fatture, il suo scaduto e il pulsante per pagare con carta
v 3.1 Amministrazione → API & Webhook → Portale clienti Pacchetto Fatturazione
1A cosa serve

Il portale è la copia dei documenti che il cliente si guarda da solo: le fatture emesse, le rate ancora da pagare, quanto è scaduto — e, se lo accendi, il pulsante Paga adesso con carta. Senza telefonare, senza aspettare che qualcuno gli rimandi il PDF.

Il cliente vede solo la sua roba: i suoi documenti emessi e le sue rate. Mai le bozze, mai i documenti annullati, mai quelli di un altro cliente.

2Accendere il portale

In Amministrazione → API & Webhook, linguetta Portale clienti:

  • Portale acceso — finché è spento, nessun link funziona;
  • cosa mostrare: documenti emessi e/o rate e scaduto;
  • il titolo della pagina (di solito il nome dell'azienda) e un messaggio in cima, per esempio il numero da chiamare;
  • per quanti giorni vale un link (novanta di serie).
3Il link del cliente

Si entra con un link, non con una password. Le password sono quello che fa morire i portali: si dimenticano, si resettano, e alla fine il cliente telefona lo stesso.

Per creare un link, cerca il cliente per nome o partita IVA e sceglilo: il link compare subito, da copiare. Oppure premi manda per email, e arriva al suo indirizzo con un pulsante «Apri i miei documenti».

⛔ Il link è la credenziale del cliente: chi ce l'ha vede i suoi documenti. Mandalo a lui, non pubblicarlo. Per questo scade da solo, si revoca con un clic, e un link nuovo per la stessa persona revoca il vecchio.

Nell'elenco dei link vedi quando scade, a chi è stato mandato e quando è stato aperto l'ultima volta, e quante volte: prima di telefonare, sai se l'ha guardato. Un link scaduto si rinnova con un clic.

ℹ️ Per mandare il link per email serve la posta configurata in Parametri → Email. Se non lo è, NOX lo dice invece di far finta di aver spedito: intanto il link puoi copiarlo e mandarlo come preferisci.
4Il pagamento con carta

Per incassare dal portale serve un account Stripe dell'azienda: i soldi arrivano direttamente a lei. Nel pannello metti la chiave segreta di Stripe e il segreto del webhook, e accendi il pagamento con carta.

Su Stripe va creato un webhook verso l'indirizzo che il pannello ti mostra, con l'evento checkout.session.completed.

⚠️ È Stripe a dire che il pagamento è avvenuto, non il browser del cliente. La pagina «pagato» che vede il cliente non prova niente: quell'indirizzo si potrebbe visitare a mano. Quando arriva la conferma di Stripe, la rata si segna pagata e l'incasso entra in prima nota da solo.
ℹ️ Le chiavi di Stripe non si rileggono: il pannello mostra solo le ultime quattro cifre. Scrivile solo per cambiarle.

In fondo al pannello, la tabella Pagati dal portale: chi ha pagato, quale documento, quanto, e in quale registrazione di prima nota è finito.

5Cosa vede il cliente

Una pagina semplice, pensata per il telefono: in cima quanto deve e quanto è scaduto, poi le rate una per una con il pulsante per pagare, poi i suoi documenti e le rate già pagate.

Non somiglia a un gestionale, di proposito: chi la apre non è un utente, è una persona che vuole sapere quanto deve e poterlo pagare.

?Domande frequenti
Il cliente dice che il link non funziona.
Guarda nell'elenco se è scaduto o revocato, e se il portale è acceso. Se è scaduto, premi rinnova e mandalo di nuovo.
Il cliente ha pagato ma la rata risulta ancora aperta.
La rata si chiude quando arriva la conferma di Stripe, di solito in pochi secondi. Se non arriva, controlla su Stripe che il webhook sia configurato verso l'indirizzo giusto e con l'evento checkout.session.completed.
Può pagare la stessa rata due volte?
No: una rata pagata non mostra più il pulsante, e se Stripe manda due volte la stessa conferma l'incasso si registra una volta sola.
Il portale vale anche per i fornitori?
Sì: il link si crea per un soggetto, cliente o fornitore, e mostra i suoi documenti.