Skip to main content

paywise für Stripe

Stripe
Mit der Stripe-Anbindung übergeben Sie überfällige Rechnungen aus Stripe Billing direkt an den paywise-Forderungseinzug. Typischer Fall: eine Abo- oder Rechnungszahlung, bei der die hinterlegte Karte nicht mehr belastet werden kann und Stripe die Rechnung offen stehen lässt.
paywise liest aus Stripe und schreibt nichts zurück. In Ihrem Stripe-Konto wird nichts geändert, storniert oder als bezahlt markiert.

Bevor Sie starten

  • Ein Stripe-Konto, in dem Sie API-Schlüssel erstellen dürfen.
  • Ein paywise-Konto.
  • Mindestens eine offene Rechnung in Stripe.
Ist für das Unternehmen zugleich ein DATEV-Import aktiv, deaktivieren Sie ihn unter DATEV Einstellungen → Gefahrenzone → Integration deaktivieren, bevor Sie die Stripe-Rechnungsauswahl nutzen. So ist eindeutig, aus welcher Quelle neue Forderungen übernommen werden sollen.

Benötigte Berechtigungen

paywise liest ausschließlich, was für den Forderungseinzug nötig ist: Diese drei Rechte reichen – paywise schreibt nichts in Ihr Stripe-Konto. Ein Standard-Schlüssel (sk_…) Ihres Kontos oder ein Organisations-Schlüssel (sk_org_…) bringt diese Rechte bereits mit; dort ist nichts einzustellen.

Den Stripe-Schlüssel erstellen

In paywise erreichen Sie diese Anleitung jederzeit über den Link „Was ist das?“ auf der Stripe-Seite.
1

In Stripe anmelden

Loggen Sie sich unter dashboard.stripe.com in Ihren Stripe-Account ein.
2

API-Schlüssel öffnen

Navigieren Sie im Menü zu Entwickler → API-Schlüssel.
3

Eingeschränkten Schlüssel erstellen

Wir empfehlen einen eingeschränkten Schlüssel, der nur Zugriff auf die benötigten Ressourcen vergibt. Wählen Sie in der Sektion Eingeschränkte Schlüssel die Option Eingeschränkten Schlüssel erstellen.
4

Drei Leserechte vergeben

Vergeben Sie in der Konfiguration des Schlüssels die drei Leserechte aus der Tabelle oben: Connect › Accounts, Core › Customers und Billing › Invoices.
5

Schlüssel kopieren

Kopieren Sie den neu erstellten Schlüssel und fügen Sie ihn in paywise ein.

1. Stripe verbinden

1

Verbindungsseite öffnen

2

Schlüssel einfügen

Fügen Sie im Abschnitt Stripe-Schlüssel verbinden einen beliebigen Stripe-API-Schlüssel ein. paywise erkennt automatisch, ob es sich um einen Organisations-Schlüssel (sk_org_…), den Schlüssel Ihres Hauptkontos oder den Schlüssel eines weiteren Stripe-Kontos (Marke) handelt.
3

Bedingungen akzeptieren und verbinden

Setzen Sie das Häkchen bei Ich akzeptiere die Nutzungsbedingungen und wählen Sie Schlüssel verbinden.
4

Bei weiteren Konten: Anzeigename vergeben

Gehört der Schlüssel zu einem weiteren Stripe-Konto, fragt paywise nach einem Anzeigenamen der Marke. Bestätigen Sie mit Als Marke hinzufügen.

Mehrere Stripe-Konten

Im Abschnitt Stripe-Konten verwalten Sie alle verbundenen Konten. Jedes Konto zeigt seinen Typ und Status: Über Konto hinzufügen verbinden Sie ein weiteres Konto, über Ersetzen tauschen Sie einen Schlüssel aus (der neue ersetzt den bisherigen sofort; bereits übernommene Forderungen bleiben unberührt), über Konto entfernen stoppen Sie den Import aus diesem Konto.

2. Rechnungen einreichen

1

Rechnungsauswahl öffnen

Wählen Sie auf der Stripe-Seite in paywise Rechnungen einreichen.
2

Rechnungen auswählen

Die Rechnungsauswahl zeigt Rechnungen mit dem Stripe-Status open – mit Rechnungsnummer, Kunde, Rechnungsdatum, Fälligkeit und offenem Betrag.Das Fälligkeitsdatum kommt direkt aus Stripe. paywise berechnet hier nichts selbst.
3

Schuldnerdaten prüfen

Name und Anschrift kommen aus dem Stripe-Customer, das Rechnungs-PDF wird aus Stripe angehängt. Prüfen Sie Fälligkeit, Währung, offenen Betrag und Empfängerdaten sorgfältig und ergänzen Sie fehlende Angaben.
4

Mahnung erfassen

Stripe liefert keine Mahnungen im Sinne des deutschen Mahnwesens. Tragen Sie hier ein, wie und wann Sie den Schuldner zur Zahlung aufgefordert haben – schriftlich oder mündlich, mit Datum und gesetzter Zahlungsfrist.Das ist rechtlich relevant: Gegenüber Verbrauchern ist eine Mahnung in der Regel Voraussetzung dafür, dass Verzugszinsen und Inkassokosten geltend gemacht werden können.
5

Auftrag absenden

