Aller au contenu principal

GoCardless

Disponible

Cette intégration est active et prête à être utilisée dans Frihet.

Connectez GoCardless à Frihet pour gérer les prélèvements SEPA. Consultez les mandats, les paiements et les clients directement depuis votre ERP. Idéal pour les abonnements et les encaissements récurrents avec des frais bas.

À quoi ça sert ?​

Avec GoCardless intégré :

  • Importer des paiements — Importez les encaissements de GoCardless en tant que factures dans Frihet en un clic
  • Déduplication automatique — Les paiements déjà importés ne sont pas dupliqués (préfixe GC-)
  • Afficher les paiements — Consultez tous vos prélèvements depuis Frihet
  • Gérer les clients — Accédez aux informations des clients avec des mandats actifs
  • Consulter les mandats — Visualisez l'état de chaque mandat SEPA (actif, en attente, annulé)
  • Réconcilier les encaissements — Associez les paiements GoCardless aux factures dans Frihet
  • Mode sandbox — Testez l'intégration avec des données fictives

Prérequis​

  • Compte GoCardless actif — gocardless.com
  • Clé API (Access Token) — Il est généré depuis le dashboard
  • Frihet Pro ou supérieur

Connecter GoCardless à Frihet​

Étape 1 : Obtenir votre clé API (Access Token)​

  1. Allez sur manage.gocardless.com (ou manage-sandbox.gocardless.com pour les tests)
  2. Connectez-vous à votre compte
  3. Allez dans Developers dans le menu latéral
  4. Cliquez sur Create → Access Token
  5. Sélectionnez le scope Read-only (suffisant pour consulter les données) ou Read-write si vous avez besoin de gérer les encaissements
  6. Donnez-lui un nom (ex: "Frihet ERP")
  7. Copiez le token généré
Gardez le token

La clé API (Access Token) n'est affiché qu'une seule fois lors de sa création. Copiez-le avant de fermer la fenêtre.

Étape 2 : Configurer dans Frihet​

  1. Allez dans Paramètres → Intégrations
  2. Recherchez GoCardless
  3. Cliquez sur Connecter
  4. Collez votre Clé API (Access Token)
  5. Sélectionnez l'environnement :
    • Live — Pour les données réelles
    • Sandbox — Pour les tests
  6. Cliquez sur Vérifier la connexion

Étape 3 : Vérifier la connexion​

Si la connexion est correcte, Frihet affichera :

  • Nom de votre organisation GoCardless
  • Nombre de mandats actifs
  • Nombre de clients enregistrés

Comment ça fonctionne​

Frihet se connecte à l'API v2 de GoCardless (version 2015-07-06) en utilisant l'authentification Bearer :

  1. Vous fournissez votre clé API (Access Token)
  2. Frihet envoie le token dans l'en-tête Authorization: Bearer <token> de chaque requête
  3. Les données de paiements, clients et mandats sont consultées à la demande
  4. Le token est stocké crypté (AES-256-GCM) dans Frihet
  5. Toute la communication s'effectue sur HTTPS

Données synchronisées​

DonnéeDirectionFréquence
Paiements (encaissements)GoCardless → FrihetÀ la demande
ClientsGoCardless → FrihetÀ la demande
Mandats SEPAGoCardless → FrihetÀ la demande
Statut des paiementsGoCardless → FrihetÀ la demande

Cas d'utilisation​

Cabinet de conseil avec cotisations mensuelles​

Vous percevez une cotisation mensuelle auprès de vos clients par prélèvement bancaire. Depuis Frihet, vous pouvez voir quels paiements ont été encaissés correctement, lesquels sont en attente et lesquels ont échoué, sans quitter votre ERP.

SaaS avec abonnements SEPA​

Vos clients européens préfèrent payer par prélèvement plutôt que par carte. GoCardless gère les encaissements récurrents et Frihet vous affiche l'état de chaque paiement ainsi que les factures émises.

Vérifier les mandats avant de facturer​

Avant d'émettre une facture récurrente, vérifiez depuis Frihet si le mandat du client est toujours actif. Évitez de facturer les clients dont le mandat a expiré ou a été annulé.

Importer les paiements dans Frihet​

Vous pouvez importer les paiements de GoCardless comme factures dans Frihet :

  1. Allez dans Paramètres → Intégrations → GoCardless
  2. Dans l'onglet Données, cliquez sur Importer les paiements
  3. Frihet téléchargera tous les paiements et créera des factures pour chacun
  4. Les paiements déjà importés précédemment sont automatiquement ignorés (déduplication par GC-{id})
  5. Une fois terminé, vous verrez le nombre exact de paiements importés

Les paiements importés incluent : montant, devise, date, référence et statut.

Mode Sandbox​

GoCardless offre un environnement sandbox complètement séparé :

  1. Inscrivez-vous sur manage-sandbox.gocardless.com
  2. Créez une clé API (Access Token) dans l'environnement sandbox
  3. Configurez Frihet en mode "Sandbox"
  4. Créez des mandats et des paiements de test depuis le dashboard sandbox
  5. Vérifiez que les données apparaissent correctement dans Frihet

Statuts de paiement dans GoCardless​

Statut GoCardlessSignification
pending_submissionPaiement créé, en attente d'envoi à la banque
submittedEnvoyé à la banque, en cours de traitement
confirmedEncaissement effectué avec succès
paid_outFonds transférés sur votre compte
failedL'encaissement a échoué (fonds insuffisants, mandat annulé, etc.)
cancelledAnnulé avant traitement

Dépannage​

"Erreur d'authentification"​

  • Vérifiez que la clé API (Access Token) est correcte et n'a pas expiré
  • Assurez-vous d'utiliser un token Live en mode Live et Sandbox en mode Sandbox
  • Si vous avez régénéré le token dans GoCardless, mettez-le à jour dans Frihet

"Je ne vois pas mes paiements"​

  • Vérifiez que vous avez des paiements enregistrés dans votre compte GoCardless
  • Vérifiez que le token a les permissions de lecture
  • En sandbox, créez d'abord des paiements de test

"Erreur de version d'API"​

  • Frihet utilise la version d'API 2015-07-06 de GoCardless, qui est stable et compatible
  • Si GoCardless notifie des changements d'API, nous mettrons à jour l'intégration

"Je veux me déconnecter"​

  1. Allez dans Paramètres → Intégrations → GoCardless
  2. Cliquez sur Déconnecter
  3. Optionnellement, révoquez la clé API (Access Token) depuis le dashboard GoCardless

Prochaines étapes​