Abonnementrechnungen

Rechnungen sind zentrale Ressourcen in Stripe und stellen den Betrag dar, den eine Kundin/ein Kunde schuldet. Stripe erstellt für jeden Rechnungsstellungszeitraum eines Abos eine Rechnung. Sie können Rechnungen auch manuell über das Dashboard oder die API für außerplanmäßige oder einmalige Zahlungen generieren. Erfahren Sie mehr über den Lebenszyklus von einmaligen Rechnungen und abonnementbasierten Rechnungen.

Lebenszyklus einer Rechnung

In den folgenden Abschnitten wird beschrieben, wie Stripe eine Rechnung während eines Abonnement-Zyklus handhabt.

Rechnungen für neue Abonnements

Wenn Kund/innen ein Abonnement abschließen, führt Stripe Folgendes durch:

• Erstellen einer Rechnung
• Stellt die Rechnung etwa eine Stunde später aus.

Wenn die Zahlung der ersten Rechnung eines Abonnements erfolgreich war oder für die Rechnung keine Zahlung erforderlich ist, wechselt die Rechnung zu status=paid, und das Abonnement wird aktiv.

Bis die Zahlung als erfolgreich bestätigt wird, bleibt der Rechnungsstatus open und auto_advance bleibt false. Der Abonnementstatus bleibt incomplete. Erfahren Sie, wie Sie fehlgeschlagene Zahlungen für neue Abonnementrechnungen beheben können, die eine Zahlungsmethode benötigen.

In einigen Fällen wird durch ein Upgrade oder Downgrade des Abonnements auch eine neue Rechnung erstellt. Wir deaktivieren auto_advance für diese Rechnungen von Anfang an.

Bei abgeschlossenen Rechnungen können Sie keine Rechnungsposten mehr hinzufügen oder andere Änderungen vornehmen, die sich auf den fälligen Betrag auswirken. Sie können dem/der Kund/in weiterhin Rechnungsposten hinzufügen. Die hinzugefügten Posten gelten für die nächste Rechnung.

Rechnungen für Abonnementverlängerungen

Wenn Abonnements verlängert werden, führt Stripe Folgendes durch:

• Erstellen einer Rechnung

• Belässt die Rechnung für etwa eine Stunde im Status draft.

• Versucht, die Rechnung mit der Standardzahlungsmethode zu finalisieren und zu bezahlen.

• Ändern des Rechnungsstatus auf paid, wenn die Zahlung erfolgreich war

Wenn Stripe eine Rechnung erstellt, erhalten Sie ein invoice.created-Ereignis an Ihrem konfigurierten Webhook-Endpoint. In diesem Fall ist das Attribut des Status der Rechnung draft, was bedeutet, dass die Rechnungsposten noch geändert werden können.

Zahlung erfassen

Bei Fälligkeit einer Rechnung löst Stripe die Zahlung aus, entweder automatisch mit der hinterlegten Zahlungsmethode oder durch Senden der Rechnung an die Kunden-E-Mail-Adresse.

Zahlungen wiederholen

Stripe bietet mehrere Optionen für den Umgang mit fehlgeschlagenen Zahlungen, einschließlich Smart Retries mithilfe von maschinellem Lernen.

Rechnungen für Abonnements verwalten

Erste Rechnung eines Abonnements aktualisieren

Wie Sie die erste Rechnung eines Abonnements bearbeiten, hängt von der Einstellung für die Zahlungsmethode des/der Kund/in für das Abonnement ab. Wenn Sie unsicher sind, können Sie die Einstellung für die Zahlungsmethode über die API oder das Dashboard überprüfen.

Um die Zahlungs eines Abonnements mithilfe der API zu überprüfen, überprüfen Sie den Wert voncollection_method auf dem Objekt Subscriptions Objekt für die Kundin / den Kunden. Der Wertsend_invoice bedeutet, dass Stripe der Kundin / dem Kunden ihre /seine Rechnung per E-Mail sendet. Der Wertcharge_automatically bedeutet, dass Stripe den Kunden in Ihrem Namen mit der Standard-Zahlungsmethode belastet.

Um die Zahlung eines Abonnements im Dashboard zu überprüfen, öffnen Sie die Seite Abonnements. Klicken Sie dann auf das Abonnement, das Sie überprüfen möchten, um die Detailansicht zu öffnen. Im Abschnitt Abonnementdetails definiert der Feldwert Abrechnungsmethode die Zahlungsmethode: Standard-Zahlungsmethode belasten oder Rechnung senden.

Rechnungen anpassen

Sie können Rechnungen auf verschiedene Arten anpassen, einschließlich:

• Einer zukünftigen Rechnung zusätzliche Posten hinzufügen
• Die Häufigkeit von Rechnungen steigern
• Der ersten Rechnung eines/einer Kund/in Posten hinzufügen
• Einer Abonnementrechnung im Entwurfsstatus Posten hinzufügen
• Erstellen einer Rechnung außerhalb des Abo-Servicezeitraums
• Eine Abonnementrechnung zu Prüfungszwecken pausieren
• Abonnementrechnung mit konfigurierbaren Artikelpreisen ausstellen

