PayPal
Questa integrazione è attiva e pronta all'uso in Frihet.
Connetti il tuo account PayPal Business a Frihet. Importa transazioni, consulta saldi e riconcilia automaticamente gli incassi internazionali con le tue fatture. Supporta la modalità sandbox per i test.
A cosa serve?
Con PayPal integrato:
- Importare transazioni — Importa automaticamente gli incassi PayPal in Frihet come fatture
- Paginazione completa — Importa tutte le transazioni senza limite (paginazione automatica)
- Cronologia intelligente — Prima importazione: 1 anno di cronologia. Successivamente: solo nuove transazioni dall'ultima sincronizzazione
- Rimborsi — I rimborsi vengono importati con prefisso
[Refund]e importo negativo per una contabilità chiara - Consultare saldi — Visualizza il tuo saldo PayPal direttamente dal pannello di Frihet
- Riconciliare incassi — Associa le transazioni PayPal a fatture esistenti
- Multi-valuta — Gestisce incassi in EUR, USD, GBP e altre valute
- Deduplicazione — Le transazioni già importate non vengono duplicate (prefisso
PP-) - Modalità sandbox — Testa l'integrazione senza influire sui dati reali
Requisiti
- Account PayPal Business — Gli account personali non hanno accesso all'API
- Applicazione su PayPal Developer — Per ottenere Client ID e Client Secret
- Frihet Pro o superiore
Connettere PayPal con Frihet
Passo 1: Creare un'applicazione su PayPal Developer
- Vai su developer.paypal.com
- Accedi con il tuo account PayPal Business
- Nella dashboard, vai su Apps & Credentials
- Seleziona la modalità Live (o Sandbox per i test)
- Fai clic su Create App
- Dai un nome (es: "Frihet ERP")
- Fai clic su Create App
Una volta creata, vedrai:
- Client ID — Un identificatore pubblico (es:
AaBbCcDdEe...) - Client Secret — Una chiave privata (fai clic su "Show" per vederla)
Il Client Secret viene mostrato una sola volta. Copialo e conservalo in un luogo sicuro prima di continuare.
Passo 2: Configurare in Frihet
- Vai su Impostazioni → Integrazioni
- Cerca PayPal
- Fai clic su Connetti
- Inserisci il tuo Client ID e Client Secret
- Seleziona la modalità:
- Live — Per transazioni reali
- Sandbox — Per test con dati fittizi
- Fai clic su Verifica connessione
- Se corretto, vedrai "Connesso"
Passo 3: Verificare la connessione
- Frihet ottiene automaticamente un token OAuth2 utilizzando le tue credenziali
- Se la verifica ha successo, vedrai il tuo saldo PayPal nel pannello
- Puoi effettuare un'importazione di prova con le ultime transazioni
Come funziona
Frihet utilizza l'API REST v2 di PayPal con autenticazione OAuth2 (client credentials flow):
- Tu fornisci Client ID e Client Secret
- Frihet richiede automaticamente un token di accesso a PayPal
- Con quel token, Frihet consulta transazioni e saldi
- Le credenziali vengono archiviate cifrate (AES-256-GCM) in Frihet
- Il token si rinnova automaticamente quando scade
In nessun momento devi gestire i token manualmente.
Dati sincronizzati
| Dato | Direzione | Frequenza |
|---|---|---|
| Transazioni ricevute | PayPal → Frihet | Su richiesta / periodica |
| Saldo dell'account | PayPal → Frihet | Ad ogni consultazione |
| Dati del pagatore | PayPal → Frihet | Ad ogni transazione |
| Valuta e tasso di cambio | PayPal → Frihet | Ad ogni transazione |
Casi d'uso
Freelancer con clienti internazionali
Ricevi pagamenti da clienti in USD ed EUR tramite PayPal. Frihet importa ogni pagamento, lo associa alla fattura corrispondente e converte l'importo nella tua valuta base.
Negozio online con PayPal come metodo di pagamento
Ricevi pagamenti dai clienti tramite PayPal Checkout. Le transazioni vengono importate in Frihet e puoi riconciliarle con gli ordini fatturati.
Verificare il saldo prima di pagare i fornitori
Consulta il tuo saldo PayPal dal pannello di Frihet senza uscire dall'applicazione. Decidi se hai fondi disponibili prima di effettuare trasferimenti.
Modalità Sandbox
Per testare l'integrazione senza influire sui dati reali:
- Su developer.paypal.com, crea un'app in modalità Sandbox
- Usa le credenziali Sandbox in Frihet (seleziona la modalità "Sandbox")
- PayPal fornisce account di prova con saldo fittizio
- Verifica che le transazioni vengano importate correttamente
- Quando sei pronto, passa alla modalità Live con le credenziali di produzione
Risoluzione dei problemi
"Errore di autenticazione"
- Verifica che Client ID e Client Secret siano corretti
- Assicurati di usare credenziali Live in modalità Live e Sandbox in modalità Sandbox
- Controlla che il tuo account PayPal Business sia attivo e verificato
"Le transazioni non vengono importate"
- Verifica che ci siano transazioni nel periodo consultato (1 anno nella prima importazione, dall'ultima sincronizzazione nelle successive)
- In modalità Sandbox, genera transazioni di prova dalla dashboard di PayPal Developer
- Controlla che la tua applicazione su PayPal abbia i permessi necessari attivati
- Se il toast mostra "No new transactions to import", tutte le transazioni sono già in Frihet
"Errore di permessi nell'API"
- Quando crei l'app su PayPal Developer, assicurati che includa lo scope delle transazioni
- Se hai cambiato i permessi, genera un nuovo Client Secret e aggiornalo in Frihet
"Voglio passare da Sandbox a Live"
- Vai su Impostazioni → Integrazioni → PayPal
- Fai clic su Disconnetti
- Riconnetti con le credenziali di produzione (Live)
Prossimi passi
- Connetti Stripe per gli incassi con carta
- Connetti GoCardless per gli addebiti diretti SEPA
- Automatizza i flussi con n8n