So senden Sie E-Mails bei fehlgeschlagener Zahlung

Lesezeit: 4 Minuten | Schwierigkeit: Anfänger

Übersicht

WP Simple Pay kann zwei E-Mails senden, wenn Stripe eine fehlgeschlagene Zahlung meldet:

• Zahlungsfehler-Benachrichtigung geht an Sie, den Website-Administrator. Sie ist standardmäßig aktiviert.
• Zahlungsfehler-Bestätigung geht an den Kunden. Sie teilt ihm mit, dass die Zahlung nicht verarbeitet werden konnte, gibt den Grund an und bittet ihn, seine Daten zu überprüfen und es erneut zu versuchen. Sie ist standardmäßig deaktiviert, sodass Sie entscheiden, ob Kunden sie erhalten.

Beide E-Mails werden für fehlgeschlagene Einmalzahlungen und fehlgeschlagene Abonnementverlängerungen gesendet. Eine abgelehnte Karte, eine abgelaufene Karte im System oder eine Verlängerung, bei der die Wiederholungsversuche aufgebraucht sind, bleiben nicht mehr unbemerkt, bis Sie Stripe überprüfen.

Voraussetzungen

• WP Simple Pay Pro (jede bezahlte Lizenz).
• Webhooks für Ihr Stripe-Konto eingerichtet. Beide E-Mails werden gesendet, wenn Stripe ein charge.failed-Ereignis an Ihre Website liefert. Siehe Webhooks.
• Ein mit WP Simple Pay erstelltes Zahlungsformular. Fehlgeschlagene Abbuchungen, die nicht von einem WP Simple Pay-Formular stammen, senden diese E-Mails nicht.

Schritt 1: Konfigurieren Sie die Admin-Benachrichtigung

1. Gehen Sie zu WP Simple Pay → Einstellungen → E-Mails.
2. Wählen Sie im Dropdown-Menü E-Mail auswählen zum Konfigurieren… die Option Zahlungsfehler-Benachrichtigung und klicken Sie auf Konfigurieren.
3. Lassen Sie Eine Benachrichtigungs-E-Mail an den Website-Administrator senden, wenn eine Zahlung fehlschlägt aktiviert.
4. Geben Sie unter Senden an die Adresse ein, die die Benachrichtigung erhalten soll. Standardmäßig ist dies die E-Mail-Adresse des Website-Administrators. Trennen Sie mehrere Adressen durch Kommas.
5. Bearbeiten Sie den Betreff und die Nachricht nach Belieben und klicken Sie dann auf Änderungen speichern.

Der Standardbetreff lautet Zahlung fehlgeschlagen auf {site name}. Die Standardnachricht enthält die E-Mail-Adresse des Kunden, den Betrag, den Formularnamen, den Grund für den Fehler und den Fehlercode.

Schritt 2: Aktivieren Sie die Kundenbestätigung (Optional)

1. Gehen Sie zu WP Simple Pay → Einstellungen → E-Mails.
2. Wählen Sie Zahlungsfehler-Bestätigung und klicken Sie auf Konfigurieren.
3. Aktivieren Sie Eine Bestätigungs-E-Mail an den Kunden senden, wenn eine Zahlung fehlschlägt.
4. Bearbeiten Sie den Betreff und die Nachricht nach Belieben und klicken Sie dann auf Änderungen speichern.

Die E-Mail wird immer an die E-Mail-Adresse des Kunden gesendet, daher kann das Feld Senden an nicht geändert werden. Der Standardbetreff lautet Ihre Zahlung konnte nicht verarbeitet werden.

Fehler-Smart-Tags

Beide E-Mails unterstützen die üblichen Smart-Tags wie {customer-email}, {total-amount} und {form-title} sowie zwei, die den Fehler beschreiben:

Smart-Tag	Beispiel	Beschreibung
{failure-reason}	Ihre Karte wurde abgelehnt.	Warum die Zahlung fehlgeschlagen ist.
{failure-code}	card_declined	Der Stripe-Fehlercode.

In der Kunden-E-Mail zeigt {failure-reason} nur die Nachricht an, die für Kunden bestimmt ist. Sie zeigt niemals die internen Notizen von Stripe für den Händler an. Wenn Stripe keinen Grund angibt, sagt die Kunden-E-Mail „Ihre Zahlung konnte nicht verarbeitet werden.“ und die Admin-E-Mail sagt „Unbekannt“.

Sendelimits

Um zu verhindern, dass ein Karten-Testangriff Ihren Posteingang überflutet oder Ihre Website zum E-Mailen von Fremden verwendet, wird jede E-Mail höchstens 10 Mal pro Formular pro Stunde gesendet. Fehler, die dieses Limit überschreiten, werden immer noch in Stripe aufgezeichnet, aber es wird keine E-Mail gesendet, bis die Stunde vorbei ist.

Entwickler können das Limit und das Zeitfenster mit diesen Filtern ändern:

• simpay_payment_failure_notification_email_rate_limit und simpay_payment_failure_confirmation_email_rate_limit legen die Anzahl der E-Mails fest (Standard 10, 0 schaltet das Limit aus).
• simpay_payment_failure_notification_email_rate_limit_window und simpay_payment_failure_confirmation_email_rate_limit_window legen das Fenster in Sekunden fest (Standard eine Stunde).

Jeder Filter empfängt den aktuellen Wert und die ID des Zahlungsformulars. Sehen Sie Benutzerdefinierten Code hinzufügen, wie Sie einen Filter sicher hinzufügen.

// Allow up to 25 admin failure notifications per form per hour.
add_filter( 'simpay_payment_failure_notification_email_rate_limit', function() {
	return 25;
} );

Häufig gestellte Fragen

Erhält der Kunde eine E-Mail, wenn seine Karte auf dem Zahlungsformular abgelehnt wird?

Ja, wenn Sie die Bestätigung des fehlgeschlagenen Zahlungsvorgangs aktivieren. Stripe meldet jede fehlgeschlagene Abbuchung, einschließlich einer Ablehnung, die der Kunde sofort auf dem Formular sieht. Wenn Sie nur möchten, dass Kunden über Fehler informiert werden, die auftreten, wenn sie nicht auf der Seite sind, wie z. B. Abonnementerneuerungen, lassen Sie die Kunden-E-Mail ausgeschaltet und behandeln Sie Erneuerungen mit den eigenen E-Mails für fehlgeschlagene Zahlungen von Stripe.

Warum habe ich keine Fehlermeldungs-E-Mail erhalten?

Überprüfen Sie, ob Webhooks eingerichtet sind und ob Stripe das Ereignis charge.failed als an Ihre Website geliefert anzeigt. Überprüfen Sie dann, ob das Formular das Limit von 10 E-Mails pro Stunde nicht erreicht hat. Wenn beides nicht zutrifft, siehe E-Mail-Belege und/oder Benachrichtigungen werden nicht gesendet.

Sind diese E-Mails in WP Simple Pay Lite verfügbar?

Nein. E-Mails bei fehlgeschlagenen Zahlungen sind Teil von WP Simple Pay Pro und auf allen kostenpflichtigen Lizenzen verfügbar.

Was kommt als Nächstes?

• Referenz zu E-Mail-Typen – Jede E-Mail, die WP Simple Pay senden kann
• Smart Tags für Bestätigungsseiten und E-Mails verwenden – Alle verfügbaren Smart Tags
• Webhooks – Stellen Sie sicher, dass Stripe Ihre Website erreichen kann