Pagamenti
Questa pagina spiega come vengono creati i pagamenti in Agon, come collegare il tuo account Stripe per i pagamenti online con carta, e dove vedere i totali dei pagamenti.
Pagamenti non è una voce a sé nel menu laterale. Le impostazioni relative ai pagamenti si trovano in Impostazioni → Fatturazione, e i totali dei pagamenti si trovano in Report → Ricavi.
Come funzionano i pagamenti in Agon
Agon non elabora i pagamenti direttamente e non ha una schermata per registrare manualmente un
pagamento o un pulsante di rimborso. Un Payment viene creato automaticamente in due modi:
- Checkout Stripe — una volta collegato il tuo account Stripe (vedi sotto), un cliente può pagare online un abbonamento, o una carta regalo acquistata per sé stesso, dall'app mobile. Il denaro passa direttamente tra il cliente e il tuo conto bancario; Agon non detiene mai i fondi.
- Una penale per cancellazione tardiva o mancata presentazione — quando viene effettivamente
applicata (vedi Impostazioni — politica di cancellazione
e Abbonamenti — eccezioni sulle penali), Agon la registra come
Paymentcon fornitoresystem.
Assegnare manualmente un abbonamento a un cliente (vedi Abbonamenti) non crea un pagamento — assegna solo l'abbonamento. Se un cliente ti paga in contanti o con bonifico, al momento non c'è modo di registrare quel pagamento in Agon: assegni semplicemente l'abbonamento, esattamente come faresti per una prova gratuita.
Le vendite di prodotti al dettaglio sono tracciate separatamente (vedi POS / Vendita al dettaglio)
come proprio tipo di record, non come righe Payment — compaiono nel report Vendite Prodotti,
non nei Ricavi.
Collegare Stripe
Agon offre due modi per collegare il tuo account Stripe. Per la maggior parte dei gestori, Connect with Stripe è la scelta più semplice, perché non devi mai cercare o incollare tu stesso una chiave API. Se hai già le chiavi API di Stripe, o preferisci non usare il flusso OAuth, puoi inserirle manualmente — entrambi i percorsi sono supportati a pieno titolo.
Opzione A: Connect with Stripe (consigliata)
- Vai su Impostazioni → Fatturazione.
- Clicca Connect with Stripe.
- Il browser apre la pagina di autorizzazione ospitata da Stripe. Accedi al tuo account Stripe esistente, o creane uno, e autorizza Agon.
- Stripe ti reindirizza a una breve pagina di conferma ospitata da Agon. Chiudi quella scheda e torna su Agon.
- Lo stato Connessione Stripe in Impostazioni → Fatturazione passa a Connesso — automaticamente quando torni sulla finestra di Agon, oppure cliccando Aggiorna stato.
Questo collega il tuo account Stripe direttamente — Agon non detiene mai i tuoi fondi e non c'è nessun account di piattaforma condiviso frapposto tra te e Stripe.
Opzione B: Inserisci manualmente le chiavi API di Stripe
Usa questo percorso se hai già le chiavi API di Stripe a disposizione, o preferisci non usare il flusso OAuth sopra.
- Vai su Impostazioni → Fatturazione e apri Opzioni avanzate.
- Inserisci la tua Chiave segreta e Chiave pubblica, prese dalla tua Dashboard Stripe (Developers → API keys).
- Clicca Salva.
Lo stato Connessione Stripe passa a Connesso una volta salvate chiavi valide.
Configurare il webhook
Il campo Segreto webhook è sempre visibile in Impostazioni → Fatturazione — non è mai nascosto nelle Opzioni avanzate — perché Agon ne ha bisogno per sapere in modo affidabile quando un pagamento va a buon fine, un abbonamento si rinnova, un pagamento fallisce o viene cancellato.
- Se ti sei collegato con l'Opzione B (chiavi manuali), Agon registra il webhook automaticamente per te. Non c'è altro da fare.
- Se ti sei collegato con l'Opzione A (Connect with Stripe), le restrizioni di Stripe di solito impediscono ad Agon di registrare il webhook in automatico — è un limite della piattaforma Stripe, non qualcosa che Agon non è riuscito a costruire. Agon ti mostra l'URL webhook esatto da registrare, e dovrai creare il webhook tu stesso, una sola volta, nella tua Dashboard Stripe — vedi Configurazione webhook Stripe per i passaggi esatti.
Se il tuo studio ha un tipo di abbonamento ricorrente attivo ma nessun segreto webhook salvato, Agon mostra un avviso in Impostazioni → Fatturazione, perché la fatturazione ricorrente non ha altro modo per rilevare rinnovi, fallimenti o cancellazioni.
Cambiare o rimuovere le chiavi Stripe
Non esiste un'azione separata "Scollega Stripe". Per interrompere i pagamenti Stripe, revoca o rigenera la chiave dalla tua Dashboard Stripe — i checkout dei clienti falliranno finché non salvi una nuova chiave funzionante in Impostazioni → Fatturazione, oppure sostituisci quelle che non vuoi più usare.
Emettere un rimborso
Agon non ha un proprio pulsante di rimborso:
- Pagamento Stripe — elabora il rimborso dalla tua Dashboard Stripe. Agon riceve il risultato al webhook successivo, che aggiorna lo stato del pagamento qui.
- Contanti o bonifico — restituisci il denaro tu stesso; non c'è nulla da aggiornare in Agon, dato che quel pagamento non è mai stato registrato qui.
Stati del pagamento
| Stato | EN | IT | FR | DE | ES | PT | NL |
|---|---|---|---|---|---|---|---|
| Completed | Completed | Completato | Complété | Abgeschlossen | Completado | Concluído | Voltooid |
| Refunded | Refunded | Rimborsato | Remboursé | Erstattet | Reembolsado | Reembolsado | Terugbetaald |
| Failed | Failed | Fallito | Échoué | Fehlgeschlagen | Fallido | Falhou | Mislukt |
Visualizzare i totali dei pagamenti
Vai su Report → Ricavi per il ricavo totale, il numero di pagamenti e l'importo medio del
pagamento su un intervallo di date. Al momento non esiste una schermata che elenca lo storico dei
pagamenti di un singolo cliente. Gli abbonamenti assegnati manualmente e pagati in contanti non
compaiono nei Ricavi, perché non creano mai un record Payment (vedi sopra).
Cosa fare se qualcosa va storto?
Un pagamento Stripe risulta In sospeso Attendi qualche minuto — i webhook di Stripe possono avere ritardi. Se resta in sospeso dopo 10 minuti, controlla la tua Dashboard Stripe e verifica che il Segreto webhook in Impostazioni → Fatturazione corrisponda a quello mostrato in Stripe.
La connessione Stripe risulta Non connesso Vai su Impostazioni → Fatturazione e clicca di nuovo Connect with Stripe, oppure, se usi il percorso manuale, reinserisci la tua Chiave segreta e Chiave pubblica in Opzioni avanzate.
I miei numeri nei Ricavi sembrano più bassi di quanto ho effettivamente incassato
Controlla se alcuni abbonamenti sono stati assegnati manualmente invece di essere pagati tramite
checkout Stripe — questi non creano mai un record Payment, quindi non contano nei Ricavi.