Si vous recevez un e-mail avec l'objet « Dons PayPal de [Votre site] bloqués en attente », Charitable Pro vous informe qu'un ou plusieurs dons PayPal attendent une confirmation de paiement plus longtemps que prévu. Cet article explique ce que signifie l'e-mail, ce qu'il faut vérifier et comment résoudre le problème.
Disponible dans Charitable Pro 1.8.13+.
Ce que signifie l'e-mail
L'e-mail ressemble à ceci :
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 surveille vos dons PayPal quotidiennement. Lorsqu'un don reste en statut En attente pendant plus de 24 heures sans recevoir de confirmation de paiement de la part de PayPal (appelée IPN, ou Instant Payment Notification), il signale ce don et envoie cette alerte à l'adresse e-mail de l'administrateur de votre site.
Cela ne signifie pas que le don a échoué. Cela signifie que Charitable Pro n'a pas encore reçu de confirmation de PayPal indiquant que le paiement a été effectué. Le donateur a peut-être payé ou non – vous devrez vérifier votre compte PayPal pour le savoir.
Chaque don n'est signalé qu'une seule fois, vous ne recevrez donc pas d'e-mails répétés concernant le même don.
Pourquoi cela se produit
Lorsqu'un donateur effectue un paiement PayPal, PayPal envoie une notification à votre site en arrière-plan. Charitable Pro reçoit cette notification et l'utilise pour mettre à jour automatiquement le statut du don de En attente à Payé.
Si cette notification n'arrive jamais, le don reste indéfiniment en attente. Les raisons les plus courantes pour lesquelles cela se produit :
L'IPN de PayPal n'est pas correctement configuré. L'IPN (Instant Payment Notification) doit être activé dans votre compte PayPal et pointé vers votre site. S'il est désactivé ou mal configuré, Charitable Pro ne recevra jamais de confirmation pour aucun don PayPal.
Un plugin de sécurité ou un pare-feu bloque la requête IPN. Certains outils de sécurité au niveau du serveur bloquent les requêtes POST entrantes provenant de services externes, y compris les rappels IPN de PayPal.
Le donateur n'a pas finalisé son paiement. Les donateurs qui commencent un paiement PayPal mais l'abandonnent avant de payer créeront un don en attente sans IPN à suivre.
Le paiement est réellement en attente dans PayPal. Certains types de paiement, tels que les eChecks ou les paiements signalés pour examen manuel par PayPal, restent en état d'attente dans PayPal pendant plusieurs jours avant d'être validés.
Étape 1 : Vérifiez d'abord PayPal
Avant de prendre toute mesure dans WordPress, connectez-vous à votre compte PayPal et recherchez le don.
- Accédez à votre compte PayPal et recherchez les transactions autour de la date et du montant du don signalé.
- Vérifiez si le paiement a été reçu, est en attente dans PayPal, ou n'existe pas.
Si le paiement a été reçu dans PayPal : La notification IPN a été perdue en transit. Voir Étape 3 : Mettre à jour le don manuellement ci-dessous, puis configurez votre IPN afin que les futurs dons soient confirmés automatiquement.
Si le paiement est en attente dans PayPal (eCheck, examen, etc.) : Aucune action n'est nécessaire pour le moment. Le statut du don sera mis à jour automatiquement une fois que PayPal aura traité le paiement et envoyé l'IPN. Vous pourriez recevoir une autre alerte si le paiement reste en attente pendant un autre cycle de 24 heures — mais notez que chaque don unique n'est envoyé par e-mail qu'une seule fois, il est donc plus probable qu'il s'agisse d'un nouveau don.
Si aucun paiement n'existe dans PayPal : Le donateur a probablement abandonné le processus de paiement. Vous pouvez marquer le don comme Annulé ou le laisser en Attente. Aucun paiement n'a été collecté.
Étape 2 : Vérifiez votre configuration IPN
Si vous avez constaté qu'un paiement a été reçu dans PayPal mais n'est pas reflété dans Charitable Pro, votre configuration IPN nécessite une attention particulière. Il est également utile de vérifier cela de manière proactive si vous recevez régulièrement cette alerte.
Pour les étapes complètes de configuration et de vérification de l'IPN, consultez notre guide de dépannage de l'IPN PayPal.
Les points clés à vérifier :
- L'IPN est activé dans les paramètres de votre compte PayPal
- L'URL de notification IPN est définie sur :
https://yoursite.com/?charitable-listener=paypal - Aucun plugin de sécurité (Wordfence, Sucuri, etc.) ne bloque les requêtes POST des plages d'adresses IP de PayPal
- Votre site est accessible publiquement (pas derrière un mode de maintenance ou une protection par mot de passe)
Étape 3 : Mettez à jour le don manuellement
Si vous avez confirmé que le paiement a été reçu dans PayPal, mettez à jour manuellement le statut du don dans WordPress.
- Cliquez sur le lien Voir les dons dans l'e-mail, ou allez dans Dons dans votre administration WordPress et filtrez par statut En attente.
- Trouvez le don listé dans l'e-mail (identifié par le numéro
#). - Ouvrez le don.
- Changez le statut en Payé (ou le statut approprié) et enregistrez.
Cela ne déclenchera pas un nouveau paiement — cela met simplement à jour l'enregistrement pour refléter le paiement que vous avez déjà confirmé dans PayPal.
Si vous continuez à recevoir ces e-mails
Recevoir cette alerte occasionnellement pour un seul don n'est pas inhabituel. Mais si vous la recevez régulièrement pour plusieurs dons, c'est le signe que les IPN PayPal n'atteignent pas constamment votre site.
Causes et solutions courantes :
L'IPN est désactivé dans PayPal. Connectez-vous à PayPal, allez dans les Paramètres du compte, trouvez les Notifications de paiement instantané et activez-les. Définissez l'URL de notification sur https://yoursite.com/?charitable-listener=paypal.
Un plugin de sécurité bloque les requêtes PayPal. Vérifiez les journaux de votre pare-feu ou de votre plugin de sécurité pour les requêtes bloquées provenant des adresses IP de PayPal. Ajoutez les serveurs de livraison IPN de PayPal à la liste blanche si nécessaire.
Votre URL IPN a changé. Si vous avez récemment migré votre site, changé de domaine ou êtes passé de HTTP à HTTPS, votre URL IPN dans PayPal peut pointer vers l'ancienne adresse.
Pour une présentation complète du diagnostic et de la résolution des problèmes de livraison IPN, consultez le guide de dépannage de l'IPN PayPal.
Ajustement du seuil de notification
Par défaut, Charitable Pro signale les dons qui sont en attente depuis plus de 24 heures. Vous pouvez modifier ce seuil en utilisant le filtre charitable_stale_pending_hours.
Ajoutez ceci au fichier functions.php de votre thème ou à un plugin spécifique au site :
// Flag donations pending for more than 48 hours instead of 24.
add_filter( 'charitable_stale_pending_hours', function( $hours ) {
return 48;
} );Vous pouvez définir ce nombre à n'importe quelle heure. Le définir plus haut donne plus de temps à PayPal pour livrer l'IPN avant que vous ne soyez averti, ce qui peut être utile si vous acceptez des eChecks ou si vous constatez des retards occasionnels de l'IPN.
Questions fréquemment posées
Recevrai-je un deuxième e-mail concernant le même don ?
Non. Chaque don n'est signalé qu'une seule fois. Une fois que Charitable Pro envoie l'alerte pour un don spécifique, il n'enverra pas d'autre alerte pour ce même don, même s'il reste en attente.
Qui reçoit l'e-mail ?
L'e-mail est envoyé à l'adresse e-mail de l'administrateur configurée dans WordPress sous Paramètres > Général > Adresse e-mail d'administration.
Puis-je désactiver ces e-mails ?
Il n'y a pas d'interrupteur marche/arrêt dans l'interface des paramètres. Pour désactiver les e-mails, vous pouvez supprimer le hook qui les envoie :
add_action( 'init', function() {
$cron = Charitable_Cron::get_instance();
remove_action( 'charitable_daily_scheduled_events', array( $cron, 'check_stale_pending_donations' ) );
} );Nous vous recommandons de résoudre le problème IPN sous-jacent plutôt que de désactiver les alertes, car les alertes existent pour éviter que les dons manqués ne passent inaperçus.
L'ID du don dans l'e-mail ne correspond pas à ce que je vois dans PayPal. Comment trouver la bonne transaction ?
Le numéro dans l'e-mail (par exemple, #123456) est l'ID du don WordPress, pas un ID de transaction PayPal. Pour trouver la transaction PayPal correspondante, ouvrez le don dans votre administration WordPress et recherchez la référence de transaction ou de facture PayPal stockée dans les détails du don. Vous pourrez ensuite rechercher cette référence dans l'activité de votre compte PayPal.
Contacter le support
Si vous avez suivi toutes les instructions ci-dessus et que vous rencontrez toujours des problèmes, contactez le support.
