Benachrichtigung bei Änderung der Zahlungsmethode eines Kunden erhalten

Zeigt Ihre Integration Abonnements und Zahlungsstatus in Ihrem eigenen System an, kann sie jetzt einen Webhook erhalten, wenn sich die Zahlungsmethode eines Kunden ändert. Sie muss nicht mehr regelmäßig die Zahlungsmethoden des Kunden abfragen, um die Änderung festzustellen.

Für die Zahlungsmethode selbst gibt es drei neue Ereignisse:

• payment_method.created, wenn eine Karte oder SEPA-Zahlungsmethode gespeichert wird, zum Beispiel im Checkout, Kundenportal oder über die API.
• payment_method.updated, wenn die Zahlungsmethode zur Standardmethode des Kunden wird, ein neues Ablaufdatum erhält oder nicht mehr verwendet werden kann.
• payment_method.deleted, wenn die Zahlungsmethode entfernt wird.

Jedes Ereignis enthält die Zahlungsmethode genau so, wie die API sie zurückgibt: Kartenmarke, letzte vier Ziffern, Ablaufdatum und Angaben dazu, ob sie Standard ist und verwendet werden kann. Vollständige Kartennummern sind nie enthalten.

Abonnements zeigen jetzt ebenfalls an, mit welcher Zahlungsmethode sie belastet werden: payment_method_uuid in der API und in jedem Abonnement-Webhook. Das neue Ereignis subscription.payment_method_changed informiert Ihre Integration über Änderungen, zum Beispiel wenn der Kunde nach einer fehlgeschlagenen Zahlung die Karte wechselt.

Aktivieren Sie die Ereignisse in den Webhook-Einstellungen, wenn die API-App eingeschaltet ist, und senden Sie zunächst ein Testbeispiel an Ihren Empfänger. Auch installierte Integrationen können die Ereignisse abonnieren.

Allein durch das Erreichen des Kartenablaufdatums wird kein Ereignis ausgelöst. Lesen Sie stattdessen is_expired und is_usable bei der Zahlungsmethode aus.