Abonnementrechnungen

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
• Finalisiert die Rechnung.

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

• Belassen der Rechnung für etwa eine Stunde im Zustand 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 (über konfigurierte Webhooks) das Ereignis invoice.created. Diesmal lautet das Attribut 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.

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 Abonnement-Zahlungsmethode mit der API zu prüfen, überprüfen Sie den Wert von collection_method im Subscriptions-Objekt für die Kundin/den Kunden. Der Wert send_invoice bedeutet, dass Stripe der Kundin/dem Kunden die Rechnung per E-Mail zusendet. Der Wert charge_automatically bedeutet, dass Stripe das Kundenkonto in Ihrem Namen mit der kundenseitigen Standardzahlungsmethode belastet.

Um die Zahlungsmethode für das Abonnement im Dashboard zu prüfen, öffnen Sie die Seite Abonnements. Klicken Sie dann auf das Abonnement, das Sie überprüfen möchten, um es in der Detailansicht zu öffnen. Im Abschnitt Abodetails definiert der Wert des Felds Abrechnungsmethode die Zahlungsmethode: Die Standard-Zahlungsmethode belasten oder Rechnung senden.

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
• Generieren einer Rechnung außerhalb des Abonnementzyklus
• 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d 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

Außer durch Änderung des Abrechnungszyklus gibt es noch andere Möglichkeiten, diese Posten in Rechnung zu stellen:

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

• Rechnen Sie ein Abonnement ab, wenn der fällige Betrag einen 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_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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

When a subscription renews and creates an invoice, Stripe sends the invoice.created webhook event. Stripe waits approximately one hour before finalizing the invoice and attempting payment, or sending an email.

During that delay, the invoice is a draft and is editable. You can create invoice items on that invoice. Make sure to provide the invoice parameter when you create these invoice items. Otherwise, they’re added as pending items and are included in the next subscription period.

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.

Rechnung für Abonnementposten außerhalb des Abrechnungszyklus erzeugen

Sie können ausstehende Rechnungsposten außerhalb des regulären Abrechnungszyklus in Rechnung stellen, indem Sie eine einmalige Rechnung erzeugen. Dabei werden alle ausstehenden Rechnungsposten einbezogen, die der regulären Rechnung hinzugefügt 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.

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 Attribut metadata von Rechnungsposten mit type=“subscription” spiegelt die aktuellsten Abonnement-metadata zum Zeitpunkt des Rechnungsabrufs wider, d. h. sie können von den metadata zum Zeitpunkt der Rechnungserstellung abweichen.
• Rechnungsposten mit type=“invoiceitem” enthalten keine metadata des Abonnements.

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.