Einer späteren Rechnung weitere Rechnungsposten hinzufügen

Sie können einer Rechnung bis zu 250 Rechnungsposten hinzufügen. So fügen Sie der nächsten Rechnung im Zyklus zusätzliche Rechnungsposten hinzu:

curl https://api.stripe.com/v1/invoiceitems \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pricing[price]"=price_CBb6IXqvTLXp3f \
  -d customer=cus_4fdAW5ftNQow1a

Diese einmaligen Posten werden der nächsten für diese Kundin/diesen Kunden erstellten Rechnung hinzugefügt. Damit sie zu einem bestimmten Abonnement hinzugefügt werden, verwenden Sie den optionalen Parameter subscription.

Ausstehende Posten öfter in Rechnung stellen

Abgesehen von der Änderung des Rechnungsstellungszeitraum gibt es einige Möglichkeiten, diese Posten abzurechnen, ohne den regulären Abonnementzeitraum anzupassen:

• Erstellen einer einmaligen Rechnung für die Kundin/den Kunden.

• Stellen Sie ein Abonnement immer dann in Rechnung, wenn der fällige Betrag einen bestimmten Schwellenwert erreicht.

• Verwendung von pending_invoice_item_interval, um ein Intervall für die Zahlung ausstehender Rechnungsposten festzulegen. Dies entspricht der Erstellung einer einmaligen Rechnung für das Abonnement auf wiederkehrender Basis.

Auf der ersten Rechnung eines Abonnements eine zusätzliche Gebühr hinzufügen

Fügen Sie mit add_invoice_items eine einmalige Zahlung zur ersten Abonnementrechnung hinzu:

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer={{CUSTOMER_ID}} \
  -d "items[0][price]"={{RECURRING_PRICE_ID}} \
  -d "add_invoice_items[0][price]"={{PRICE_ID}} \
  -d payment_behavior=default_incomplete

Einer Abonnementrechnung im Entwurfsstatus Rechnungsposten hinzufügen

Wenn ein Abonnement verlängert und eine Rechnung erstellt wird, sendet Stripe das Webhook-Ereignis invoice.created. Stripe wartet etwa eine Stunde, bevor die Rechnung finalisiert und die Zahlung durchgeführt oder eine E-Mail gesendet wird.

Während dieser Wartezeit liegt die Rechnung als Entwurf vor und kann bearbeitet werden. Sie können Rechnungsposten für diese Rechnung erstellen. Vergessen Sie nicht, beim Erstellen dieser Rechnungsposten den Parameter „Rechnung“ anzugeben. Andernfalls werden sie als ausstehende Posten hinzugefügt und sind im nächsten Abonnementzeitraum enthalten.

Diese Rechnungsposten verhalten sich etwas anders als die von Stripe automatisch generierten Rechnungsposten:

• Ausstehende Rechnungsposten werden immer fällig, wenn der Abrechnungszeitraum für ein gekündigtes Abonnement endet. Das Stornieren des Abonnements einer Kundin/eines Kunden bedeutet dass die Kund/innen keine Rechnung erhalten, wenn keine Rechnungsposten vorhanden sind.

• Ausstehende Rechnungsposten werden nicht anteilmäßig verrechnet, wenn ein Abonnement geändert wird.

Wenn es ausstehende Rechnungsposten gibt, die auch nach der Kündigung eines Abonnements bestehen bleiben, generiert Stripe eine Rechnung und stellt der Kundin/dem Kunden diesen Posten am Ende des nächsten Abrechnungszeitraums in Rechnung. Diese Rechnungsposten werden (ebenfalls) nicht anteilmäßig verrechnet, wenn ein Abonnement geändert wird.

Ausstehende Rechnungsposten verwalten

Sie können die ausstehenden Rechnungsposten von Kund/innen anzeigen, indem Sie die Kundenseite aufrufen und auf den Namen des/der Kund/in klicken. Wenn es einen offenen Rechnungsposten gibt, erscheint dieser unter Ausstehende Rechnungsposten. Ein Rechnungsposten wird als ausstehend angezeigt, wenn er an keine Rechnung angehängt ist.

Unter Ausstehende Rechnungsposten können Sie auch einen neuen Rechnungsposten erstellen oder alle aufgeführten Rechnungsposten sofort in Rechnung stellen. Wenn Sie auf Jetzt in Rechnung stellen klicken, erscheint ein Dialogfeld, in dem Sie auswählen können, ob Sie die Standardquelle belasten oder die Rechnung per E-Mail an den/die Kund/in senden möchten. Darüber hinaus bietet Ihnen der Dialog die Möglichkeit, die Steuer automatisch zu berechnen.

Erstellen einer Rechnung für Abo-Posten außerhalb des Rechnungsstellungszeitraums

Sie können ausstehende Rechnungsposten außerhalb des regulären Rechnungsstellungszeitraums abrechnen, indem Sie eine einmalige Rechnung erstellen. Beim Erstellen einer einmaligen Rechnung werden alle ausstehenden Rechnungsposten einbezogen, die ansonsten in die planmäßig erstellte Rechnung aufgenommen worden wären.

