Erfordert:
- Charitable Pro 1.8.16+
- Charitable Wiederkehrende Spenden 2.1.0+
Die Situation eines Spenders ändert sich. Vielleicht ist der nächste Monat knapp und er möchte seine monatliche Spende von 50 € auf 25 € reduzieren, oder es kam eine Zuschussförderung und er möchte seine jährliche Spende erhöhen. Vor Charitable Recurring 2.1 gab es keine andere Möglichkeit, dies zu handhaben, als das Abonnement zu kündigen und den Spender zu bitten, ein neues zu starten, was die Zahlungshistorie verliert und das Risiko birgt, dass die Spende nie wieder zurückkommt.
Jetzt können Sie den Betrag und die Abrechnungsperiode einer aktiven wiederkehrenden Spende direkt in Ihrem WordPress-Adminbereich aktualisieren, und die Änderung wird automatisch mit Stripe synchronisiert. Das gleiche Abonnement bleibt bestehen, sodass die Zahlungshistorie erhalten bleibt und der Spender sein ursprüngliches Startdatum behält.
Sie können eine Änderung sofort anwenden oder dem Spender zuerst einen sicheren Genehmigungslink senden. Jede Änderung wird in Ihrem Audit-Protokoll aufgezeichnet, und Änderungen, die Sie im Stripe Dashboard vornehmen, werden automatisch wieder mit Charitable synchronisiert.

Wann Sie es verwenden würden
- Ein Spender bittet um eine Änderung seines Betrags – aktualisieren Sie ihn in Sekundenschnelle, anstatt zu kündigen und neu zu abonnieren.
- Ein Spender möchte von monatlich auf jährlich wechseln (oder eine andere Periode) – ändern Sie die Abrechnungsperiode beibehalten.
- Eine Änderung erfordert die Zustimmung des Spenders – senden Sie eine Genehmigungs-E-Mail und lassen Sie den Spender bestätigen, bevor etwas bei Stripe passiert.
- Jemand hat das Abonnement im Stripe Dashboard bearbeitet – Charitable übernimmt automatisch den neuen Betrag und die neue Periode.
- Sie benötigen eine Aufzeichnung, wer was geändert hat – jede Aktualisierung wird in den Protokollen von Charitable mit dem alten Wert, dem neuen Wert und dem Verursacher protokolliert.
Finden
Öffnen Sie die wiederkehrende Spende, die Sie ändern möchten:
WordPress Admin > Spenden > Wiederkehrende Spenden > (klicken Sie auf die Spende)

Wählen Sie im Feld Spendenaktionen rechts im Dropdown-Menü Abonnement aktualisieren und klicken Sie dann auf die Schaltfläche Abonnement aktualisieren.
Die Spende muss das Stripe-Gateway verwenden und den Status Aktiv haben. Pausierte, stornierte, abgeschlossene und ausstehende Abonnements können nicht bearbeitet werden, um zu verhindern, dass der Spender von einer unerwarteten Abbuchung überrascht wird.
Ein Abonnement aktualisieren
Das Fenster Abonnement aktualisieren zeigt oben das aktuelle Abonnement an, dann die Felder, die Sie ändern können.

1. Neuen Betrag und/oder Periode festlegen
- Neuer Betrag – geben Sie einen beliebigen Wert von 1,00 bis (theoretisch) 999999,99 ein. Lassen Sie ihn unverändert, um den aktuellen Betrag beizubehalten.
- Neue Abrechnungsperiode – wählen Sie aus täglich, wöchentlich, monatlich, vierteljährlich, halbjährlich oder jährlich. Lassen Sie sie auf der aktuellen Periode, um sie beizubehalten.
Sie können eine oder beide ändern. Die Änderung wird zum nächsten Abrechnungsdatum des Spenders wirksam; sein aktueller Zyklus endet normal, und es wird keine anteilige Berechnung angewendet.
2. Auswählen, wie die Änderung angewendet wird
- Sofort anwenden – die Änderung wird sofort an Stripe gesendet.
- Genehmigung durch Spender anfordern – eine anstehende Änderung wird gespeichert und der Spender erhält eine E-Mail mit sicheren Links zur Genehmigung und Ablehnung. Bei Stripe ändert sich nichts, bis der Spender zustimmt.

3. Entscheiden Sie, ob der Spender benachrichtigt werden soll
Das Kontrollkästchen Spender über diese Änderung benachrichtigen ist standardmäßig aktiviert. Wenn es aktiviert ist, erhält der Spender eine E-Mail „Abonnement aktualisiert“ mit dem alten und neuen Betrag oder Zeitraum. Deaktivieren Sie es für Anpassungen im Backoffice, über die der Spender nicht informiert werden muss.
Wenn Sie auf Abonnement aktualisieren klicken, sehen Sie eine Erfolgsmeldung und die Spendensumme wird auf der Seite aktualisiert.
Der Genehmigungsworkflow für Spender
Wenn Sie Genehmigung durch Spender anfordern wählen, erhält der Spender eine E-Mail mit zwei Links: einem zur Genehmigung der Änderung und einem zur Ablehnung.

