> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywise.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Überfällige Stripe-Rechnungen an paywise übergeben – für ein Konto, mehrere Marken oder eine ganze Stripe-Organisation

# paywise für Stripe

<div style={{width: '64px', height: '64px', background: '#ffffff', borderRadius: '10px', display: 'flex', alignItems: 'center', justifyContent: 'center', padding: '10px', boxSizing: 'border-box'}}>
  <img src="https://mintcdn.com/paywisegmbh/wAdTkukMeudh23V7/images/integrations/stripe-icon.png?fit=max&auto=format&n=wAdTkukMeudh23V7&q=85&s=12728de25e438b6d0215d7829ace3a3a" alt="Stripe" style={{width: '100%', height: '100%', objectFit: 'contain', display: 'block'}} noZoom width="128" height="128" data-path="images/integrations/stripe-icon.png" />
</div>

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.

<Note>
  paywise liest aus Stripe und schreibt nichts zurück. In Ihrem Stripe-Konto wird
  nichts geändert, storniert oder als bezahlt markiert.
</Note>

## Bevor Sie starten

* Ein Stripe-Konto, in dem Sie API-Schlüssel erstellen dürfen.
* Ein paywise-Konto.
* Mindestens eine **offene Rechnung** in Stripe.

<Note>
  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.
</Note>

### Benötigte Berechtigungen

paywise liest ausschließlich, was für den Forderungseinzug nötig ist:

| Berechtigung         | Zugriff     | Wofür paywise sie braucht                             |
| -------------------- | ----------- | ----------------------------------------------------- |
| `Connect › Accounts` | Lesezugriff | Erkennt, zu welchem Stripe-Konto der Schlüssel gehört |
| `Core › Customers`   | Lesezugriff | Name und Anschrift der Schuldner                      |
| `Billing › Invoices` | Lesezugriff | Die offenen Rechnungen, die Sie einreichen            |

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.

<Steps>
  <Step title="In Stripe anmelden">
    Loggen Sie sich unter [dashboard.stripe.com](https://dashboard.stripe.com/) in
    Ihren Stripe-Account ein.
  </Step>

  <Step title="API-Schlüssel öffnen">
    Navigieren Sie im Menü zu **Entwickler → API-Schlüssel**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Schlüssel kopieren">
    Kopieren Sie den neu erstellten Schlüssel und fügen Sie ihn in paywise ein.
  </Step>
</Steps>

## 1. Stripe verbinden

<Steps>
  <Step title="Verbindungsseite öffnen">
    Gehen Sie auf [app.paywise.de/connect/stripe/](https://app.paywise.de/connect/stripe/).
  </Step>

  <Step title="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.
  </Step>

  <Step title="Bedingungen akzeptieren und verbinden">
    Setzen Sie das Häkchen bei **Ich akzeptiere die Nutzungsbedingungen** und wählen
    Sie **Schlüssel verbinden**.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

### Mehrere Stripe-Konten

Im Abschnitt **Stripe-Konten** verwalten Sie alle verbundenen Konten. Jedes Konto
zeigt seinen **Typ** und **Status**:

| Typ                       | Bedeutung                                                          |
| ------------------------- | ------------------------------------------------------------------ |
| **Eigener Schlüssel**     | Für dieses Konto ist ein eigener Schlüssel hinterlegt              |
| **Organisations-Kontext** | Das Konto nutzt den Organisations-Schlüssel und hat keinen eigenen |

Ü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

<Steps>
  <Step title="Rechnungsauswahl öffnen">
    Wählen Sie auf der Stripe-Seite in paywise **Rechnungen einreichen**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

### 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.

<Warning>
  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.
</Warning>

## 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/](https://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

<Steps>
  <Step title="Regelmäßiger Abgleich">
    paywise ruft Ihre offenen Rechnungen aus Stripe in festen Abständen ab. Neue
    offene Rechnungen kommen dabei automatisch dazu.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="„Der Schlüssel wurde von Stripe abgelehnt“">
    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.
  </Accordion>

  <Accordion title="„Diesem Schlüssel fehlen Berechtigungen, die paywise benötigt“">
    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.
  </Accordion>

  <Accordion title="„Ihr API-Schlüssel ist nicht mehr gültig“">
    Der Schlüssel wurde in Stripe widerrufen oder rotiert. Hinterlegen Sie über
    **Ersetzen** einen aktuellen Schlüssel.
  </Accordion>

  <Accordion title="Eine überfällige Rechnung fehlt in der Liste">
    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.
  </Accordion>

  <Accordion title="Ein Konto zeigt „Kein Schlüssel“">
    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.
  </Accordion>
</AccordionGroup>

## Fragen

Schreiben Sie an [info@paywise.de](mailto:info@paywise.de).