GoCardless
Questa integrazione è attiva e pronta all'uso in Frihet.
Connetti GoCardless a Frihet per gestire gli incassi tramite addebito diretto SEPA. Consulta mandati, pagamenti e clienti direttamente dal tuo ERP. Ideale per abbonamenti e incassi ricorrenti con commissioni basse.
A cosa serve?
Con GoCardless integrato:
- Importa pagamenti — Importa gli incassi da GoCardless come fatture in Frihet con un clic
- Deduplicazione automatica — I pagamenti già importati non vengono duplicati (prefisso
GC-) - Visualizza pagamenti — Consulta tutti i tuoi incassi tramite addebito diretto da Frihet
- Gestisci clienti — Accedi alle informazioni dei clienti con mandati attivi
- Consulta mandati — Visualizza lo stato di ogni mandato SEPA (attivo, in sospeso, annullato)
- Riconcilia incassi — Associa i pagamenti di GoCardless con le fatture in Frihet
- Modalità sandbox — Testa l'integrazione con dati fittizi
Requisiti
- Account GoCardless attiva — gocardless.com
- Access Token dell'API — Si genera dal dashboard
- Frihet Pro o superiore
Connettere GoCardless con Frihet
Passo 1: Ottenere il tuo Access Token
- Vai su manage.gocardless.com (o manage-sandbox.gocardless.com per i test)
- Accedi al tuo account
- Vai su Developers nel menu laterale
- Clicca su Create → Access Token
- Seleziona lo scope Read-only (sufficiente per consultare i dati) o Read-write se hai bisogno di gestire gli incassi
- Dai un nome (es: "Frihet ERP")
- Copia il token generato
L'Access Token viene mostrato solo una volta al momento della creazione. Copialo prima di chiudere la finestra.
Passo 2: Configurare in Frihet
- Vai su Impostazioni → Integrazioni
- Cerca GoCardless
- Clicca su Connetti
- Incolla il tuo Access Token
- Seleziona l'ambiente:
- Live — Per dati reali
- Sandbox — Per i test
- Clicca su Verifica connessione
Passo 3: Verificare la connessione
Se la connessione è corretta, Frihet mostrerà:
- Nome della tua organizzazione in GoCardless
- Numero di mandati attivi
- Numero di clienti registrati
Come funziona
Frihet si connette all'API v2 di GoCardless (versione 2015-07-06) usando l'autenticazione Bearer:
- Fornisci il tuo Access Token
- Frihet invia il token nell'intestazione
Authorization: Bearer <token>di ogni richiesta - I dati di pagamenti, clienti e mandati vengono consultati su richiesta
- Il token viene memorizzato cifrato (AES-256-GCM) in Frihet
- Tutta la comunicazione avviene tramite HTTPS
Dati sincronizzati
| Dato | Direzione | Frequenza |
|---|---|---|
| Pagamenti (incassi) | GoCardless → Frihet | Su richiesta |
| Clienti | GoCardless → Frihet | Su richiesta |
| Mandati SEPA | GoCardless → Frihet | Su richiesta |
| Stato dei pagamenti | GoCardless → Frihet | Su richiesta |
Casi d'uso
Consulenza con quote mensili
Addebiti una quota mensile ai tuoi clienti tramite addebito diretto. Da Frihet puoi vedere quali pagamenti sono stati incassati correttamente, quali sono in sospeso e quali sono falliti, senza uscire dal tuo ERP.
SaaS con abbonamenti SEPA
I tuoi clienti europei preferiscono pagare tramite addebito diretto invece che con carta. GoCardless gestisce gli incassi ricorrenti e Frihet ti mostra lo stato di ogni pagamento insieme alle fatture emesse.
Verificare i mandati prima di fatturare
Prima di emettere una fattura ricorrente, verifica da Frihet se il mandato del cliente è ancora attivo. Evita di fatturare a clienti il cui mandato è scaduto o è stato annullato.
Importare pagamenti in Frihet
Puoi importare i pagamenti di GoCardless come fatture in Frihet:
- Vai su Impostazioni → Integrazioni → GoCardless
- Nella scheda Dati, clicca su Importa pagamenti
- Frihet scaricherà tutti i pagamenti e creerà fatture per ciascuno
- I pagamenti già importati precedentemente vengono saltati automaticamente (deduplicazione per
GC-{id}) - Al termine, vedrai il numero esatto di pagamenti importati
I pagamenti importati includono: importo, valuta, data, riferimento e stato.
Modalità Sandbox
GoCardless offre un ambiente sandbox completamente separato:
- Registrati su manage-sandbox.gocardless.com
- Crea un Access Token nell'ambiente sandbox
- Configura Frihet in modalità "Sandbox"
- Crea mandati e pagamenti di prova dal dashboard sandbox
- Verifica che i dati appaiano correttamente in Frihet
Stati di pagamento in GoCardless
| Stato GoCardless | Significato |
|---|---|
pending_submission | Pagamento creato, in attesa di essere inviato alla banca |
submitted | Inviato alla banca, in elaborazione |
confirmed | Incasso effettuato con successo |
paid_out | Fondi trasferiti sul tuo conto |
failed | L'incasso è fallito (fondi insufficienti, mandato annullato, ecc.) |
cancelled | Annullato prima dell'elaborazione |
Risoluzione dei problemi
"Errore di autenticazione"
- Verifica che l'Access Token sia corretto e non sia scaduto
- Assicurati di usare un token Live in modalità Live e Sandbox in modalità Sandbox
- Se hai rigenerato il token in GoCardless, aggiornalo in Frihet
"Non vedo i miei pagamenti"
- Controlla di avere pagamenti registrati nel tuo account GoCardless
- Verifica che il token abbia i permessi di lettura
- In sandbox, crea prima dei pagamenti di prova
"Errore di versione dell'API"
- Frihet usa la versione dell'API 2015-07-06 di GoCardless, che è stabile e compatibile
- Se GoCardless notifica modifiche all'API, aggiorneremo l'integrazione
"Voglio disconnettere"
- Vai su Impostazioni → Integrazioni → GoCardless
- Clicca su Disconnetti
- Opzionalmente, revoca l'Access Token dal dashboard di GoCardless