Legen Sie fest, wie der Einzug starten soll, beantworten Sie die rechtlichen Fragen, akzeptieren Sie die Bedingungen und wählen Sie Auftrag absenden.

Was die Rechnungsauswahl anzeigt

Die normale Rechnungsauswahl filtert bei Stripe nach dem Status open. Sie prüft vor der Anzeige nicht zusätzlich, ob die Rechnung bereits fällig ist, auf Euro lautet oder vollständige Empfänger- und PDF-Daten enthält. open bedeutet daher nicht automatisch, dass die Forderung schon eingereicht werden sollte. Fehlende Anschrift- und Kontaktdaten können Sie nach dem Hinzufügen im paywise-Entwurf ergänzen. Ein Kundenname muss bereits in Stripe hinterlegt sein. Fehlt ein nutzbares Rechnungs-PDF, kann paywise die Rechnung ebenfalls nicht hinzufügen; stellen Sie das PDF in Stripe bereit und versuchen Sie es erneut.
Prüfen und vervollständigen Sie die Forderung in paywise, bevor Sie den Auftrag absenden. Reichen Sie insbesondere keine noch nicht fällige oder bereits bezahlte Forderung ein.

Mahnservice: Rechnungen laufend übernehmen

Diese Anbindung versorgt nicht nur den einmaligen Forderungseinzug, sondern auch den paywise-Mahnservice. Dabei ruft paywise Ihre offenen Rechnungen regelmäßig ab und mahnt sie in Ihrem Namen – bevor daraus ein Inkassofall wird. Sie richten den Mahnservice unter app.paywise.de/mahnservice/ ein.

Voraussetzungen

Damit der laufende Abgleich startet, müssen alle folgenden Punkte erfüllt sein:
  • Eine aktive Stripe-Verbindung.
  • Ein gebuchter Mahnservice und die akzeptierten Mahnservice-AGB.
  • Ein festgelegter Importumfang – Sie entscheiden einmalig, welche Rechnungen übernommen werden sollen.
  • Die Freigabe je Stripe-Konto: Sie entscheiden pro verbundenem Konto bzw. pro Marke, ob dessen Rechnungen in den Mahnservice laufen sollen.

Welche Rechnungen der Mahnservice übernimmt

Für den Mahnservice gilt eine strengere automatische Prüfung. Eine Stripe-Rechnung wird nur übernommen, wenn alle folgenden Punkte erfüllt sind:
  • Der Status ist open.
  • Das Fälligkeitsdatum liegt in der Vergangenheit und der offene Restbetrag ist größer null.
  • Die Währung ist Euro.
  • Ein Kunde mit Namen und Postanschrift ist zugeordnet.
  • Ein Rechnungs-PDF ist vorhanden.
  • Die Rechnung wurde weder an den Forderungseinzug noch an den Mahnservice übergeben.

Was paywise vor jeder Mahnung prüft

1

Regelmäßiger Abgleich

paywise ruft Ihre offenen Rechnungen aus Stripe in festen Abständen ab. Neue offene Rechnungen kommen dabei automatisch dazu.
2

Statusprüfung unmittelbar vor dem Versand

Direkt bevor eine Mahnung rausgeht, fragt paywise den aktuellen Rechnungsstatus noch einmal in Stripe ab. Ist die Rechnung inzwischen bezahlt oder storniert, wird nicht gemahnt.
3

Im Zweifel wird nicht gemahnt

Lässt sich der Status nicht zweifelsfrei feststellen – etwa weil Stripe vorübergehend nicht erreichbar ist –, hält paywise die Mahnung zurück. Das ist bewusst so: Lieber eine Mahnung zu spät als eine an jemanden, der schon bezahlt hat.
Zahlungen, die paywise beim Abgleich in Stripe findet, beenden das Mahnverfahren automatisch.

3. Verbindung trennen

Wählen Sie auf der Stripe-Seite bei dem betreffenden Konto Konto entfernen – oder für die gesamte Verbindung Verbindung löschen und bestätigen Sie mit Löschen. Der hinterlegte Schlüssel wird entfernt und der Import aus diesem Konto gestoppt. Bereits übernommene Forderungen bleiben bestehen. Sie können den Schlüssel jederzeit erneut hinterlegen. Nutzt das Konto den Mahnservice, werden keine weiteren Mahnungen versendet, solange paywise den Rechnungsstatus nicht über eine aktive Verbindung prüfen kann.

Fehlerbehebung

Prüfen Sie, ob Sie den vollständigen Schlüssel kopiert haben und ob er zum richtigen Stripe-Konto und zur richtigen Umgebung gehört.
paywise nennt Ihnen die fehlenden Rechte namentlich. Ergänzen Sie sie in Stripe unter Eingeschränkten Schlüssel bearbeiten und fügen Sie den Schlüssel erneut ein.
Der Schlüssel wurde in Stripe widerrufen oder rotiert. Hinterlegen Sie über Ersetzen einen aktuellen Schlüssel.
Gehen Sie die Liste unter Rechnungen, die nicht eingereicht werden können durch. Am häufigsten fehlt beim Kunden die Postanschrift, oder die Rechnung lautet nicht auf Euro.
Für dieses Konto ist kein Schlüssel hinterlegt und es nutzt auch keinen Organisations-Schlüssel. Fügen Sie über Ersetzen einen Schlüssel hinzu.

Fragen

Schreiben Sie an [email protected].