Was Sie lernen werden:
- wie Sie ein oder mehrere Stripe-Konten mit BuchhaltungsButler verbinden
- welchen API-Schlüssel Sie brauchen und welche Berechtigungen er haben muss
- wie Stripe-Gebühren automatisch als Teilbuchung abgegrenzt werden
- wie Sie Stripe Payouts buchen
- wie Belege automatisch Ihren Stripe-Zahlungen zugeordnet werden
Ein Stripe-Konto kann über unsere eigene Schnittstelle angebunden werden. Bei Import der Umsätze werden dazugehörige Gebühren als Teilbuchung dargestellt.
Welchen API-Schlüssel benötigen Sie?
Für die Verbindung benötigen Sie einen API-Schlüssel aus Ihrem Stripe-Dashboard. Wir empfehlen einen eingeschränkten Schlüssel (Restricted Key). Er beginnt mit rk_live_ und erlaubt BuchhaltungsButler nur das Lesen der Daten, die für den Import nötig sind. BuchhaltungsButler verändert nichts in Ihrem Stripe-Konto. 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.
Diese Berechtigungen muss der Schlüssel haben
Setzen Sie beim Erstellen des Schlüssels für die folgenden Bereiche die Berechtigung Lesen (Read):
- Accounts (Konten)
- Customers (Kunden)
- Balance Transactions (Saldotransaktionen)
Alle anderen Bereiche können Sie auf „Keine“ (None) lassen.
So erstellen Sie den eingeschränkten Schlüssel in Stripe
- Melden Sie sich in Ihrem Stripe-Dashboard an.
- Öffnen Sie Entwickler → API-Schlüssel (Developers → API keys).
- Klicken Sie auf Eingeschränkten Schlüssel erstellen (Create restricted key) und vergeben Sie einen Namen, z. B. „BuchhaltungsButler“.
- Setzen Sie die oben genannten Berechtigungen auf Lesen.
- Klicken Sie auf Schlüssel erstellen (Create key) und bestätigen Sie die Zwei-Faktor-Verifizierung. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf – Stripe zeigt ihn nur einmal an.
| Achtung: Verwenden Sie einen Live-Schlüssel (rk_live_…). Mit einem Testschlüssel (rk_test_…) werden keine echten Umsätze abgerufen. Wenn Sie den Schlüssel in Stripe löschen oder erneuern, stoppt der Abruf in BuchhaltungsButler. Entfernen Sie in diesem Fall die Stripe-Verbindung unter „Einstellungen“ → „Banken und Zahlungsdienstleister“ über „Entfernen“ und verbinden Sie Stripe mit dem neuen Schlüssel neu. Prüfen Sie vorher im Bereich „Zahlungen“ (Stripe-Konto oben links auswählen, keine Filter aktiv), bis zu welchem Datum Umsätze importiert wurden, und tragen Sie dieses Datum beim Neuverbinden unter „Nur Umsätze importieren ab“ ein. |
Anbindung Ihres Stripe-Kontos mit BuchhaltungsButler
Wechseln Sie zur Anbindung von Stripe in die „Einstellungen“ → „Banken und Zahlungsdienstleister“ → „Verbindung hinzufügen“.
- Wählen Sie Stripe aus und klicken auf „Jetzt einrichten“. Sie werden nun gebeten, den Stripe API-Key einzugeben. Fügen Sie den API-Schlüssel ein, den Sie wie oben beschrieben in Stripe erstellt haben.
- Nach Eingabe des API-Schlüssels und Klick auf „Verknüpfen“ öffnet sich ein neues Fenster, in dem Sie die Verknüpfung des Stripe-Kontos auf das Buchungskonto vornehmen. Ihr Stripe-Konto wird dort mit dem Firmennamen aus Stripe angezeigt. Ist in Stripe kein Firmenname hinterlegt, steht dort „Stripe“.
- Fehlt dem Schlüssel eine Berechtigung oder ist er ungültig, zeigt BuchhaltungsButler eine Fehlermeldung an. Prüfen Sie dann die Berechtigungen in Stripe und versuchen Sie es erneut.
- Wählen Sie aus, welche Buchungskontonummer das verknüpfte Konto erhalten soll. Wenn Sie bereits eine bestehende Buchhaltung haben, nehmen Sie bitte die Zuordnung anhand der Summen- und Saldenliste Ihres Steuerberaters vor. Sollte das Stripe-Konto bereits angelegt sein, wählen Sie alternativ „Bestehendes Konto verwenden“ sowie das Buchungskonto, auf welchem es weitergeführt werden soll.
- Über „Weiter“ gelangen Sie nun zur letzten Abfrage der Anbindung. Hier kann ein Datum gewählt werden, ab dem die Zahlungen importiert werden sollen. Bei „Nur Umsätze importieren ab“ wählen Sie bitte das Datum aus, ab dem erstmalig Zahlungen importiert werden sollen.
| Tipp: Sie können das Datum später über „Bearbeiten“ an Ihrer Stripe-Verbindung ändern, zum Beispiel auf ein früheres Datum, um ältere Umsätze nachträglich abzurufen. Umsätze, die bereits über diese Stripe-Verbindung importiert wurden, werden dabei nicht erneut abgerufen. Zahlungen, die auf anderem Weg in das Konto gekommen sind (z. B. per CSV-Import oder über eine frühere Stripe-Verbindung), erkennt die Verbindung dagegen nicht – sie würden doppelt importiert. |
- Ihr Stripe-Konto ist nun verknüpft und die Zahlungen werden abgerufen.
Weitere Stripe-Konten anbinden
Sie können mehrere Stripe-Konten mit BuchhaltungsButler verbinden. Jede Verbindung gehört zu genau einem Stripe-Konto. Für jedes weitere Konto klicken Sie erneut auf „Verbindung hinzufügen“ → Stripe und geben den API-Schlüssel dieses Stripe-Kontos ein. Jedes Stripe-Konto erhält ein eigenes Buchungskonto – entweder ein neues oder ein bereits bestehendes.
| Hinweis: Haben Sie Umsätze eines weiteren Stripe-Kontos bereits per CSV-Datei in ein manuelles Konto importiert? Dann prüfen Sie vorher im Bereich „Zahlungen“, bis zu welchem Datum Umsätze vorhanden sind: Wählen Sie oben links das manuelle Konto aus und achten Sie darauf, dass keine Filter aktiv sind. Dieses Datum tragen Sie beim Verbinden unter „Nur Umsätze importieren ab“ ein. So vermeiden Sie doppelte Umsätze. |
Funktionsweise der Schnittstelle
Der Login in Ihren Account löst automatisch den Abruf der Zahlungen Ihres Stripe-Accounts und deren Import im Hintergrund aus. Im Bereich „Zahlungen“ können Sie den Abruf auch manuell über den Button „Zahlungen abrufen“ oben rechts anstoßen. Sind mehrere Stripe-Konten verbunden, werden die Zahlungen aller Konten abgerufen.
Gebühren, die sich eindeutig einer Zahlung zuordnen lassen, werden durch BuchhaltungsButler automatisch gesplittet und als Teilbuchung dargestellt.
Das Buchungskonto für die Buchung der Gebühren und den Steuersatz können Sie in den „Einstellungen“ definieren. Sie finden die „Automatische Gebührenabgrenzung“ unter „Automatisierungsregeln“. Standardmäßig ist der Steuersatz auf keine VSt. eingestellt. Halten Sie im Zweifel Rücksprache mit Ihrem Steuerberater. Die Einstellung gilt für alle verbundenen Stripe-Konten.
Stripe Payouts
Als „Stripe Payout“ finden Sie den Betrag auf Ihrem Stripe Konto, welchen Stripe an Sie überwiesen hat. Dieser Betrag geht auf Ihrem bei Stripe hinterlegten Bankkonto ein. Die Auszahlung auf dem Stripe Konto und die Einzahlung auf Ihrem Bankkonto gleichen sich aus. Sie buchen sowohl den Stripe Payout als auch den Geldeingang auf Ihrem Bankkonto gegen das Konto Geldtransit (1360 | 1460) (SKR03 | SKR04).
Belegmatching zur Zahlung
Das Belegmatching findet über die Transaction ID statt. Diese befindet sich im Verwendungszweck. Sollte Ihr Beleg nicht automatisch mit der Buchung verknüpft werden, prüfen Sie, ob Sie die Transaction ID am Beleg auch korrekt übergeben. Hinweise zur automatischen Belegzuweisung können Sie in unserem Artikel zum Belegmatching in unserer Wissensdatenbank nachlesen.