Kurzantwort auf „Was kommt in URL?“: Kopieren Sie unter SepaPilot → Einrichtung → GoCardless → Webhook die vollständig angezeigte persönliche URL. Sie hat ungefähr das Format https://api.sepapilot.de/api/gocardless/webhook/IHR-PERSOENLICHER-SCHLUESSEL. Tippen oder verändern Sie die URL nicht von Hand.

Vorher den Access Token speichern

Die persönliche URL wird erst erzeugt, nachdem ein gültiger GoCardless Access Token erfolgreich geprüft und gespeichert wurde. So ist der Endpoint eindeutig Ihrem SepaPilot-Konto zugeordnet.

Webhook Schritt für Schritt erstellen

Öffnen Sie in SepaPilot Einrichtung → GoCardless → Webhook.
Klicken Sie auf Webhook-URL kopieren. Kopieren Sie die gesamte URL einschließlich des persönlichen Schlüssels am Ende.
Öffnen Sie GoCardless → Entwickler → Webhook-Endpunkte → Erstellen ↗.
Tragen Sie als Name SepaPilot ein.
Fügen Sie in das Feld URL die zuvor kopierte persönliche SepaPilot-URL ein.
Lassen Sie Ein Secret für mich generieren ausgewählt.
Aktivieren Sie das optionale Webhook-Client-Zertifikat nicht. SepaPilot authentifiziert Ereignisse über die Webhook-Signatur und das Secret.
Klicken Sie auf Erstellen und kopieren Sie das danach angezeigte Secret.
Fügen Sie in SepaPilot ausschließlich dieses Secret in Neues Webhook Secret eingeben ein und klicken Sie auf Webhook Secret speichern.

URL und Secret nicht verwechseln

Wert	Woher?	Wohin?
Persönliche Webhook-URL	SepaPilot-Konto	GoCardless-Feld „URL“
Webhook Secret	von GoCardless beim Erstellen	SepaPilot-Feld „Webhook Secret“

Die URL darf sichtbar kopiert werden, das Secret dagegen ist geheim. Senden Sie das Secret niemals per E-Mail oder Supportformular. SepaPilot zeigt nach dem Speichern nur einen maskierten Hinweis und höchstens die letzten Zeichen an.

Warum bleibt der Status zunächst gelb?

Ein gespeichertes Secret beweist noch nicht, dass GoCardless den Endpoint tatsächlich verwendet. SepaPilot markiert den Webhook deshalb erst dann als vollständig funktionsfähig, wenn das erste gültig signierte Ereignis eingegangen ist. Bis dahin bedeutet der Status sinngemäß „eingerichtet, Bestätigung ausstehend“.

Häufige Fehler

Die Website https://www.sepapilot.de statt der persönlichen API-URL eingetragen.
Nur https://api.sepapilot.de ohne vollständigen Pfad kopiert.
URL und Secret vertauscht.
Secret mit führendem oder nachgestelltem Leerzeichen eingefügt.
Live-Token verwendet, den Webhook aber in der Sandbox erstellt – oder umgekehrt.
Den Endpoint in GoCardless gelöscht, aber das alte Secret in SepaPilot stehen gelassen.

Offizielle Webhook-Grundlagen

GoCardless beschreibt Signaturen, Antwortcodes und Wiederholungen in der offiziellen Webhook-Dokumentation ↗. Eine Übersicht Ihrer Entwicklerkonfiguration finden Sie unter GoCardless Developers ↗.

Persönliche URL kopieren

Öffnen Sie die Einrichtung erst nach erfolgreicher Access-Token-Prüfung.

Kostenloses Testkonto erstellen

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