Ein paar Dinge, die Sie über die Funktionsweise der Genehmigungslinks wissen sollten:
- Sicher und spendenspezifisch. Jeder Link enthält ein signiertes Token, das an diese genaue Spende gebunden ist. Ein Link für eine Spende kann nicht für eine andere verwendet werden.
- Sie verfallen. Genehmigungslinks sind 7 Tage gültig. Danach funktioniert der Link nicht mehr und Sie müssten die Anfrage erneut ausstellen.
- Nur einmal verwendbar. Sobald der Spender genehmigt oder abgelehnt hat, ist der Link verbraucht. Ein erneutes Klicken hat keine Auswirkung.
- Eine neue Anfrage ersetzt eine alte. Wenn Sie eine zweite Änderung vornehmen, während eine noch aussteht, überschreibt die neuere Anfrage die ältere und der alte Link funktioniert nicht mehr.
Wenn der Spender auf Genehmigen klickt, wird die Änderung an Stripe übermittelt und die Spende aktualisiert. Wenn er auf Ablehnen klickt, bleibt das Abonnement unverändert und die anstehende Änderung wird gelöscht.
Änderungen im Stripe Dashboard
Wenn Sie (oder ein Teammitglied) den Betrag oder Abrechnungszeitraum eines Abonnements direkt im Stripe Dashboard bearbeiten, erkennt Charitable dies und aktualisiert die lokale Spende entsprechend. Dies geschieht über den bereits konfigurierten Stripe-Webhook, sodass nichts extra eingerichtet werden muss. Das bedeutet, dass der Spenden-Datensatz in WordPress korrekt bleibt, unabhängig davon, wo die Bearbeitung vorgenommen wurde.
Das Audit-Protokoll lesen
Jede Abonnementänderung wird in Ihren Charitable-Protokollen aufgezeichnet, unabhängig davon, ob sie durch eine Admin-Aktualisierung, eine Spendergenehmigung oder das Stripe Dashboard erfolgte.
WordPress Admin » Charitable » Tools » Logs
Jeder Eintrag zeichnet den alten Wert, den neuen Wert, wer die Änderung vorgenommen hat und wann auf. Sie können nach Spenden-ID filtern, um die vollständige Historie eines einzelnen Abonnements anzuzeigen.
Die Benachrichtigungs-E-Mail an den Spender
Standardmäßig erhalten Spender nach einer erfolgreichen Änderung eine E-Mail „Abonnement aktualisiert“, in der die Änderungen aufgeführt sind. Sie können diese anpassen oder deaktivieren unter:
WordPress Admin » Charitable » Settings » Emails

