Anleitung 2 von 3
Eigenes Stripe-Konto mit SmartEinzug verbinden
SmartEinzug führt keine Zahlungen selbst aus. Die Lastschriften laufen über Ihr eigenes Stripe-Konto, das Sie mit einem Schlüssel verbinden. Ein Webhook meldet den Status jeder Lastschrift zurück. Diese Anleitung beschreibt beide Teile.
Voraussetzung ist ein eigenes Stripe-Konto, in dem SEPA-Lastschrift als Zahlungsmethode freigeschaltet ist. Hinterlegen dürfen Inhaber und Administratoren. Bezeichnungen im Stripe-Dashboard können sich ändern.
Teil 1
Schlüssel erzeugen und in SmartEinzug hinterlegen
- 1
Test- oder Livemodus festlegen
Stripe unterscheidet Test- und Livemodus mit jeweils eigenen Schlüsseln. Zum Ausprobieren eignet sich ein Testschlüssel (beginnt mit sk_test_), echte Lastschriften bei Ihren Kunden erfordern einen Liveschlüssel (sk_live_). SmartEinzug erkennt den Modus am Schlüssel und zeigt ihn in den Einstellungen an.
- 2
Schlüssel im Stripe-Dashboard anlegen
Öffnen Sie im Stripe-Dashboard den Bereich Entwickler und dort API-Schlüssel. Sie können den Secret Key verwenden oder unter den eingeschränkten Schlüsseln einen Schlüssel (beginnt mit rk_) anlegen, der nur die benötigten Rechte trägt; welche das sind, nennt die Einrichtungshilfe im Bereich Stripe der Einstellungen. Veröffentlichbare Schlüssel (pk_) akzeptiert SmartEinzug nicht.
- 3
Schlüssel kopieren
Stripe zeigt Secret Keys nur einmal vollständig an. Kopieren Sie den Schlüssel unmittelbar nach dem Erstellen. Geben Sie ihn nicht weiter und versenden Sie ihn nicht per E-Mail.
- 4
In SmartEinzug eintragen
Öffnen Sie in SmartEinzug über das Profilmenü die Einstellungen, Bereich Stripe. Fügen Sie den Schlüssel in das Feld Stripe Secret Key oder Restricted Key ein und wählen Sie Verbindung herstellen. Das Feld Stripe Webhook-Secret dürfen Sie zunächst leer lassen; es wird im zweiten Teil nachgetragen.
- 5
Ergebnis prüfen
SmartEinzug ruft mit dem Schlüssel die Kontodaten bei Stripe ab, bevor es ihn speichert. Danach zeigt der Bereich Verbunden mit Business Name, Konto-ID, Modus und Zeitpunkt der letzten Prüfung. Im Testmodus erscheint der Hinweis, dass keine echten Lastschriften ausgeführt werden. Der Schlüssel wird verschlüsselt gespeichert und nicht mehr angezeigt; mit Verbindung prüfen wiederholen Sie den Test.
Teil 2
Webhook einrichten, damit Stripe den Status zurückmeldet
- 6
Endpunkt in Stripe anlegen
Wählen Sie im Stripe-Dashboard unter Entwickler, Webhooks den Punkt Endpunkt hinzufügen. Der Modus des Dashboards (Test oder Live) muss zu dem Schlüssel passen, den Sie in SmartEinzug hinterlegt haben. Test- und Livemodus brauchen jeweils einen eigenen Endpunkt mit eigenem Secret.
- 7
Endpunkt-URL eintragen
Tragen Sie als Endpunkt-URL genau die Adresse ein, die SmartEinzug im Bereich Stripe der Einstellungen anzeigt: https://app.smart-einzug.de/stripe-webhook.php. Der Endpunkt gilt für alle Firmenaccounts; SmartEinzug ordnet jede Meldung anhand ihrer Kennungen dem richtigen Firmenaccount zu und prüft sie mit dessen Secret.
- 8
Genau sieben Ereignisse auswählen
Wählen Sie unter den Ereignissen ausschließlich die sieben im nächsten Abschnitt aufgeführten Typen. Wählen Sie nicht alle Ereignisse: SmartEinzug verwirft jeden anderen Typ, Stripe würde ihn dennoch bei jeder Kontobewegung senden.
- 9
Signing Secret kopieren
Nach dem Anlegen zeigt Stripe auf der Detailseite des Endpunkts das Signing Secret an; es beginnt mit whsec_. Lassen Sie es anzeigen und kopieren Sie es.
- 10
Secret in SmartEinzug speichern
Tragen Sie das Secret im Bereich Stripe der Einstellungen in das Feld für das Webhook-Secret ein und wählen Sie Webhook-Secret speichern. Es wird verschlüsselt abgelegt und dient ausschließlich der Prüfung, dass eine Meldung tatsächlich von Stripe stammt. Der Vermerk wechselt auf hinterlegt.
- 11
Zustellung testen
Wählen Sie in Stripe auf der Seite des Endpunkts Testereignis senden. Der Endpunkt antwortet mit Status 200. Meldungen ohne gültige Signatur verwirft SmartEinzug; ein Testereignis ohne Bezug zu einem Einzug ändert deshalb keine Daten.
Ereignisse
Die sieben Ereignisse und ihre Wirkung in SmartEinzug
payment_intent.processing
Die Lastschrift ist bei Stripe eingereicht. Der Einzug steht auf In Bearbeitung, die Rechnung auf Im Einzug.
payment_intent.succeeded
Die Lastschrift war erfolgreich. Der Einzug wird Erfolgreich, die Rechnung Eingezogen; die von Stripe vergebene Mandatsreferenz wird gespeichert.
payment_intent.payment_failed
Die Lastschrift ist gescheitert. Der Einzug wird Fehlgeschlagen und der von Stripe übermittelte Grund am Einzug vermerkt. Ein erneuter Einzug erfolgt nur manuell.
charge.dispute.created
Rücklastschrift oder Widerspruch des Zahlers. Der Einzug wird als Rücklastschrift markiert, die Rechnung als Fehlgeschlagen; der Vorgang wird protokolliert.
charge.refunded
Eine in Stripe ausgeführte Erstattung. Der erstattete Betrag wird am Einzug vermerkt, die Rechnung erhält Klärungsbedarf und wird nicht automatisch erneut eingezogen.
charge.refund.updated
Ein geänderter Erstattungsstand, etwa eine Teilerstattung oder deren Rücknahme. SmartEinzug führt den Stand am Einzug nach.
checkout.session.completed
Rückmeldung zu Stripe-Checkout-Vorgängen. SmartEinzug nimmt das Ereignis entgegen, damit der Endpunkt vollständig eingerichtet ist; andere Vorgänge bleiben unberührt.
Ohne Webhook
Was ohne eingerichteten Webhook nicht erkannt wird
- Erfolg und Fehlschlag einer Lastschrift erfährt SmartEinzug ohne Webhook nur über Status mit Stripe abgleichen auf der Seite Einzüge oder über den serverseitigen Abgleich. Die Rückmeldung kommt dann später.
- Rücklastschriften und Erstattungen werden ohne Webhook nicht erkannt. Eine zurückgegebene Lastschrift bliebe in SmartEinzug als erfolgreich stehen, die Rechnung als eingezogen.
- Hinweise: Fehlt das Webhook-Secret, zeigt das Dashboard einen Hinweis und der Bereich Stripe in den Einstellungen den Vermerk fehlt.
- Signaturprüfung: Ohne hinterlegtes Secret verwirft SmartEinzug jede Meldung, auch echte. Ein falsches Secret wirkt genauso.
Wechsel des Schlüssels oder des Kontos. Wenn Sie vom Test- in den Livemodus wechseln oder ein anderes Stripe-Konto verbinden, legen Sie den Webhook im neuen Modus beziehungsweise Konto erneut an und tragen das neue Secret in SmartEinzug ein. Über Webhook-Secret ändern ersetzen Sie ein hinterlegtes Secret, ohne die Verbindung zu trennen.
Fragen
Häufige Fragen zur Stripe-Verbindung
Wie komme ich vom Testmodus in den Livemodus?
Trennen Sie die Verbindung im Bereich Stripe der Einstellungen und hinterlegen Sie den Liveschlüssel. Das Trennen löscht Schlüssel und Webhook-Secret in SmartEinzug; vorhandene Einzüge und Mandate bleiben erhalten. Legen Sie anschließend den Webhook im Livemodus an und speichern Sie das neue Secret.
Hält SmartEinzug Geld oder rechnet es Zahlungen ab?
Nein. Es gibt kein Zwischenkonto und keine Plattform-Verrechnung. Stripe zieht über Ihr Konto ein und zahlt an Ihr Geschäftskonto aus; die Gebühren Ihres Stripe-Kontos rechnet Stripe direkt mit Ihnen ab.
Was passiert beim Trennen der Verbindung?
Schlüssel und Webhook-Secret werden in SmartEinzug gelöscht. Einzüge und Mandate bleiben erhalten, neue Einzüge sind bis zur erneuten Verbindung nicht möglich. Bereits eingereichte Lastschriften laufen bei Stripe weiter.
Kann ich Lastschriften übernehmen, die schon über Stripe liefen?
Ja, einmalig über Bestehende Einzüge aus Stripe übernehmen im Bereich Stripe der Einstellungen. Der Import liest nur, ordnet über Rechnungsnummer und Betrag zu und übernimmt eindeutige Treffer als Einzüge. Mandate und IBANs werden dabei nicht übernommen. Erlaubt für Inhaber und Administratoren mit Zweitbestätigung per Authenticator-Code.
Gilt die Stripe-Verbindung für alle meine Firmenaccounts?
Nein. Jeder Firmenaccount verbindet sein eigenes Stripe-Konto und richtet den Webhook mit eigenem Secret ein. Die Endpunkt-URL ist dieselbe, die Zuordnung erfolgt je Meldung.
Wer darf die Stripe-Verbindung ändern?
Inhaber und Administratoren. Jedes Hinterlegen, Prüfen, Ändern des Secrets und Trennen wird mit Person und Zeitpunkt protokolliert. Im Support-Modus des Betreibers sind diese Aktionen gesperrt.
Nächster Schritt
Weiter mit Anleitung 3: der erste Lastschrifteinzug
Zurück zu Anleitung 1, zur Übersicht der Anleitungen oder zur Hilfe.