Wenn Sie eine E-Mail mit dem Betreff „[Ihre Website] PayPal-Spende(n) hängen im Schwebezustand“ erhalten, informiert Sie Charitable Pro darüber, dass eine oder mehrere PayPal-Spenden länger als erwartet auf die Zahlungsbestätigung warten. Dieser Artikel erklärt, was die E-Mail bedeutet, was Sie überprüfen sollten und wie Sie das Problem beheben können.
Verfügbar in Charitable Pro 1.8.13+.
Was die E-Mail bedeutet
Die E-Mail sieht so aus:
Subject: [Your Site Name] PayPal Donation(s) Stuck in Pending
The following PayPal donation(s) have been Pending for more than 24 hours
with no payment confirmation received:
#123456
Please check your PayPal account and update the donation status manually
if payment was received.
View donations: https://yoursite.com/wp-admin/edit.php?post_type=donation&post_status=charitable-pendingCharitable Pro überwacht Ihre PayPal-Spenden täglich. Wenn eine Spende länger als 24 Stunden im Status „Ausstehend“ verbleibt, ohne eine Zahlungsbestätigung von PayPal (genannt IPN oder Instant Payment Notification) zu erhalten, kennzeichnet es diese Spende und sendet diese Benachrichtigung an die E-Mail-Adresse des Administrators Ihrer Website.
Das bedeutet nicht, dass die Spende fehlgeschlagen ist. Es bedeutet, dass Charitable Pro noch keine Bestätigung von PayPal erhalten hat, dass die Zahlung abgeschlossen wurde. Der Spender hat möglicherweise bezahlt oder auch nicht – Sie müssen Ihr PayPal-Konto überprüfen, um dies herauszufinden.
Jede Spende wird nur einmal gekennzeichnet, sodass Sie keine wiederholten E-Mails über dieselbe Spende erhalten.
Warum das passiert
Wenn ein Spender eine PayPal-Zahlung abschließt, sendet PayPal im Hintergrund eine Benachrichtigung an Ihre Website. Charitable Pro empfängt diese Benachrichtigung und verwendet sie, um den Spendenstatus automatisch von „Ausstehend“ auf „Bezahlt“ zu aktualisieren.
Wenn diese Benachrichtigung nie ankommt, bleibt die Spende auf unbestimmte Zeit im Status „Ausstehend“. Die häufigsten Gründe dafür sind:
PayPal IPN ist nicht korrekt eingerichtet. IPN (Instant Payment Notification) muss in Ihrem PayPal-Konto aktiviert und auf Ihre Website verweisen. Wenn es deaktiviert oder falsch konfiguriert ist, erhält Charitable Pro niemals eine Bestätigung für eine PayPal-Spende.
Ein Sicherheitsprogramm oder eine Firewall blockiert die IPN-Anfrage. Einige Sicherheitstools auf Serverebene blockieren eingehende POST-Anfragen von externen Diensten, einschließlich der IPN-Callbacks von PayPal.
Der Spender hat seine Zahlung nicht abgeschlossen. Spender, die einen PayPal-Checkout starten, ihn aber vor der Bezahlung abbrechen, erstellen eine ausstehende Spende ohne nachfolgende IPN.
Die Zahlung ist tatsächlich in PayPal ausstehend. Bestimmte Zahlungstypen, wie z. B. eChecks oder Zahlungen, die von PayPal zur manuellen Überprüfung markiert wurden, verbleiben mehrere Tage im Schwebezustand in PayPal, bevor sie abgewickelt werden.
Schritt 1: Überprüfen Sie zuerst PayPal
Bevor Sie Maßnahmen in WordPress ergreifen, melden Sie sich bei Ihrem PayPal-Konto an und suchen Sie nach der Spende.
- Gehen Sie zu Ihrem PayPal-Konto und suchen Sie nach Transaktionen rund um das Datum und den Betrag der gekennzeichneten Spende.
- Prüfen Sie, ob die Zahlung eingegangen ist, in PayPal aussteht oder nicht existiert.
Wenn die Zahlung in PayPal eingegangen ist: Die IPN-Benachrichtigung ging auf dem Transportweg verloren. Sehen Sie sich Schritt 3: Spende manuell aktualisieren unten an und befassen Sie sich dann mit Ihrer IPN-Konfiguration, damit zukünftige Spenden automatisch bestätigt werden.
Wenn die Zahlung in PayPal aussteht (eCheck, Überprüfung usw.): Es ist noch keine Aktion erforderlich. Der Spendenstatus wird automatisch aktualisiert, sobald PayPal die Zahlung freigibt und die IPN sendet. Sie erhalten möglicherweise eine weitere Benachrichtigung, wenn sie für einen weiteren 24-Stunden-Zyklus ausstehend bleibt – aber beachten Sie, dass jede einzelne Spende nur einmal per E-Mail versendet wird, sodass es sich hierbei wahrscheinlich um eine neue Spende handelt.
Wenn keine Zahlung in PayPal vorhanden ist: Der Spender hat den Checkout wahrscheinlich abgebrochen. Sie können die Spende als Abgebrochen markieren oder sie als Ausstehend belassen. Es wurde keine Zahlung eingezogen.
Schritt 2: Überprüfen Sie Ihre IPN-Konfiguration
Wenn Sie festgestellt haben, dass die Zahlung in PayPal eingegangen ist, aber nicht in Charitable Pro angezeigt wird, muss Ihre IPN-Einrichtung überprüft werden. Dies ist auch proaktiv zu überprüfen, wenn Sie diese Benachrichtigung regelmäßig erhalten.
Vollständige Schritte zur Einrichtung und Überprüfung der IPN finden Sie in unserem Leitfaden zur Fehlerbehebung bei PayPal IPN.
Die wichtigsten Punkte, die zu überprüfen sind:
- IPN ist in Ihren PayPal-Kontoeinstellungen aktiviert
- Die IPN-Benachrichtigungs-URL ist festgelegt auf:
https://yoursite.com/?charitable-listener=paypal - Kein Sicherheitプラグイン (Wordfence, Sucuri usw.) blockiert POST-Anfragen von den IP-Bereichen von PayPal
- Ihre Website ist öffentlich zugänglich (nicht hinter einem Wartungsmodus oder Passwortschutz)
Schritt 3: Spende manuell aktualisieren
Wenn Sie bestätigt haben, dass die Zahlung in PayPal eingegangen ist, aktualisieren Sie den Spendenstatus in WordPress manuell.
- Klicken Sie auf den Link Spenden anzeigen in der E-Mail oder gehen Sie zu Spenden in Ihrem WordPress-Adminbereich und filtern Sie nach dem Status Ausstehend.
- Finden Sie die in der E-Mail aufgeführte Spende (identifiziert durch die
#Nummer). - Öffnen Sie die Spende.
- Ändern Sie den Status auf Bezahlt (oder den entsprechenden Status) und speichern Sie.
Dies löst keine weitere Zahlung aus – es aktualisiert lediglich den Datensatz, um die Zahlung widerzuspiegeln, die Sie bereits in PayPal bestätigt haben.
Wenn Sie weiterhin diese E-Mails erhalten
Das gelegentliche Erhalten dieser Benachrichtigung für eine einzelne Spende ist nicht ungewöhnlich. Wenn Sie sie jedoch regelmäßig für mehrere Spenden erhalten, ist dies ein Zeichen dafür, dass PayPal IPNs durchweg nicht auf Ihrer Website ankommen.
Häufige Ursachen und Lösungen:
IPN ist in PayPal deaktiviert. Melden Sie sich bei PayPal an, gehen Sie zu den Kontoeinstellungen, suchen Sie nach Instant Payment Notifications und aktivieren Sie es. Legen Sie die Benachrichtigungs-URL auf https://yoursite.com/?charitable-listener=paypal fest.
Ein Sicherheitプラグイン blockiert PayPal-Anfragen. Überprüfen Sie Ihre Firewall- oder Sicherheitプラグイン-Protokolle auf blockierte Anfragen von PayPal-IP-Adressen. Whitelisten Sie die IPN-Zustellungsserver von PayPal, falls erforderlich.
Ihre IPN-URL hat sich geändert. Wenn Sie Ihre Website kürzlich migriert, Ihre Domain geändert oder von HTTP zu HTTPS gewechselt haben, zeigt Ihre IPN-URL in PayPal möglicherweise auf die alte Adresse.
Eine vollständige Anleitung zur Diagnose und Behebung von IPN-Zustellungsproblemen finden Sie im Leitfaden zur Fehlerbehebung bei PayPal IPN.
Anpassen der Benachrichtigungsschwelle
Standardmäßig markiert Charitable Pro Spenden, die seit mehr als 24 Stunden ausstehend sind. Sie können diesen Schwellenwert mit dem charitable_stale_pending_hours Filter ändern.
Fügen Sie dies zur functions.php Datei Ihres Themes oder einem seitenbezogenen Plugin hinzu:
// Flag donations pending for more than 48 hours instead of 24.
add_filter( 'charitable_stale_pending_hours', function( $hours ) {
return 48;
} );Sie können dies auf jede beliebige Anzahl von Stunden einstellen. Eine höhere Einstellung gibt PayPal mehr Zeit, die IPN zu liefern, bevor Sie benachrichtigt werden, was nützlich sein kann, wenn Sie eChecks akzeptieren oder gelegentliche IPN-Verzögerungen feststellen.
Häufig gestellte Fragen
Erhalte ich eine zweite E-Mail über dieselbe Spende?
Nein. Jede Spende wird nur einmal markiert. Sobald Charitable Pro die Benachrichtigung für eine bestimmte Spende sendet, wird keine weitere Benachrichtigung für dieselbe Spende gesendet, auch wenn sie im Status „Ausstehend“ verbleibt.
Wer erhält die E-Mail?
Die E-Mail wird an die in WordPress unter Einstellungen > Allgemein > E-Mail-Adresse der Administration konfigurierte Admin-E-Mail-Adresse gesendet.
Kann ich diese E-Mails deaktivieren?
Es gibt keine Ein-/Aus-Schaltfläche in der Einstellungs-Oberfläche. Um die E-Mails zu deaktivieren, können Sie den Hook entfernen, der sie sendet:
add_action( 'init', function() {
$cron = Charitable_Cron::get_instance();
remove_action( 'charitable_daily_scheduled_events', array( $cron, 'check_stale_pending_donations' ) );
} );Wir empfehlen, das zugrunde liegende IPN-Problem zu lösen, anstatt die Benachrichtigungen zu deaktivieren, da die Benachrichtigungen dazu dienen, übersehene Spenden nicht unbemerkt zu lassen.
Die Spenden-ID in der E-Mail stimmt nicht mit dem überein, was ich in PayPal sehe. Wie finde ich die richtige Transaktion?
Die Nummer in der E-Mail (z. B. #123456) ist die WordPress-Spendennummer, nicht eine PayPal-Transaktionsnummer. Um die entsprechende PayPal-Transaktion zu finden, öffnen Sie die Spende in Ihrem WordPress-Adminbereich und suchen Sie nach der PayPal-Transaktions- oder Rechnungsreferenz, die in den Spenden-Details gespeichert ist. Sie können dann nach dieser Referenz in Ihrer PayPal-Kontoaktivität suchen.
Support kontaktieren
Wenn Sie alle oben genannten Anweisungen befolgt haben und immer noch Probleme auftreten, kontaktieren Sie den Support.