Eine Abonnementrechnung zu Prüfungszwecken pausieren

Anstatt am Ende eines Abrechnungszeitraums die Zahlung automatisch durchzuführen, können Sie die Rechnung zur Prüfung oder Korrektur pausieren:

1. Pausieren Sie die automatische Abrechnung für eine Stunde nach Erhalt des Ereignisses invoice.created. Sie können auto_advance=false in der API einstellen oder die Abonnements und E-Mails im Dashboard aufrufen. Suchen Sie den Abschnitt „Zahlungen pausieren“ und klicken Sie auf Einrichten, um Änderungen vorzunehmen. Diese Funktion verhindert, dass Stripe den Rechnungsbetrag automatisch einzieht und die Rechnung per E-Mail sendet.

2. Prüfen Sie die Rechnung.

3. Sobald Sie bereit sind, den/die Kund/in zu belasten, können Sie die automatische Abrechnung wieder aktivieren, entweder durch Einstellen von auto_advance=true oder durch Aktualisieren der Optionen für das Pausieren von Zahlungen im Dashboard.

Abonnementrechnung mit konfigurierbaren Artikelpreisen ausstellen

Sie können Rechnungen mit Einzelpostenpreisen ausstellen, die keine Steuern enthalten. Preise ohne Steuern werden nur in der PDF-Datei der Rechnung angezeigt. Das bedeutet, dass bei inkludierten Steuern auf der gehosteten Rechnungsseite und in den Rechnungs-E-Mails die Preise inklusive Steuern angezeigt werden. Sie können die Einstellungen für Nettopreise im Dashboard oder in der API festlegen.

• Inklusive Steuern einschließen: Die PDF-Datei der Rechnung zeigt die Preise der einzelnen Posten, einschließlich der Steuern an. (Dies ist die Standardeinstellung.)
• Steuer ausschließen: Die PDF-Datei der Rechnung zeigt die Preise der einzelnen Posten ohne Steuern an.

Stornieren Sie eine durch ein Abonnement generierte Rechnung.

Stornieren Sie die erste Rechnung eines Abonnements.

Wenn Sie die erste Rechnung eines Abonnements stornieren, wendet Stripe die folgende Logik basierend auf dem Abonnementstatus an:

• Wenn das Abonnement den Status incomplete hat, ändert sich der Status in incomplete_expired.
• Wenn das Abonnement past_due ist, ändert sich der Status des Abonnements in active.
• Wenn das Abonnement bereits den Status active hat, bleibt der Status unverändert.

Stornieren Sie die aktuellste Rechnung eines Abonnements.

Wenn Sie die aktuellste Rechnung eines aktiven Abonnements stornieren und diese nicht die erste ist, wendet Stripe die folgende Logik auf jede vorherige Rechnung an – beginnend mit der neuesten – bis eine der folgenden Bedingungen erfüllt ist:

• Wenn sich die Rechnung im Status paid oder uncollectible befindet, ändert sich der Status des Abonnements in active.
• Wenn die collection_method der Rechnung auf charge_automatically gesetzt ist und Stripe die Mahnungen wegen Erreichen des Wiederholungsversuchslimits gestoppt hat, ändert sich der Abonnementstatus abhängig von Ihren automatischen Zahlungseinstellungen in canceled , unpaid oder past_due.
• Wenn die collection_method auf send_invoice gesetzt ist und die Rechnung überfällig ist, ändert sich der Status des Abonnements auf past_due.
• Befindet sich die Rechnung nicht in einem dieser Status, werden die gleichen Schritte für die nächstjüngere Rechnung ausgeführt.

Wenn keine Rechnungen eines Abonnements eines der genannten Kriterien erfüllen, ändert sich der Abonnementstatus zu active.

Metadaten des Abonnements

Nachdem ein Abonnement eine Rechnung erstellt hat, werden die metadata des Abonnements folgendermaßen hinzugefügt:

• Das Attribut subscription_details.metadata der Rechnung enthält immer die metadata des Abonnements zum Zeitpunkt der Rechnungserstellung, auch wenn die Abonnement-metadata später geändert werden.
• Das Metadaten-Attribut von Rechnungsposten mitparent.type=“subscription_item_details” spiegelt die aktuellsten Abo-Metadaten zum Zeitpunkt des Abrufs der Rechnung wider. Das bedeutet, dass diese von den Metadaten zum Zeitpunkt der Rechnungserstellung abweichen können.
• Rechnungsposten mit parent.type=“invoice_item_details” enthalten nicht die Abo-Metadaten.

Wenn Sie die metadata eines Abonnementrechnungspostens direkt ändern, entweder mit der Aktualisierung des Rechnungspostens oder dem Endpunkt für die Aktualisierung des Sammelrechnungspostens, deklariert die Aktualisierungsanforderung die metadata des Rechnungspostens. Alle „geerbten“ Abonnement metadata nicht implizit beibehalten.

Metadaten des Abonnementpostens werden nicht automatisch an andere Stripe-Objekte weitergegeben.