Dauer: ungefähr 5 Minuten

GoCardless Access Token für SepaPilot erstellen

SepaPilot benötigt einen read-write Access Token, um Mandate zu lesen, Zahlungen zu erstellen und Zahlungsstatus abzugleichen.

Zuerst Live oder Sandbox wählen

GoCardless trennt Test- und Echtdaten. Ein Sandbox-Token beginnt typischerweise mit sandbox_, ein Live-Token mit live_. SepaPilot erkennt die Umgebung am Token. Verwenden Sie für Tests ausschließlich Sandbox und für echte Kundeneinzüge ausschließlich das Live-Konto.

Nicht mischen: Sandbox-Mandate existieren nicht im Live-System. Ein Token der falschen Umgebung kann deshalb zwar formal aussehen, aber keine passenden echten Mandate liefern.

Token Schritt für Schritt erstellen

  1. Melden Sie sich im gewünschten GoCardless-Umfeld an.
  2. Öffnen Sie Entwickler → Access Tokens oder verwenden Sie den Direktlink oben.
  3. Klicken Sie auf Erstellen.
  4. Vergeben Sie den Namen SepaPilot, damit der Zweck später eindeutig bleibt.
  5. Wählen Sie read-write. Nur lesender Zugriff reicht nicht, weil SepaPilot im Livebetrieb Zahlungen anlegen muss.
  6. Erstellen Sie den Token und kopieren Sie den vollständigen Wert sofort.
  7. Öffnen Sie SepaPilot unter Einrichtung → GoCardless, fügen Sie den Token ein und klicken Sie auf Prüfen & speichern.

Wie SepaPilot die Verbindung prüft

Der Token wird vom Server gegen die GoCardless-API getestet. Der Status wird nur dann grün, wenn GoCardless den Zugriff bestätigt. SepaPilot zeigt außerdem die erkannte Umgebung an, damit ein Sandbox-Token nicht unbemerkt als Live-Verbindung behandelt wird.

Nach dem Speichern wird der vollständige Token nicht wieder an den Browser geliefert. Angezeigt werden nur ein maskierter Hinweis und höchstens die letzten drei Zeichen zur Identifikation.

Token ersetzen oder widerrufen

Erstellen Sie zuerst einen neuen Token, speichern und prüfen Sie ihn in SepaPilot und widerrufen Sie anschließend den alten Token in GoCardless. Wenn Sie den alten Token zuerst löschen, pausiert die Verbindung bis zur erfolgreichen Ersetzung.

Danach: persönlichen Webhook einrichten

Nach erfolgreicher Token-Prüfung erzeugt SepaPilot Ihre persönliche Webhook-URL. Ohne Webhook kann SepaPilot Statusänderungen nicht zuverlässig und zeitnah verarbeiten. Fahren Sie deshalb direkt mit der Anleitung GoCardless Webhook einrichten fort.

Die Übersicht aller Entwicklerfunktionen finden Sie unter manage.gocardless.com/developers ↗. Öffentliche technische Grundlagen beschreibt die GoCardless Developer Documentation ↗.

Token jetzt serverseitig prüfen

SepaPilot speichert den vollständigen Wert nicht im Frontend und zeigt ihn nach dem Speichern nicht erneut an.

Kostenloses Testkonto erstellen

Ohne Zahlungsdaten und ohne automatischen Abo-Start. Bereits registriert? Anmelden und Einrichtung fortsetzen →