Stripe - SEPA Direct Debit (Lastschrift) integrieren
Mit Stripe SEPA Direct Debit können geeignete EUR-Zahlungen per Lastschrift verarbeitet werden. Im Gegensatz zur Karte kann eine Lastschrift zunächst den Status processing besitzen und später erfolgreich sein oder fehlschlagen. Diese Verzögerung muss zu Platzreservation, MustPay und interner Kontrolle passen.
Voraussetzungen
Stripe ist über Stripe Connect verbunden und aktiv.
Das Angebot verwendet EUR; die aktuelle PaymentIntent-Logik schliesst SEPA bei anderen Währungen aus.
SEPA Direct Debit ist im Stripe-Konto für Ihre Organisation und Transaktion verfügbar.
Mandat, Zahlungsfrist, Rücklastschrift und Kommunikation sind intern geklärt.
Prüfen Sie im Stripe Dashboard, ob SEPA Direct Debit für Ihr Konto verfügbar ist. Massgebend ist der aktuelle Status Ihres Stripe-Kontos; leiten Sie die Freigabe nicht allein aus der Anzahl bisheriger Kartenzahlungen oder einer angenommenen Wartefrist ab.
SEPA in Stripe V3 aktivieren
Bei Stripe V3 gibt es in edoobox keinen eigenen Schalter SEPA Lastschrift freigeben. V3 aktiviert automatische Payment Methods; Stripe entscheidet bei einer EUR-Transaktion, ob SEPA angeboten werden darf. Aktivieren Sie die Methode im Stripe Dashboard und prüfen Sie anschliessend ein echtes internes EUR-Angebot.
Der separate SEPA-Schalter bleibt nur in der älteren Stripe-Ansicht sichtbar. Für den Wechsel auf V3 folgen Sie Stripe – Kreditkarten integrieren und prüfen danach die angebotenen Zahlungsarten im Buchungsprozess.
processing, succeeded und payment_failed
Die edoobox Webhook-Verarbeitung verfolgt für Teilnehmendenzahlungen insbesondere:
| Stripe-Ereignis | Bedeutung für den Prozess |
|---|---|
payment_intent.processing | Die Zahlung wird verarbeitet; ein endgültiger Erfolg steht normalerweise noch aus. |
payment_intent.succeeded | Stripe bestätigt den Erfolg; edoobox kann die Zahlung definitiv verbuchen. |
payment_intent.payment_failed | Die Zahlung ist fehlgeschlagen und muss im Buchungsprozess nachbearbeitet werden. |
Option „SEPA ohne Validierung als bezahlt markieren“
Ist diese Option aktiv, darf edoobox eine Stripe-SEPA-Zahlung bereits bei processing buchen, ohne auf den Success-Webhook zu warten. Die Logik prüft dabei, dass die Methode tatsächlich sepa_debit ist; Karten werden dadurch nicht vorzeitig als bezahlt markiert.
Erhöhtes Ausfallrisiko: processing ist kein endgültiger Zahlungserfolg. Die Lastschrift kann später fehlschlagen oder zurückgegeben werden, obwohl die Buchung bereits als bezahlt behandelt wurde. Aktivieren Sie diese Option nur mit einem dokumentierten Kontrollprozess für spätere Fehler und Rücklastschriften.
Für knappe Plätze oder sofort ausgelöste Leistungen ist die Option besonders sorgfältig zu beurteilen. Der sichere Standard ist, auf succeeded zu warten.
Mandat und Kommunikation
Stripe erfasst die für SEPA benötigte Zustimmung im Zahlungsablauf. Ihre eigenen Buchungs- und Rechtstexte sollten verständlich erklären, dass eine Lastschrift zeitversetzt verarbeitet werden kann und wie bei Fehlschlag oder Rücklastschrift vorgegangen wird.
Prüfen Sie MustPay und Countdown, Buchungsbestätigung sowie Freigabe von Unterlagen oder Zugangsdaten. Ein processing-Status darf nicht unbemerkt Leistungen auslösen, die Sie erst nach endgültigem Zahlungseingang freigeben möchten.
Rückerstattung und Rücklastschrift unterscheiden
Eine von Ihnen ausgelöste Rückerstattung und eine vom Bankprozess zurückgegebene Lastschrift sind unterschiedliche Vorgänge. Die V2 kann eine noch rückerstattbare Stripe-Transaktion über den normalen Rückerstattungsprozess erstatten. Ein späterer Providerfehler oder eine Rücklastschrift muss dagegen anhand des Stripe-Status geprüft und in edoobox nachbearbeitet werden.
Testmatrix
EUR-Angebot mit sichtbarer SEPA-Methode und korrekt erfasstem Mandat.
Nicht-EUR-Angebot: SEPA wird nicht angeboten.
Standardweg:
processingwartet aufsucceeded.Optionaler Vorabweg: Buchung bei
processingund anschliessende Kontrolle eines Fehlschlags.MustPay-Abbruch sowie verspätetes Webhook-Ereignis.
Teilrückerstattung einer erfolgreich verbuchten SEPA-Zahlung.
Anwendungsbeispiel: Auf endgültigen Erfolg warten
Ein Veranstalter lässt die Voraboption deaktiviert. Eine SEPA-Zahlung bleibt während processing offen und wird erst bei succeeded definitiv verbucht. Zugangsdaten werden ebenfalls erst nach dem endgültigen Status versendet.
Anwendungsbeispiel: Platz wird bereits bei processing bestätigt
Eine Organisation reserviert bei langjährigen Mitgliedern den Platz sofort und aktiviert die Voraboption. Ein täglicher Kontrollprozess sucht spätere payment_failed-Fälle und Rücklastschriften. Der mögliche Ausfall ist bewusst akzeptiert und dokumentiert.
Anwendungsbeispiel: Nicht-EUR-Angebot
Ein CHF-Angebot zeigt trotz aktiviertem SEPA im Stripe-Konto keine Lastschrift. Das Team erkennt dies als erwartetes Verhalten der edoobox PaymentIntent-Konfiguration und bietet stattdessen Karte oder Rechnung an.
Aktuelle Verbindung und Zahlungszweck kontrollieren
Die Option SEPA ohne Validierung als bezahlt markieren ist ein vorgezogener Buchungsentscheid für eine einzelne Lastschrift im Zahlungsprozess. Sie richtet weder einen wiederkehrenden Einzug für Teilnehmenden-Abonnemente noch die Firmenkarten-Abrechnung Ihres edoobox-Kontos ein. Lesen Sie dafür Teilnehmenden-Abonnemente: Verlängerung und Kündigung beziehungsweise Automatische Zahlung mit hinterlegter Kreditkarte.
Vergleichen Sie bei jeder spät fehlgeschlagenen Lastschrift den Providerstatus mit der in edoobox bereits verbuchten Zahlung. Ein Gebührenexport richtet sich nach dem edoobox-Buchungsdatum und kann deshalb einen anderen Monatsbezug als die endgültige Bankabwicklung haben: Transaktionsgebühren als CSV exportieren.