Stripe-Schnittstelle umstellen: Wechsel auf die neue Verbindung – BuchhaltungsButler

Was Sie lernen werden:

ob Sie Ihre Stripe-Verbindung umstellen müssen und bis wann
wie Sie Schritt für Schritt umstellen (mit Video)
wie Sie auf Wunsch einen eingeschränkten API-Schlüssel (Restricted Key) nutzen
was mit Ihren bisherigen Stripe-Umsätzen und Einstellungen passiert

Wir haben unsere Stripe-Schnittstelle auf eine neue Version umgestellt. Wenn Sie Ihr Stripe-Konto schon länger mit BuchhaltungsButler verbunden haben, läuft Ihre Verbindung noch über die alte Schnittstelle. Damit Ihre Stripe-Zahlungen weiterhin abgerufen werden, stellen Sie bitte bis zum 15.12.2026 auf die neue Verbindung um. Das dauert nur wenige Minuten.

Muss ich umstellen?

Sie müssen umstellen, wenn in BuchhaltungsButler ein Hinweis-Banner zur Umstellung der Stripe-Schnittstelle erscheint. Der Banner wird nur angezeigt, solange Ihr Stripe-Konto noch über die alte Schnittstelle verbunden ist. Über den Link im Banner gelangen Sie direkt zu den Einstellungen.

Haben Sie Stripe erst ab dem 02.11.2026 verbunden, nutzen Sie bereits die neue Verbindung. Dann sehen Sie den Hinweis nicht und müssen nichts tun.

Wichtig: Stellen Sie bis zum 15.12.2026 um. Danach schalten wir die alte Schnittstelle ab und es werden keine Stripe-Zahlungen mehr importiert. Sie müssten Ihre Stripe-Verbindung dann komplett neu einrichten. Mit der Umstellung geht es deutlich einfacher: Ihre Zugangsdaten werden übernommen und der Abruf läuft nahtlos dort weiter, wo die alte Verbindung aufgehört hat.

Schritt für Schritt umstellen

Klicken Sie im Hinweis-Banner auf den Link zu den Einstellungen. Alternativ öffnen Sie „Einstellungen“ → „Banken und Zahlungsdienstleister“. Dort sehen Sie Ihre bisherige Stripe-Verbindung.
Klicken Sie auf „Verbindung hinzufügen“. In der Liste der Anbieter finden Sie „Stripe (Aktuelle API-Version)“. Klicken Sie dort auf „Umstellen“.
Es öffnet sich das Fenster „Stripe-Verbindung umstellen“. Ihr vorhandener Stripe-Schlüssel wird weiterverwendet, Sie müssen ihn nicht erneut eingeben und nichts in Stripe ändern. Klicken Sie auf „Jetzt umstellen“.
Im Fenster „Konto anlegen“ ist „Bestehendes Buchungskonto verwenden“ mit dem Buchungskonto Ihrer bisherigen Stripe-Anbindung bereits vorausgewählt. Übernehmen Sie diese Auswahl und klicken Sie auf „Weiter“.
Im Fenster „Importdatum festlegen“ ist „Nur Umsätze importieren ab“ mit dem Datum Ihres zuletzt importierten Stripe-Umsatzes vorausgewählt. So schließt der Import nahtlos an und es werden keine Zahlungen doppelt importiert. Übernehmen Sie das Datum unverändert und klicken Sie auf „Verknüpfen“.

Fertig: Ihre Stripe-Verbindung läuft jetzt über die aktuelle API-Version. Unter „Banken und Zahlungsdienstleister“ sehen Sie die Stripe-Verbindung mit dem Firmennamen aus Stripe. Die bisherige Anbindung wird automatisch entfernt, Sie müssen sie nicht selbst löschen. Der Hinweis-Banner wird danach nicht mehr angezeigt.

Achtung: Ändern Sie im Fenster „Konto anlegen“ die Vorauswahl nur, wenn Sie Ihr Stripe-Konto bewusst auf einem neuen Buchungskonto führen möchten. Wählen Sie dort nicht „Konto ignorieren“ – dann wird Ihre Verbindung nicht umgestellt.

Was passiert mit meinen bisherigen Umsätzen?

Ihre bereits importierten Zahlungen und Buchungen bleiben unverändert erhalten. Bei der Umstellung ist das Importdatum automatisch auf das Datum Ihres zuletzt importierten Stripe-Umsatzes gesetzt. So schließt der Import nahtlos an und es entstehen keine doppelten Zahlungen. Wählen Sie stattdessen ein früheres Datum oder „Alle Umsätze importieren“, werden bereits vorhandene Zahlungen erneut importiert. Das gilt auch später: Setzen Sie das Importdatum über „Bearbeiten“ nicht vor das Datum der Umstellung. Umsätze, die noch über die alte Schnittstelle importiert wurden, erkennt die neue Verbindung nicht und würde sie erneut importieren. Gebühren werden weiterhin automatisch gesplittet, Belege über die Transaction ID zugeordnet und Ihre Automatisierungsregeln gelten unverändert. Wie die Schnittstelle im Detail funktioniert, lesen Sie im Artikel Stripe-Konto verbinden und Umsätze importieren.