Zwei E-Mails beziehen sich auf diese Funktion:
- Abonnement aktualisiert – wird dem Spender nach der Anwendung einer Änderung gesendet. Standardmäßig aktiviert.
- Abonnementänderungsanforderung – die E-Mail zur Anforderung der Genehmigung, die gesendet wird, wenn Sie „Genehmigung durch Spender anfordern“ wählen.
Klicken Sie auf eine der beiden E-Mails, um deren Betreff, Überschrift und Text zu bearbeiten oder sie zu deaktivieren.
Tipps
- Verwenden Sie Spendergenehmigung anfordern für jede Änderung, die ein Spender nicht ausdrücklich gewünscht hat, damit er immer das letzte Wort hat.
- Der Spendenstatus Aktiv ist erforderlich. Wenn die Option Abonnement aktualisieren fehlt oder deaktiviert ist, überprüfen Sie zuerst den Abonnementstatus.
- Änderungen werden im nächsten Abrechnungszyklus wirksam, nicht sofort, sodass der Spender im aktuellen Zeitraum niemals doppelt belastet wird.
Entwicklerreferenz
Der vollständige Update-Pfad basiert auf Hooks, sodass Sie Abonnementänderungen abfangen, erweitern oder darauf reagieren können.
Filter
| Filter | Standard | Zweck |
|---|---|---|
charitable_process_subscription_update_stripe | array( 'success' => false, 'message' => ... ) | Implementiert von Charitable Pro 1.8.16+. Empfängt die wiederkehrende Spende und die vorgeschlagenen Änderungen, leitet sie an Stripe weiter und gibt ein Ergebnis-Array zurück. Sowohl der Admin-Update-Endpunkt als auch der Spendergenehmigungs-Handler rufen ihn auf. |
charitable_recurring_confirmation_page_colors | Markenfarben | Farben für die Spender-Bestätigungsseite für die Genehmigung/Ablehnung. |
charitable_recurring_confirmation_page_heading | Überschrift pro Aktion | Die Überschrift, die auf der Bestätigungsseite angezeigt wird. |
charitable_recurring_confirmation_page_message | Nachricht pro Aktion | Die Hauptnachricht auf der Bestätigungsseite. |
charitable_recurring_confirmation_page_button | Zurück zur Startseite-Schaltfläche | Die Schaltfläche, die auf der Bestätigungsseite angezeigt wird. |
charitable_recurring_confirmation_page_html | leer | Geben Sie benutzerdefinierten HTML-Code zurück, um die gesamte Bestätigungsseite zu ersetzen. |
Aktionen
| Aktion | Argumente | Wann er ausgelöst wird |
|---|---|---|
charitable_recurring_subscription_updated | $donation, $changes, $old_values | Nach einem erfolgreichen Update. Löst die E-Mail „Abonnement aktualisiert“ für Spender aus, wenn diese E-Mail aktiviert ist. |
charitable_recurring_subscription_change_requested | $donation, $pending_data, $raw_token | Wenn ein Administrator die Spendergenehmigung anfordert. Löst die E-Mail zur Anforderung der Genehmigung aus. |
charitable_stripe_subscription_details_changed | $subscription, $stripe_object | Ausgelöst vom Webhook-Prozessor von Pro bei einem Stripe-Ereignis customer.subscription.updated. Der Reverse-Sync-Listener liest den neuen Betrag und Zeitraum vom Stripe-Objekt. |
Hilfsfunktionen und Klassen
charitable_recurring_update_local_subscription( $donation, $changes )– aktualisiert nur lokale Metadaten. Behandelt die proportionale Verteilung eines neuen Betrags für einzelne und mehrere Kampagnen.Charitable_Recurring_Subscription_Change_Handler::process_approval()– verarbeitet den Klick des Spenders auf „Genehmigen“ (?donation_id=X&token=Y&action=approve).Charitable_Recurring_Subscription_Change_Handler::process_denial()– verarbeitet den Ablehnungspfad.Charitable_Recurring_Subscription_Change_Handler::cleanup_expired_pending_changes()– entfernt abgelaufene ausstehende Änderungsdatensätze (läuft als geplante Aufgabe).Charitable_Gateway_Stripe_AM::$period_map– statisches Array, das jede Charitable-Periode einer Stripe-intervalundinterval_countzuordnet.Charitable_Gateway_Stripe_AM::update_subscription( $result, $donation, $changes )– die Methode hinter dem Filter; erstellt einen Stripe-Plan für die neuen Argumente und tauscht das Abonnementelement dagegen aus, wobei die anteilige Berechnung deaktiviert wird.
Periodenabbildung
Der von Ihnen festgelegte Betrag und die Periode werden wie folgt auf das Abrechnungsmodell von Stripe abgebildet:
| Charitable-Periode | Stripe-Intervall | Intervall-Anzahl |
|---|---|---|
| Tag | Tag | 1 |
| Woche | Woche | 1 |
| Monat | Monat | 1 |
| Quartal | Monat | 3 |
| Halbjahr | Monat | 6 |
| Jahr | Jahr | 1 |
Genehmigungs-Token
Der Genehmigungslink verwendet ein HMAC-SHA256-Token, das an die Spenden-ID, den Zeitpunkt des vorgeschlagenen Wechsels und ein einmaliges 32-stelliges Geheimnis gebunden ist. Tokens laufen nach 7 Tagen ab. Ein Zähler für wiederholte Versuche wird im Transient charitable_sub_token_attempts_{donation_id} gespeichert, und der ausstehende Änderungsdatensatz wird bei Genehmigung oder Ablehnung gelöscht, sodass ein Link nicht wiederverwendet werden kann.
Beispiele für Anpassungen
Fügen Sie eine benutzerdefinierte Protokollzeile hinzu, wenn ein Abonnement aktualisiert wird:
add_action( 'charitable_recurring_subscription_updated', function ( $donation, $changes, $old_values ) {
error_log( sprintf(
'Subscription #%d updated: %s',
$donation->ID,
wp_json_encode( $changes )
) );
}, 10, 3 );
Benachrichtigen Sie Ihr Team in Slack, wenn eine Spendergenehmigung angefordert wird:
add_action( 'charitable_recurring_subscription_change_requested', function ( $donation, $pending_data, $raw_token ) {
my_slack_notify( sprintf(
'Approval requested for recurring donation #%d',
$donation->ID
) );
}, 10, 3 );
Gestalten Sie die Spenderbestätigungsseite:
add_filter( 'charitable_recurring_confirmation_page_colors', function ( $colors ) {
$colors['primary'] = '#16a34a';
return $colors;
} );
Verwandt
- Wiederkehrende Spenden – der Überblick über wiederkehrende Spenden in Charitable.
- Stripe-Gateway – Verbindung und Konfiguration von Stripe.





