Passa al contenuto principale

Stripe

Disponibile

Questa integrazione è attiva e pronta all'uso su tutti i piani Pro.

Collega Stripe a Frihet per automatizzare gli incassi degli abbonamenti e sincronizzare automaticamente i pagamenti.

A cosa serve?​

Con Stripe integrato:

  • Abbonamenti ricorrenti — Incassa automaticamente ogni mese
  • Fatture automatiche — Frihet crea fatture quando c'è un pagamento
  • Riconciliazione automatica — I pagamenti vengono contrassegnati come incassati istantaneamente
  • Rapporti sincronizzati — I tuoi numeri in Frihet riflettono la realtà di Stripe

Requisiti​

  • Account Stripe attivo — Crea uno su stripe.com
  • Permessi di amministratore — Nel tuo account Stripe
  • Frihet Pro o superiore — Stripe non è disponibile nel piano Free

Connettere Stripe​

Passaggio 1: Apri le integrazioni​

  1. Vai a Impostazioni → Integrazioni
  2. Cerca Stripe
  3. Clicca su Connetti

Passaggio 2: Autenticazione​

  1. Verrai reindirizzato a Stripe
  2. Accedi con il tuo account Stripe
  3. Autorizza Frihet ad accedere al tuo account
  4. Frihet reindirizza automaticamente

Passaggio 3: Conferma la connessione​

Una volta autorizzato:

✅ Stripe connesso
ID di account: acct_XXXXXXXXX
Ultima sincronizzazione: 2 minuti fa

Come funziona​

Abbonamenti​

Se hai clienti in Stripe con abbonamenti:

  1. Frihet sincronizza automaticamente ogni cliente e il suo piano
  2. Ogni mese Stripe incassa dal cliente
  3. All'incasso, Frihet crea automaticamente una fattura
  4. La fattura appare nel tuo elenco con stato "Pagata"

Esempio:

  • Cliente: Azienda SRL
  • Piano Stripe: €299/mese
  • 1 feb 2025: Stripe incassa €299
  • Frihet crea una fattura di €299 automaticamente
  • Stato: Pagata ✅

Pagamenti puntuali​

Se usi Stripe per incassi puntuali:

  1. Crei la fattura in Frihet
  2. Generi il link di pagamento con Stripe (da Stripe Connect - vedi sezione successiva)
  3. Il cliente paga
  4. Frihet contrassegna la fattura come pagata automaticamente

Fatturazione online​

Con Stripe puoi:

  • Inviare fatture direttamente da Stripe
  • I clienti pagano con carta, Apple Pay, Google Pay
  • Tutto sincronizzato in Frihet

Dati che vengono sincronizzati​

Da Stripe a Frihet​

DatoSincronizzazione
ClientiOgni 15 minuti
Abbonamenti attiviOgni 15 minuti
PagamentiIn tempo reale
RimborsiIn tempo reale
FattureOgni 15 minuti

Da Frihet a Stripe​

DatoSincronizzazione
Dati clienteManuale (alla creazione)
Metadati fatturaManuale (al collegamento)

Nota: La sincronizzazione è principalmente da Stripe → Frihet. Non modificare i clienti in Frihet che esistono in Stripe, per evitare conflitti.

Gestione degli abbonamenti​

Visualizzare gli abbonamenti in Frihet​

  1. Vai a Clienti
  2. Apri un cliente che ha un abbonamento in Stripe
  3. Nella scheda Cronologia, vedi:
    • Abbonamento attivo
    • Prossimo incasso
    • Storico dei pagamenti

Annullare l'abbonamento​

Se un cliente annulla il suo abbonamento in Stripe:

  1. Frihet rileva automaticamente il cambiamento
  2. Contrassegna l'abbonamento come "Annullato"
  3. Non genera più fatture

Modificare il piano di abbonamento​

Se un cliente cambia piano (superiore o inferiore):

  1. Lo fa nel tuo portale clienti Stripe (o tu manualmente)
  2. Frihet aggiorna il prossimo incasso
  3. La fattura rifletterà il nuovo importo

Riconciliazione dei pagamenti​

Frihet confronta automaticamente:

  • Fatture non pagate in Frihet vs Pagamenti in Stripe
  • Se c'è un pagamento che Frihet non riconosce, lo contrassegna come "Pagamento in attesa di registrazione"
  • Puoi confermare il pagamento con un clic

Come vedere le fatture da riconciliare:

  1. Vai a Fatturazione → Fatture
  2. Filtra per "Richiede riconciliazione"
  3. Conferma i pagamenti con un clic
  4. Automaticamente la fattura passa a "Pagata"

Dichiarazioni fiscali​

Con Stripe sincronizzato:

  • Il tuo riepilogo fiscale include i pagamenti di Stripe
  • L'assistente IA può chiedere: "Quanto ho incassato con Stripe questo mese?"
  • I rapporti sui ricavi riflettono la realtà

Sicurezza​

  • Connessione OAuth — Non condividiamo la password di Stripe
  • API limitata — Solo accesso in lettura ai pagamenti, senza accesso al denaro
  • Disconnessione istantanea — Revoca l'accesso in Impostazioni quando vuoi
  • Crittografia — Token archiviati crittografati in Frihet

Disconnettere Stripe​

  1. Vai a Impostazioni → Integrazioni
  2. Cerca Stripe
  3. Clicca su Disconnetti
  4. Conferma l'azione

Dopo la disconnessione:

  • Gli abbonamenti attivi in Stripe continuano a funzionare (ma Frihet non li vede)
  • Non ci sono nuove fatture automatiche
  • Puoi riconnetterti in qualsiasi momento

Risoluzione dei problemi​

"Non vedo i miei abbonamenti in Frihet"​

  • Verifica che Stripe sia connesso (dovresti vedere "✅ Connesso" in Integrazioni)
  • Attendi 15 minuti per la prima sincronizzazione
  • Gli abbonamenti devono essere nello stato "attivo" in Stripe

"Una fattura non è stata contrassegnata come pagata"​

  • La riconciliazione automatica funziona solo se l'importo corrisponde esattamente
  • Se ci sono sconti o aggiustamenti, potrebbe non essere rilevato
  • Contrassegna manualmente dalla fattura: "Conferma pagamento" → inserisci l'importo

"Errore durante la connessione di Stripe"​

  • Verifica di avere accesso di amministratore in Stripe
  • Il tuo account Stripe non ha restrizioni (contatta Stripe in tal caso)
  • Prova a disconnettere e riconnettere
  • Se persiste, contatta il supporto
Automazioni avanzate

Per automazioni avanzate con Stripe, consulta i webhooks di Frihet che notificano eventi come invoice.created o invoice.paid in tempo reale. Puoi combinarli con la API REST per costruire flussi personalizzati.

Prossimi passi​

Successivo: Stripe Connect - Link di pagamento nelle tue fatture