Statusübergänge und Finalisierung

Die folgende Grafik zeigt die verschiedenen Möglichkeiten, wie eine Rechnung von einem Status auf einen anderen übergehen kann:

Statusübergänge und Finalisierung

Übergänge und Endpoints

In der folgenden Tabelle sind die Statuswechsel und ihre Endpoints aufgeführt. Außerdem enthält sie die vom Endpoint ausgegebenen Webhooks und den entsprechenden Status für jeden Endpoint:

Rechnungsentwürfe finalisieren

When you enable automatic collection, Stripe automatically finalizes, and begins automatic collection of the invoice. We wait 1 hour after receiving a successful response to the invoice.created event from all listening webhooks before attempting payment. If we don’t receive a successful response within 72 hours, we attempt to finalize and send the invoice. You can configure a longer grace period.

Rechnungen werden anfänglich mit status=draft erstellt und können nur in diesem Status bearbeitet werden. Sobald eine Rechnung bezahlt werden kann, finalisieren Sie diese. Das Finalisieren einer Rechnung versetzt sie in den Status status=open. Sie können eine Rechnung manuell im Dashboard oder über den Endpoint Finalize finalisieren. Wenn Sie Webhook-Endpoints konfiguriert haben, erhalten Sie ein invoice.finalized-Ereignis, wenn eine Rechnung finalisiert wird.

curl -X POST https://api.stripe.com/v1/invoices/
{{INVOICE_ID}}
/finalize \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

In live mode, if your webhook endpoint doesn’t respond properly, Stripe continues retrying the webhook notification for up to 3 days with an exponential back off. In a sandbox, we retry three times over a few hours. During that time, we won’t attempt to charge the customer unless we receive a successful response. We also send you an email to notify you that the webhook is failing.

Dieses Verhalten gilt für alle auf Ihrem Konto angegebenen Webhook-Endpoints, einschließlich für Fälle, in denen eine Connect-Anwendung oder ein anderer Drittanbieter Schwierigkeiten beim Empfang eingehender Webhooks hat.

Sie können eine längere Nachfrist festlegen.

Nach der Finalisierung

Mit der Finalisierung einer Rechnung ist Folgendes möglich:

• Die Rechnung kann bezahlt werden.
• Es wird sichergestellt, dass eine Rechnungsnummer vorhanden ist.
• Bestimmte Eigenschaften der Rechnung werden unveränderbar gemacht.
• Es wird ein unvollständiger PaymentIntent für die Rechnung erstellt.
• Es wird eine eindeutige URL generiert, unter der die Rechnung bezahlt werden kann. Außerdem wird ein Link zum Herunterladen einer PDF-Datei der Rechnung erstellt.

Beschränkungen für eine finalisierte Rechnung

Nachdem Sie eine Rechnung finalisiert haben, sind Änderungen an bestimmten Feldern, die sich auf den Rechnungsbetrag und die belastete Kundin/den belasteten Kunden beziehen, nicht mehr möglich. So werden die allgemein geltenden Steuervorschriften zur Aufbewahrung finalisierter Rechnungen in der Form, in der sie auch finalisiert wurden, über einen gesetzlich vorgeschriebenen Mindestzeitraum erfüllt.

In einigen Ländern kann das Bearbeiten von Feldern mit der Änderung am fälligen Gesamtbetrag einer Rechnung dazu führen, dass die Rechnung ungültig wird. In der Regel handelt es sich dabei um Felder im Zusammenhang mit Ihrem Konto, Kund/innen, Einzelposten oder Steuern. Sie müssen sicherstellen, dass die von Ihnen erstellten Rechnungen alle geltenden Gesetzen einhalten.

Wenn Sie den Rechnungsbetrag nach der Finalisierung ändern möchten, können Sie dafür Stornorechnungen verwenden. Mit Stornorechnungen können Sie den Rechnungsbetrag ändern, indem Sie eine Anpassung des ausstehenden Betrags vornehmen. Sie können Stornorechnungen für jede Rechnung ausstellen, die den Status open oder paid hat. Beim Finalisieren der Rechnung werden die folgenden Kundenfelder kopiert und unveränderlich gemacht:

• invoice.customer_address
• invoice.customer_email
• invoice.customer_name
• invoice.customer_phone
• invoice.customer_shipping
• invoice.customer_tax_exempt
• invoice.customer_tax_ids

Wenn Sie eine kundenbezogene Eigenschaft einer Rechnung ändern möchten, gehen Sie wie folgt vor:

1. Die aktuelle Rechnung stornieren.
2. Die stornierte Rechnung duplizieren.
3. Die Kundeninformationen auf der neuen Rechnung aktualisieren.

Versand von E-Mails nach Finalisierung

Standardmäßig versendet Stripe automatisch Rechnungen, wenn Sie collection_method auf send_invoice festlegen. In den folgenden Fällen sendet Stripe keine Rechnungen per E-Mail.

• Wenn es sich um eine automatische Abbuchung handelt.
• Wenn der automatische Einzug für die Rechnung deaktiviert ist.
• Wenn die Option Finalisierte Rechnungen per E-Mail an Kund/innen senden deaktiviert ist.

Asynchrone Zahlungen

Bei bestimmten Zahlungsmethoden ist für den Zahlungsabschluss ein Eingreifen der Kundin/des Kunden notwendig – so kann beispielsweise bei einer europäischen Karte oder einer Banküberweisung die starke Kundenauthentifizierung (SCA) vorgeschrieben sein.

Verwenden Sie den Rechnungsparameter payment_intent, um auszuwählen, wie die Antwort auf den Zahlungsversuch (success oder requires_action) verarbeitet werden soll.

Wenn der PaymentIntent den Status requires_action hat, müssen Sie Ihre Nutzer/innen einen 3D Secure-Authentifizierung ausführen lassen, um die Zahlung abzuschließen.

Anstatt diesen Vorgang selbst zu erstellen, können Sie Stripe für die Abwicklung nutzen. Aktivieren Sie dazu Erinnerungs-E-Mails im Dashboard, damit Stripe automatisch E-Mails an Ihre Kundinnen/Kunden senden kann, wenn requires_action auftritt. Diese E-Mails enthalten einen Link zur gehosteten Rechnungsseite, auf der Kundinnen/Kunden alle für die Bezahlung der Rechnung erforderlichen Schritte ausführen können. Unter Senden von E-Mail-Erinnerungen erfahren Sie mehr über diese E-Mails und wie sie angepasst werden können.