Optional: Eingeschränkten API-Schlüssel (Restricted Key) verwenden

Bei der Umstellung übernimmt BuchhaltungsButler den API-Schlüssel aus Ihrer bisherigen Verbindung. Mit der neuen Schnittstelle können Sie stattdessen auch einen eingeschränkten API-Schlüssel nutzen. Er gibt BuchhaltungsButler nur die Leserechte, die für den Import nötig sind.

Möchten Sie einen eingeschränkten Schlüssel verwenden, nutzen Sie nicht die Umstellung. Gehen Sie stattdessen so vor:

Erstellen Sie in Ihrem Stripe-Dashboard einen eingeschränkten Schlüssel (beginnt mit rk_live_) mit der Berechtigung Lesen (Read) für Accounts, Customers und Balance Transactions.
Prüfen Sie, bis zu welchem Datum Ihre Stripe-Zahlungen bereits importiert sind: Öffnen Sie den Bereich „Zahlungen“, wählen Sie oben links Ihr Stripe-Konto aus und sehen Sie nach, von welchem Datum die letzte Zahlung ist. Achten Sie darauf, dass keine Filter aktiv sind, die Zahlungen ausblenden. Notieren Sie sich dieses Datum.
Entfernen Sie in BuchhaltungsButler Ihre bisherige Stripe-Verbindung: „Einstellungen“ → „Banken und Zahlungsdienstleister“ → bei der Stripe-Verbindung auf „Entfernen“ klicken. Ihre bereits importierten Zahlungen bleiben erhalten. Es wird lediglich die Verbindung zu Stripe entfernt.
Verbinden Sie Stripe neu über „Verbindung hinzufügen“ → Stripe mit dem eingeschränkten Schlüssel. Die einzelnen Schritte finden Sie im Artikel Stripe-Konto verbinden und Umsätze importieren.
Wählen Sie dabei „Bestehendes Buchungskonto verwenden“ und Ihr bisheriges Stripe-Buchungskonto. Wählen Sie beim Importdatum „Nur Umsätze importieren ab“ und tragen Sie das notierte Datum ein.

Achtung: Zwischen dem Entfernen und dem Neuverbinden werden keine Stripe-Zahlungen abgerufen. Anders als bei der Umstellung wird das Importdatum hier nicht automatisch vorausgewählt. Legen Sie es deshalb wie oben beschrieben selbst fest, damit keine Zahlungen fehlen oder doppelt importiert werden.

Ein geheimer Schlüssel (Secret Key, beginnt mit sk_live_) funktioniert ebenfalls. Er ist allerdings nicht eingeschränkt und gibt Zugriff auf Ihr gesamtes Stripe-Konto – mehr, als BuchhaltungsButler für den Import benötigt. Deshalb empfehlen wir den eingeschränkten Schlüssel. Reichen die Berechtigungen eines Schlüssels nicht aus, zeigt BuchhaltungsButler beim Verbinden eine Fehlermeldung an.

Häufige Fragen

Ich habe mehrere Stripe-Konten. Was muss ich tun?

Mit der neuen Schnittstelle können Sie mehrere Stripe-Konten gleichzeitig mit BuchhaltungsButler verbinden. Stellen Sie zuerst Ihr bisher verbundenes Stripe-Konto um. Weitere Stripe-Konten können Sie danach jeweils über „Verbindung hinzufügen“ → Stripe mit dem API-Schlüssel des jeweiligen Kontos verbinden. Haben Sie die Zahlungen eines weiteren Kontos bisher per CSV-Datei importiert, prüfen Sie vorher im Bereich „Zahlungen“, bis zu welchem Datum Zahlungen vorhanden sind: Konto oben links auswählen und darauf achten, dass keine Filter aktiv sind. Dieses Datum tragen Sie beim Verbinden unter „Nur Umsätze importieren ab“ ein. So vermeiden Sie doppelte Zahlungen.

Ich habe die Umstellung bis zum 15.12.2026 verpasst. Was nun?

Dann werden keine Stripe-Zahlungen mehr importiert. Richten Sie Ihre Stripe-Verbindung in diesem Fall neu ein, wie im Artikel Stripe-Konto verbinden und Umsätze importieren beschrieben. Wählen Sie dabei „Bestehendes Buchungskonto verwenden“ und Ihr bisheriges Stripe-Buchungskonto. Das Importdatum legen Sie dabei selbst fest: Öffnen Sie vorher den Bereich „Zahlungen“, wählen Sie oben links Ihr Stripe-Konto aus und sehen Sie nach, bis zu welchem Datum Zahlungen importiert wurden. Achten Sie darauf, dass keine Filter aktiv sind, die Zahlungen ausblenden. Dieses Datum tragen Sie beim Verbinden unter „Nur Umsätze importieren ab“ ein.

Muss ich meine Automatisierungsregeln neu einrichten?

Nein. Die „Automatische Gebührenabgrenzung“ unter „Einstellungen“ → „Automatisierungsregeln“ gilt auch für die neue Verbindung.