So verwenden Sie Webhooks in Verbindung mit Abonnements
Stripe sendet mithilfe von Webhooks Benachrichtigungen an Ihre Anwendung. Webhooks sind insbesondere wichtig für Abonnements, bei denen die meisten Aktivitäten asynchron ablaufen.
So verwenden Sie Webhooks in Verbindung mit Ihren Abonnements:
- Erstellen Sie einen Webhook-Endpoint in Ihrer App.
- Fügen Sie die Logik zur Handhabung von Stripe-Ereignissen hinzu. Bei Abonnements zählen hierzu fehlgeschlagene Zahlungen und Änderungen des Abonnementstatus (z. B. Wechsel von der Testphase in den aktiven Status).
- Testen Sie Ihren Webhook-Endpoint, um zu bestätigen, dass er erwartungsgemäß funktioniert.
Hier finden Sie einige weitere nützliche Dokumente zu Webhooks:
- Weitere Informationen zur Einrichtung und Verwendung eingehender Webhooks finden Sie in diesem Leitfaden.
- Verwenden Sie den Quickstart-Leitfaden für Webhooks, um detaillierte Informationen dazu zu erhalten, wie Sie einen minimalen Webhook-Endpoint erstellen.
Webhook-Ereignisse für Abonnements
Stripe löst jedes Mal Ereignisse aus, wenn ein Abonnement erstellt oder geändert wird. Einige Ereignisse werden sofort gesendet, wenn ein Abonnement erstellt wird, während andere in regelmäßigen Abrechnungsintervallen auftreten.
Stellen Sie sicher, dass Ihre Integration die Ereignisse ordnungsgemäß handhabt. Sie können beispielsweise einem/einer Kund/in eine E-Mail senden, wenn eine Zahlung fehlschlägt oder den Zugriff eines/einer Kund/in zurückziehen, wenn ein Abonnement storniert wird.
In der folgenden Tabelle werden die häufigsten Ereignisse im Zusammenhang mit Abonnements beschrieben und ggf. Maßnahmen zum Umgang mit den Ereignissen vorgeschlagen.
customer.created | Wird gesendet, wenn ein/e Kund/in erfolgreich erstellt wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.created | Wird beim Erstellen des Abonnements gesendet. Der status des Abonnements kann incomplete lauten, wenn zum Abschließen der Zahlung eine Kundenauthentifizierung erforderlich ist oder wenn Sie payment_behavior auf default_incomplete festlegen. Zeigen Sie das Zahlungsverhalten für Abonnements an, um mehr zu erfahren. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.deleted | Wird gesendet, wenn das Abonnement eines/einer Kund/in endet. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.paused | Wird gesendet, wenn sich der status eines Abonnements in paused ändert. Dies wird beispielsweise gesendet, wenn ein Abonnement so konfiguriert wird, dass es pausiert wird, wenn ein kostenloser Testzeitraum ohne Zahlungsmethode endet. Das Invoicing erfolgt erst nach der Wiederaufnahme des Abonnements. Wir senden dieses Ereignis nicht, wenn der Zahlungseinzug angehalten wird, da in diesem Zeitraum weiterhin Rechnungen erstellt werden. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.resumed | Wird gesendet, wenn ein Abonnement, das sich zuvor im Status paused befand, wieder aufgenommen wird. Dies gilt nicht, wenn die Pause des Zahlungseinzugs aufgehoben wurde. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.trial_will_end | Wird drei Tage vor Ablauf des Testzeitraums gesendet. Wenn der Testzeitraum kürzer als drei Tage ist, wird dieses Ereignis ausgelöst. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.updated | Wird gesendet, wenn ein Abonnement gestartet oder geändert wird. So lösen beispielsweise das Erneuern des Abonnements, das Hinzufügen eines Gutscheins, das Anwenden eines Rabatts, das Hinzufügen eines Rechnungspostens und das Ändern von Abonnementplänen alle dieses Ereignis aus. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entitlements.active_entitlement_summary.updated | Sent when a customer’s active entitlements are updated. When you receive this event, you can provision or de-provision access to your product’s features. Read more about integrating with entitlements. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.created | Wird gesendet, wenn eine Rechnung für ein neues oder verlängertes Abonnement erstellt wird. Wenn Stripe keine erfolgreiche Antwort auf invoice.created erhält, verzögert sich die Finalisierung aller Rechnungen mit dem automatischen Einzug um bis zu 72 Stunden. Erfahren Sie mehr über das Finalisieren von Rechnungen.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.finalized | Wird gesendet, wenn eine Rechnung erfolgreich finalisiert wurde und bereit für die Bezahlung ist.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.finalization_failed | Die Rechnung konnte nicht finalisiert werden. Erfahren Sie in diesem Leitfaden, wie Sie mit Fehlern bei der Rechnungsfinalisierung umgehen. Erfahren Sie im Leitfaden mit der Übersicht zu Rechnungen mehr über die Rechnungsfinalisierung.
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.paid | Wird gesendet, wenn die Rechnung erfolgreich bezahlt wird. Sie können den Zugriff auf Ihr Produkt gewähren, wenn Sie dieses Ereignis erhalten und der status des Abonnements active ist. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.payment_action_required | Wird gesendet, wenn für die Rechnung eine Kundenauthentifizierung erforderlich ist. Erfahren Sie, wie das Abonnement zu behandeln ist, wenn für die Rechnung eine Aktion erforderlich ist. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Eine Zahlung für eine Rechnung ist fehlgeschlagen. Der PaymentIntent-Status ändert sich in
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.upcoming | Wird ein paar Tage vor der Verlängerung des Abonnements gesendet. Die Anzahl der Tage basiert auf der im Dashboard festgelegten Anzahl für Bevorstehende Verlängerungsereignisse. Bei bestehenden Abonnements wird die Änderung der Anzahl der Tage im nächsten Abrechnungszeitraum wirksam. Sie können bei Bedarf noch zusätzliche Rechnungsposten hinzufügen. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.updated | Wird gesendet, wenn eine Zahlung erfolgreich ist oder fehlschlägt. Wenn die Zahlung erfolgreich ist, wird das Attribut paid auf true festgelegt und der status ist paid . Wenn die Zahlung fehlschlägt, wird das Attribut paid auf false festgelegt und der status bleibt open . Fehlgeschlagene Zahlungen lösen außerdem das Ereignis invoice.payment_failed aus. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_intent.created | Wird gesendet, wenn ein PaymentIntent erstellt wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_intent.succeeded | Wird gesendet, wenn die Zahlung für einen PaymentIntent erfolgreich abgeschlossen wurde. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.aborted | Wird gesendet, wenn ein Abonnementplan storniert wurde, weil das zugehörige Abonnement aufgrund von Zahlungsverzug gekündigt wurde. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.canceled | Wird gesendet, wenn ein Abonnementplan gekündigt wird, wodurch auch alle aktiven zugehörigen Abonnements gekündigt werden. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.completed | Wird gesendet, wenn alle Phasen eines Abonnementplans abgeschlossen sind. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.created | Wird gesendet, wenn ein neuer Abonnementplan erstellt wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.expiring | Wird 7 Tage vor Ablauf eines Abonnementplans gesendet. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.released | Wird gesendet, wenn ein Abonnementplan freigegeben wird oder beendet und von dem verbleibenden Abonnement getrennt wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.updated | Wird gesendet, wenn ein Abonnementplan aktualisiert wird. |
Umgang mit fehlgeschlagenen Zahlungen
Webhook-Benachrichtigungen bieten eine zuverlässige Möglichkeit für Stripe, Sie über fehlgeschlagene Zahlungen bei Abonnementrechnungen zu benachrichtigen. Einige fehlgeschlagene Zahlungen sind nur temporär, z. B. kann ein/e Kartenaussteller/in die erste Zahlung ablehnen, aber eine automatische Wiederholung zulassen. Andere fehlgeschlagene Zahlungen sind endgültig und machen Maßnahmen erforderlich, z. B. das Fehlen einer nutzbaren Zahlungsmethode für den/die Kund/in.
Ereignis | Beschreibung |
---|---|
| Eine Zahlung für eine Rechnung ist fehlgeschlagen. Der Status des PaymentIntent ändert sich in
|
Weitere Informationen zum Umgang mit fehlgeschlagenen Zahlungen, für die eine Zahlungsmethode erforderlich ist finden Sie im Leitfaden mit einer Übersicht über Abonnements.
Umgang mit Zahlungen, für die zusätzliche Maßnahmen erforderlich sind
Bei einigen Zahlungsmethoden sind möglicherweise zusätzliche Schritte erforderlich, z. B. die Authentifizierung des/der Kund/in. Wenn Sie diese Ereignisse erhalten, muss Ihre App den/die Kund/in benachrichtigen, damit er/sie die erforderliche Aktion abschließt. Um zu erfahren, wie Sie mit Ereignissen, die zusätzliche Maßnahmen erfordern umgehen, lesen Sie den Leitfaden mit einer Übersicht über Abonnements.
Ereignis | Beschreibung |
---|---|
invoice.finalization_failed | Die Rechnung konnte nicht finalisiert werden. Erfahren Sie in diesem Leitfaden, wie Sie mit Fehlern bei der Rechnungsfinalisierung umgehen. Erfahren Sie im Leitfaden mit der Übersicht zu Rechnungen mehr über die Rechnungsfinalisierung.
|
| Eine Zahlung für eine Rechnung ist fehlgeschlagen. Der PaymentIntent-Status ändert sich in
|
| Eine Zahlung für eine Rechnung ist fehlgeschlagen. Der PaymentIntent-Status ändert sich in
|
Aktive Abonnements verfolgen
Für Abonnements ist eine Koordination zwischen Ihrer Website und Stripe erforderlich. Ob die wiederkehrenden Zahlungen eines/einer Kund/in erfolgreich sind, bestimmt, ob diese weiterhin Zugang zu Ihrem Produkt oder Ihrer Dienstleistung haben.
For typical integrations, you store customers’ credentials and a mapped timestamp value that represents the access expiration date for that customer on your site when a customer subscribes. When the customer logs in, you check whether the timestamp is still in the future. If the timestamp is in the future when the customer logs in, the account is active and the customer should still have access to the service.
Wenn das Abonnement verlängert wird, stellt Stripe eine Rechnung aus und versucht, die Zahlung einzuziehen, und zwar entweder durch automatische Belastung der hinterlegten Zahlungsmethode oder indem die Rechnung an die Kunden-E-Mail-Adresse gesendet wird. Stripe benachrichtigt Ihre Website per Webhooks über den Benachrichtigungsstatus:
Ihre Seite empfängt das Ereignis
invoice.paid
.- Wenn Sie eine Zahlungsmethode automatisch belasten, erhält Ihre Website einige Tage vor der Verlängerung am Webhook-Endpoint das Ereignis
invoice.upcoming
. Sie können dieses Ereignis überwachen, um der zukünftigen Rechnung zusätzliche Rechnungsposten hinzuzufügen. Wenncollection_method=send_invoice
, sendet Stripe kein Ereignisinvoice.upcoming
.
- Wenn Sie eine Zahlungsmethode automatisch belasten, erhält Ihre Website einige Tage vor der Verlängerung am Webhook-Endpoint das Ereignis
Ihr Webhook-Endpoint findet den Kunden/die Kundin, für den/die die Zahlung getätigt wurde.
Ihr Webhook-Endpoint aktualisiert das Ablaufdatum für den Zugriff des/der Kund/in in Ihrer Datenbank auf das entsprechende Datum in der Zukunft (zuzüglich ein bis zwei Tagen Spielraum).
Statusänderungen von Abonnements erfassen
Stellen Sie sicher, dass Ihre Integration die Übergänge zwischen den in der folgenden Tabelle beschriebenen Abonnementstatus ordnungsgemäß überwacht und handhabt.
Einige Statusänderungen erfordern besondere Aufmerksamkeit:
Ein paar Tage bevor ein Testzeitraum endet und das Abonnement von
trialing
zuactive
wechselt, erhalten Sie das Ereigniscustomer.subscription.trial_will_end
. Wenn Sie dieses Ereignis erhalten, überprüfen Sie, ob Sie eine Zahlungsmethode für den/die Kund/in haben, damit Sie ihm/ihr eine Rechnung stellen können. Optional können Sie den/die Kund/in darüber informieren, dass sein/ihr Konto belastet wird.Wenn der Status eines Abonnements zu
past_due
wechselt, benachrichtigen Sie die Kund/innen direkt und bitten Sie sie, ihre Zahlungsdaten zu aktualisieren. Stripe bietet mehrere Funktionen zur Automatisierung dieses Vorgangs. Erfahren Sie mehr über die Umsatzsicherung.Wenn der Status eines Abonnements zu
canceled
oderunpaid
wechselt, widerrufen Sie den Zugriff auf Ihr Produkt.
Status | Beschreibung |
---|---|
trialing | Das Abonnement befindet sich derzeit in einem Testzeitraum, und Ihr Produkt kann sicher für Ihre Kund/innen bereitgestellt werden. Das Abonnement wechselt automatisch in den Status active , wenn die erste Zahlung erfolgt. |
active | Das Abonnement funktioniert ordnungsgemäß, und die letzte Zahlung war erfolgreich. Ihr Produkt kann sicher für Ihre Kund/innen bereitgestellt werden. |
incomplete | Eine erfolgreiche Zahlung muss innerhalb von 23 Stunden erfolgen, damit das Abonnement aktiviert wird. Oder für die Zahlung ist eine Aktion erforderlich, wie z. B. die Kundenauthentifizierung. Abonnements können auch incomplete sein, wenn eine Zahlung aussteht und der PaymentIntent-Status processing ist. |
incomplete_expired | Die erste Zahlung für das Abonnement ist fehlgeschlagen, und es wurde innerhalb von 23 Stunden nach Erstellung des Abonnements keine erfolgreiche Zahlung getätigt. Diese Abonnements werden Kund/innen nicht in Rechnung gestellt. Der Status dient dazu, Kund/innen nachzuverfolgen, die ihre Abonnements nicht aktivieren konnten. |
past_due | Die Zahlung der letzten finalisierten Rechnung ist entweder fehlgeschlagen oder wurde nicht versucht. Für das Abonnement werden weiterhin Rechnungen erstellt. Ihre Abonnementeinstellungen bestimmen den nächsten Status des Abonnements. Wenn die Rechnung nach allen versuchten Smart Retries immer noch nicht bezahlt wird, können Sie das Abonnement so konfigurieren, dass es in den Status canceled oder unpaid wechselt oder als past_due belassen wird. Um das Abonnement auf active zu setzen, muss die letzte Rechnung vor dem Fälligkeitsdatum beglichen werden. |
canceled | Das Abonnement wurde storniert. Während der Stornierung ist der automatische Einzug für alle unbezahlten Rechnungen deaktiviert (auto_advance=false ). Dies ist ein Terminal-Status, der nicht aktualisiert werden kann. |
unpaid | Die letzte Rechnung wurde nicht bezahlt, aber das Abonnement bleibt bestehen. Die letzte Rechnung bleibt offen, und es werden weiterhin Rechnungen erstellt. Es wird jedoch nicht versucht, sie zu bezahlen. Sie sollten den Zugriff auf Ihr Produkt sperren, wenn das Abonnement unpaid ist, da die Zahlungen bereits versucht und wiederholt wurden, als es past_due war. Um das Abonnement auf active zu setzen, bezahlen Sie die aktuelle Rechnung vor dem Fälligkeitsdatum. |
paused | Das Abonnement hat seinen Testzeitraum ohne Standardzahlungsmethode beendet und trial_settings.end_behavior.missing_payment_method ist auf pause festgelegt. Für das Abonnement werden keine Rechnungen mehr erstellt. Nachdem dem Kunden/der Kundin eine Standard-Zahlungsmethode zugeordnet wurde, können Sie das Abonnement wiederaufnehmen. |
Webhooks und Rechnungen
Wir empfehlen, einen Webhook-Endpoint zu registrieren, um den Rechnungsstatus zu verfolgen. Die Verfolgung des Rechnungsstatus ist besonders wichtig für Rechnungen, die im Rahmen eines Abonnements erstellt wurden.
Wenn Sie den automatischen Einzug aktivieren, finalisiert Stripe automatisch und beginnt mit dem automatischen Einzug der Rechnung.
Um sicherzustellen, dass Ihre Abonnementintegration wie erwartet funktioniert, einschließlich des fortgesetzten Zahlungseingangs für im Abonnement erstellte Rechnungen, müssen Sie die Webhooks für die Rechnungsfinalisierung korrekt handhaben. Die erfolgreiche Finalisierung von Rechnungen und der korrekte Umgang mit Fehlern bei der Finalisierung von Rechnungen sind für eine Abonnementintegration von entscheidender Bedeutung.
Wenn Stripe keine erfolgreiche Antwort auf
invoice.created
erhält, verzögert sich die Finalisierung aller Rechnungen mit automatischer Erfassung um bis zu 72 Stunden.Die ordnungsgemäße Antwort auf
invoice.created
umfasst die Verarbeitung aller für Ihr Konto konfigurierten Webhook-Endpoints sowie der Webhook-Endpoints aller Plattformen, mit denen Sie verbunden sind.Die Aktualisierung eines Abonnements mit synchronen Zahlungsversuchen (bei der ersten Rechnung und bei einigen Arten von Aktualisierungen) führt nicht zu dieser Verzögerung.
Wenn die Rechnung nicht finalisiert werden kann, können die Zahlungen für die Rechnung nicht eingezogen werden. Überwachen Sie unbedingt das Ereignis
invoice.finalization_failed
in Ihrem Webhook-Endpoint.
Webhook-Ereignisse im Zusammenhang mit der Rechnungsfinalisierung
Ereignis | Beschreibung |
---|---|
invoice.created | Die Rechnung wurde erfolgreich erstellt und kann nun finalisiert werden. Lesen Sie die Dokumentation, um mehr über die Finalisierung von Rechnungen zu erfahren.
|
invoice.finalized | Die Rechnung wurde erfolgreich finalisiert und kann jetzt bezahlt werden.
|
invoice.finalization_failed | Die Rechnung konnte nicht finalisiert werden. Erfahren Sie in diesem Leitfaden, wie Sie mit Fehlern bei der Rechnungsfinalisierung umgehen. Erfahren Sie im Leitfaden mit der Übersicht zu Rechnungen mehr über die Rechnungsfinalisierung.
|
Erfolgreiche Rechnungsfinalisierung
Stripe wartet eine Stunde nach Erhalt einer erfolgreichen Antwort auf das Ereignis invoice.created
, bevor ein Zahlungsversuch gestartet wird. Wenn innerhalb von 72 Stunden keine erfolgreiche Antwort eingeht, versucht Stripe, die Rechnung zu finalisieren und zu senden.
Falls Sie einmalige Rechnungen anders behandeln möchten als Abonnementrechnungen, prüfen Sie die Eigenschaft subscription
im Webhook-Text. Hier wird angezeigt, ob die Rechnung für ein Abonnement erstellt wurde.
Wenn Ihr Webhook-Endpoint im Live-Modus nicht ordnungsgemäß reagiert, wiederholt Stripe die Webhook-Benachrichtigung bis zu drei Tage lang mit exponentiellem Zurücksetzen. Im Test-Modus versuchen wir es dreimal über mehrere Stunden hinweg. Während dieser Zeit versuchen wir nicht, das Kundenkonto zu belasten, solange wir keine Antwort bei Erfolg erhalten. Wir senden Ihnen außerdem eine E-Mail, um Sie über den fehlerhaften Webhook zu benachrichtigen.
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.
Fehler bei der Rechnungsfinalisierung
Wenn Stripe eine Rechnung nicht finalisieren kann, wird das Ereignis invoice.finalization_failed
an Ihren Webhook-Endpoint gesendet. Abonnements bleiben aktiv, wenn Rechnungen nicht finalisiert werden können. Das bedeutet, dass Nutzer/innen weiterhin auf Ihr Produkt zugreifen können, während Sie nicht in der Lage sind, Zahlungen einzuziehen. Ergreifen Sie bei Rechnungen, die nicht finalisiert werden können, unbedingt entsprechende Maßnahmen. Für Rechnungen, die nicht finalisiert sind, können Sie keine Zahlungen einziehen.
Um festzustellen, warum die Rechnungsfinalisierung fehlgeschlagen ist, sehen Sie sich das Feld last_finalization_error
des Rechnungsobjekts an, das weitere Informationen über den Fehler und die weitere Vorgehensweise enthält.
Wenn Sie Stripe Tax verwenden, überprüfen Sie das Feld automatic_tax
, um zu ermitteln, ob der Fehler mit der Validierung des Kundenstandorts zusammenhängt. Wenn Stripe Tax keinen anerkannten Kundenstandort finden kann, kann die Rechnung nicht finalisiert werden. Erfahren Sie, wie Sie mit Fehlern bei der Rechnungsfinalisierung umgehen sollten.
Tests
Sie haben zwei Optionen, um Webhooks zu testen:
- Führen Sie Aktionen im Testmodus durch, die zulässige Ereignisse an Ihren Endpoint senden. Um beispielsweise das Ereignis charge.succeeded auszulösen, können Sie eine Testkarte, die eine erfolgreiche Abbuchung erzeugt verwenden.
- Ereignisse mit der Stripe-CLI oder mit Stripe für Visual Studio Code auslösen.