Dokumentation zu ausstehenden Aktualisierungen

Unterstützte Attribute

Zum Erstellen einer ausstehenden Aktualisierung können nur bestimmte Attribute verwendet werden. Diese Attribute steuern entweder das Verhalten bei der anteilsmäßigen Verrechnung oder generieren neue Rechnungen.

Die unterstützten Attribute für den Endpoint zur Aktualisierung des Abonnements sind:

• expand
• payment_behavior
• proration_behavior
• proration_date
• billing_cycle_anchor
• items
  • price
  • quantity
• trial_end
• trial_from_plan
• add_invoice_items

Die unterstützten Attribute für die Endpoints zum Erstellen eines Abonnement-Eintrags und zur Aktualisierung eines Abonnement-Eintrags sind:

• expand
• payment_behavior
• proration_behavior
• proration_date
• price
• quantity

Lebenszyklus ausstehender Aktualisierungen

Wenn die Zahlung erfolgreich durchgeführt werden konnte, wird die Rechnung auf paid aktualisiert, und die Änderungen werden sofort auf das Abonnement angewendet. Konnte die Zahlung nicht erfolgreich vorgenommen werden, werden die aktualisierten Werte dem Hash pending_update für das Objekt Subscription hinzugefügt. Die latest_invoice für das Abonnement bezieht sich auf eine unbezahlte Rechnung mit dem Status open. Das Abonnement läuft so weiter, als wäre keine Aktualisierungsanfrage gestellt worden.

Es gibt zwei Möglichkeiten für den Umgang mit Zahlungsausfällen. Diese beziehen sich auf fehlgeschlagene Zahlungen und die Kundenauthentifizierung. Nachdem diese Probleme behoben wurden, wird erneut versucht, die Zahlung durchzuführen. War die Zahlung erfolgreich, werden die Änderungen übernommen, und der Hash pending_update wird gelöscht. Schlägt die Zahlung erneut fehl, verbleibt der Hash pending_update für das Abonnement mit dem ursprünglichen Ablaufdatum, und es werden keine Änderungen angewendet.

Wenn Sie eine ausstehende Aktualisierung abbrechen, wird der Hash pending_update gelöscht, und die zugehörigen Änderungen werden verworfen.

Gültig bis

Wenn Sie nach einer fehlgeschlagenen Aktualisierung keinerlei Maßnahmen ergreifen, wird die Rechnung storniert, und die ausstehende Aktualisierung wird verworfen, nachdem die Zeit unter expired_at für das pending_update abgelaufen ist. Dieser Zeitpunkt wird entweder auf das Ende des Testzeitraums oder auf das Ende des aktuellen Zeitraums festlegt, je nachdem, was zuerst eintritt. Wenn diese Zeitpunkte später als 23 Stunden nach dem Zeitpunkt der Aktualisierung liegen, wird als Zeit für expired_at ein Zeitraum von 23 Stunden nach dem Aktualisierungsaufruf berechnet.

Stripe storniert außerdem automatisch die Rechnung und entfernt die ausstehende Aktualisierung, wenn Folgendes geschieht:

• Das Abrechnungslimit des Abonnements ist erreicht.
• Ein mit dem Abonnement verknüpfter Abonnementplan geht in eine neue Phase über.

Ereignisse im Zusammenhang mit ausstehenden Aktualisierungen

Sie können Webhooks verwenden, um die folgenden Ereignisse im Zusammenhang mit ausstehenden Aktualisierungen zu überwachen:

Ausstehende Aktualisierungen und Abonnementpläne

Sowohl ausstehende Aktualisierungen als auch Abonnementpläne können zur Verwaltung von Abonnements verwendet werden. Falls eine ausstehende Aktualisierung vorhanden ist, wenn sich die Phasen eines Zeitplans ändern, wird die ausstehende Aktualisierung verworfen, und die zugehörige Rechnung wird storniert, bevor der Phasenwechsel stattfindet. Bei Bedarf können Sie nach dem Phasenwechsel erneut versuchen, die Aktualisierungsanfrage durchzuführen.

Nutzungsdaten

Wenn ein Abonnement nutzungsbasierte Artikel enthält, stellt Stripe alle ausstehenden Nutzungsdaten auf der ausstehenden Aktualisierungsrechnung in Rechnung. Wenn die Zahlung für die ausstehende Aktualisierung jedoch nicht vor dem Ablaufdatum erfolgt, verwirft Stripe diese Nutzungsdaten, was eine Abrechnung auf der nachfolgenden Rechnung verhindert. Wenn durch die ausstehende Aktualisierung ein nutzungsbasierter Preis entfernt wird, ignoriert Stripe außerdem jegliche zwischen der Erstellung der ausstehenden Aktualisierung und der Zahlung der resultierenden Rechnung gemeldete Nutzung und schließt sie aus allen Rechnungen aus.