Zum Hauptinhalt springen

GoCardless

Verfügbar

Diese Integration ist in Frihet aktiv und einsatzbereit.

Verbinden Sie GoCardless mit Frihet, um SEPA-Lastschriftzahlungen zu verwalten. Rufen Sie Mandate, Zahlungen und Kunden direkt aus Ihrem ERP ab. Ideal für Abonnements und wiederkehrende Zahlungen mit niedrigen Gebühren.

Wozu dient es?​

Mit integriertem GoCardless:

  • Zahlungen importieren — Importieren Sie GoCardless-Zahlungen als Rechnungen in Frihet mit einem Klick
  • Automatische Deduplizierung — Bereits importierte Zahlungen werden nicht dupliziert (Präfix GC-)
  • Zahlungen anzeigen — Sehen Sie alle Ihre Lastschriften von GoCardless in Frihet ein
  • Kunden verwalten — Greifen Sie auf Kundeninformationen mit aktiven Mandaten zu
  • Mandate einsehen — Sehen Sie den Status jedes SEPA-Mandats ein (aktiv, ausstehend, storniert)
  • Zahlungen abgleichen — Verknüpfen Sie GoCardless-Zahlungen mit Rechnungen in Frihet
  • Sandbox-Modus — Testen Sie die Integration mit fiktiven Daten

Voraussetzungen​

  • Aktives GoCardless-Konto — gocardless.com
  • API-Access Token — Wird über das Dashboard generiert
  • Frihet Pro oder höher

GoCardless mit Frihet verbinden​

Schritt 1: Ihren Access Token erhalten​

  1. Gehen Sie zu manage.gocardless.com (oder manage-sandbox.gocardless.com für Tests)
  2. Melden Sie sich bei Ihrem Konto an
  3. Gehen Sie im Seitenmenü zu Developers
  4. Klicken Sie auf Create → Access Token
  5. Wählen Sie den Scope Read-only (ausreichend zum Abfragen von Daten) oder Read-write, wenn Sie Zahlungen verwalten müssen
  6. Geben Sie ihm einen Namen (z.B.: "Frihet ERP")
  7. Kopieren Sie den generierten Token
Token speichern

Der Access Token wird nur einmal bei der Erstellung angezeigt. Kopieren Sie ihn, bevor Sie das Fenster schließen.

Schritt 2: In Frihet konfigurieren​

  1. Gehen Sie zu Einstellungen → Integrationen
  2. Suchen Sie nach GoCardless
  3. Klicken Sie auf Verbinden
  4. Fügen Sie Ihren Access Token ein
  5. Wählen Sie die Umgebung aus:
    • Live — Für reale Daten
    • Sandbox — Für Tests
  6. Klicken Sie auf Verbindung überprüfen

Schritt 3: Verbindung überprüfen​

Wenn die Verbindung korrekt ist, zeigt Frihet an:

  • Name Ihrer Organisation in GoCardless
  • Anzahl aktiver Mandate
  • Anzahl registrierter Kunden

Funktionsweise​

Frihet stellt eine Verbindung zur GoCardless API v2 (Version 2015-07-06) her mittels Bearer-Authentifizierung:

  1. Sie stellen Ihren Access Token bereit
  2. Frihet sendet den Token im Header Authorization: Bearer <token> jeder Anfrage
  3. Die Daten zu Zahlungen, Kunden und Mandaten werden bei Bedarf abgefragt
  4. Der Token wird verschlüsselt (AES-256-GCM) in Frihet gespeichert
  5. Die gesamte Kommunikation erfolgt über HTTPS

Synchronisierte Daten​

DatenRichtungFrequenz
Zahlungen (Lastschriften)GoCardless → FrihetBei Bedarf
KundenGoCardless → FrihetBei Bedarf
SEPA-MandateGoCardless → FrihetBei Bedarf
ZahlungsstatusGoCardless → FrihetBei Bedarf

Anwendungsfälle​

