PayPal
Cette intégration est active et prête à l'emploi dans Frihet.
Connectez votre compte PayPal Business à Frihet. Importez les transactions, consultez les soldes et réconciliez les encaissements internationaux avec vos factures automatiquement. Supporte le mode sandbox pour les tests.
À quoi ça sert ?
Avec PayPal intégré :
- Importer les transactions — Importe automatiquement les encaissements PayPal dans Frihet comme des factures
- Pagination complète — Importe toutes les transactions sans limite (pagination automatique)
- Historique intelligent — Première importation : 1 an d'historique. Ensuite : seulement les nouvelles transactions depuis la dernière synchronisation
- Remboursements — Les refunds sont importés avec le préfixe
[Refund]et un montant négatif pour une comptabilité claire - Consulter les soldes — Visualisez votre solde PayPal directement depuis le tableau de bord de Frihet
- Réconcilier les encaissements — Associe les transactions PayPal avec les factures existantes
- Multi-devise — Gère les encaissements en EUR, USD, GBP et autres devises
- Déduplication — Les transactions déjà importées ne sont pas dupliquées (préfixe
PP-) - Mode sandbox — Testez l'intégration sans affecter les données réelles
Prérequis
- Compte PayPal Business — Les comptes personnels n'ont pas accès à l'API
- Application sur PayPal Developer — Pour obtenir le Client ID et le Client Secret
- Frihet Pro ou supérieur
Connecter PayPal à Frihet
Étape 1 : Créer une application sur PayPal Developer
- Accédez à developer.paypal.com
- Connectez-vous avec votre compte PayPal Business
- Dans le tableau de bord, allez dans Apps & Credentials
- Sélectionnez le mode Live (ou Sandbox pour les tests)
- Cliquez sur Create App
- Donnez-lui un nom (ex : "Frihet ERP")
- Cliquez sur Create App
Une fois créée, vous verrez :
- Client ID — Un identifiant public (ex :
AaBbCcDdEe...) - Client Secret — Une clé privée (cliquez sur "Show" pour la voir)
Le Client Secret n'est affiché qu'une seule fois. Copiez-le et enregistrez-le dans un endroit sûr avant de continuer.
Étape 2 : Configurer dans Frihet
- Allez dans Paramètres → Intégrations
- Recherchez PayPal
- Cliquez sur Connecter
- Saisissez votre Client ID et Client Secret
- Sélectionnez le mode :
- Live — Pour les transactions réelles
- Sandbox — Pour les tests avec des données fictives
- Cliquez sur Vérifier la connexion
- Si c'est correct, vous verrez "Connecté"
Étape 3 : Vérifier la connexion
- Frihet obtient automatiquement un jeton OAuth2 en utilisant vos identifiants
- Si la vérification est réussie, vous verrez votre solde PayPal dans le tableau de bord
- Vous pouvez effectuer une importation de test avec les dernières transactions
Comment ça fonctionne
Frihet utilise l'API REST v2 de PayPal avec l'authentification OAuth2 (flux d'identifiants client) :
- Vous fournissez le Client ID et le Client Secret
- Frihet demande automatiquement un jeton d'accès à PayPal
- Avec ce jeton, Frihet consulte les transactions et les soldes
- Les identifiants sont stockés chiffrés (AES-256-GCM) dans Frihet
- Le jeton est renouvelé automatiquement lorsqu'il expire
À aucun moment vous n'avez besoin de gérer les jetons manuellement.
Données synchronisées
| Donnée | Direction | Fréquence |
|---|---|---|
| Transactions reçues | PayPal → Frihet | À la demande / périodique |
| Solde du compte | PayPal → Frihet | À chaque consultation |
| Données du payeur | PayPal → Frihet | Avec chaque transaction |
| Devise et taux de change | PayPal → Frihet | Avec chaque transaction |
Cas d'utilisation
Freelancer avec des clients internationaux
Vous encaissez des clients en USD et EUR via PayPal. Frihet importe chaque paiement, l'associe à la facture correspondante et convertit le montant dans votre devise de base.
Boutique en ligne avec PayPal comme méthode de paiement
Vous recevez des paiements de clients via PayPal Checkout. Les transactions sont importées dans Frihet et vous pouvez les réconcilier avec les commandes facturées.
Vérifier le solde avant de payer les fournisseurs
Consultez votre solde PayPal depuis le tableau de bord de Frihet sans quitter l'application. Décidez si vous disposez de fonds suffisants avant d'émettre des transferts.
Mode Sandbox
Pour tester l'intégration sans affecter les données réelles :
- Sur developer.paypal.com, créez une application en mode Sandbox
- Utilisez les identifiants Sandbox dans Frihet (sélectionnez le mode "Sandbox")
- PayPal fournit des comptes de test avec un solde fictif
- Vérifiez que les transactions sont importées correctement
- Lorsque vous êtes prêt, passez en mode Live avec les identifiants de production
Dépannage
"Erreur d'authentification"
- Vérifiez que le Client ID et le Client Secret sont corrects
- Assurez-vous d'utiliser les identifiants Live en mode Live et Sandbox en mode Sandbox
- Vérifiez que votre compte PayPal Business est actif et vérifié
"Les transactions ne sont pas importées"
- Vérifiez qu'il y a des transactions dans la période consultée (1 an lors de la première importation, depuis la dernière synchronisation pour les suivantes)
- En mode Sandbox, générez des transactions de test depuis le tableau de bord de PayPal Developer
- Vérifiez que votre application sur PayPal a les permissions nécessaires activées
- Si le toast affiche "No new transactions to import", toutes les transactions sont déjà dans Frihet
"Erreur de permissions sur l'API"
- Lors de la création de l'application sur PayPal Developer, assurez-vous qu'elle inclut le scope des transactions
- Si vous avez modifié les permissions, générez un nouveau Client Secret et mettez-le à jour dans Frihet
"Je souhaite passer de Sandbox à Live"
- Allez dans Paramètres → Intégrations → PayPal
- Cliquez sur Déconnecter
- Reconnectez-vous avec les identifiants de production (Live)