Beratung mit monatlichen Gebühren​

Sie ziehen monatliche Gebühren von Ihren Kunden per Lastschrift ein. Von Frihet aus können Sie sehen, welche Zahlungen erfolgreich eingezogen wurden, welche ausstehend sind und welche fehlgeschlagen sind, ohne Ihr ERP zu verlassen.

SaaS mit SEPA-Abonnements​

Ihre europäischen Kunden bevorzugen die Zahlung per Lastschrift statt per Karte. GoCardless verwaltet die wiederkehrenden Zahlungen und Frihet zeigt Ihnen den Status jeder Zahlung zusammen mit den ausgestellten Rechnungen.

Mandate vor der Rechnungsstellung überprüfen​

Bevor Sie eine wiederkehrende Rechnung ausstellen, prüfen Sie in Frihet, ob das Kundenmandat noch aktiv ist. Vermeiden Sie es, Kunden in Rechnung zu stellen, deren Mandat abgelaufen oder storniert wurde.

Zahlungen nach Frihet importieren​

Sie können GoCardless-Zahlungen als Rechnungen in Frihet importieren:

  1. Gehen Sie zu Einstellungen → Integrationen → GoCardless
  2. Klicken Sie auf der Registerkarte Daten auf Zahlungen importieren
  3. Frihet lädt alle Zahlungen herunter und erstellt für jede eine Rechnung
  4. Bereits zuvor importierte Zahllungen werden automatisch übersprungen (Deduplizierung nach GC-{id})
  5. Nach Abschluss sehen Sie die genaue Anzahl der importierten Zahlungen

Die importierten Zahlungen umfassen: Betrag, Währung, Datum, Referenz und Status.

Sandbox-Modus​

GoCardless bietet eine komplett separate Sandbox-Umgebung:

  1. Registrieren Sie sich unter manage-sandbox.gocardless.com
  2. Erstellen Sie einen Access Token in der Sandbox-Umgebung
  3. Konfigurieren Sie Frihet im "Sandbox"-Modus
  4. Erstellen Sie Testmandate und -zahlungen über das Sandbox-Dashboard
  5. Überprüfen Sie, ob die Daten korrekt in Frihet angezeigt werden

Zahlungsstatus in GoCardless​

GoCardless StatusBedeutung
pending_submissionZahlung erstellt, wartet auf Übermittlung an die Bank
submittedAn die Bank übermittelt, in Bearbeitung
confirmedEinzug erfolgreich durchgeführt
paid_outGelder auf Ihr Konto überwiesen
failedDer Einzug ist fehlgeschlagen (ungenügende Deckung, Mandat storniert, etc.)
cancelledVor der Verarbeitung storniert

Fehlerbehebung​

"Authentifizierungsfehler"​

  • Überprüfen Sie, ob der Access Token korrekt und nicht abgelaufen ist
  • Stellen Sie sicher, dass Sie einen Live-Token im Live-Modus und einen Sandbox-Token im Sandbox-Modus verwenden
  • Wenn Sie den Token in GoCardless neu generiert haben, aktualisieren Sie ihn in Frihet

"Ich sehe meine Zahlungen nicht"​

  • Überprüfen Sie, ob in Ihrem GoCardless-Konto Zahlungen registriert sind
  • Überprüfen Sie, ob der Token Leseberechtigungen hat
  • Erstellen Sie im Sandbox-Modus zuerst Testzahlungen

"API-Versionsfehler"​

  • Frihet verwendet die GoCardless API-Version 2015-07-06, die stabil und kompatibel ist
  • Wenn GoCardless API-Änderungen ankündigt, werden wir die Integration aktualisieren

"Ich möchte die Verbindung trennen"​

  1. Gehen Sie zu Einstellungen → Integrationen → GoCardless
  2. Klicken Sie auf Verbindung trennen
  3. Optional widerrufen Sie den Access Token über das GoCardless-Dashboard

Nächste Schritte​