- Qu'est-ce qu'une notification de paiement ?
- Une erreur de notification n'affecte pas votre encaissement
- Comment savoir si je suis concerné ?
- Les 3 réflexes à vérifier
- Une notification échouée ne peut pas être renvoyée
- Tableau de référence des codes de réponse
-
Besoin d'aide ?
Qu'est-ce qu'une notification de paiement ?
La notification de paiement (IPN) est le message que les serveurs de PayPlug envoient à votre site à chaque paiement ou remboursement. Elle transmet l'information de paiement et déclenche la mise à jour du statut de la commande dans votre back-office.
En fonctionnement normal, la transaction affiche un code de réponse 200 : le paiement est encaissé et l'information a bien été transmise à votre site.
Une erreur de notification n'affecte pas votre encaissement
Une erreur de notification n'a aucune incidence sur la réception du paiement sur votre compte PayPlug. Elle indique seulement que l'information n'a pas pu être transmise correctement à votre site, et donc que la commande peut ne pas s'être mise à jour automatiquement.
Comment savoir si je suis concerné ?
Deux moyens :
- Vous recevez un e-mail automatique de PayPlug vous signalant l'erreur.
- Dans votre portail PayPlug, menu Paiements, cliquez sur la ligne du paiement : le code de réponse de notification est affiché dans le détail du paiement.
Les 3 réflexes à vérifier
La grande majorité des erreurs de notification vient de l'une de ces trois causes.
1. Votre URL de notification est-elle accessible depuis l'extérieur ? Elle doit être publiquement joignable, accepter les requêtes POST entrantes, et ne pas être protégée par une authentification (.htaccess, mot de passe, page de préproduction). Vérifiez aussi que votre site n'est pas en mode maintenance.
2. Les serveurs de notification PayPlug sont-ils autorisés ? C'est aujourd'hui la cause la plus fréquente. Un pare-feu, un WAF (ex. Cloudflare) ou un module/plugin de sécurité (ex. SecuPress, Wordfence) peut bloquer nos serveurs et faire échouer la notification. Vous devez autoriser les adresses IP de notification de PayPlug dans votre pare-feu et vos outils de sécurité :
| Région | Adresses IP |
|---|---|
Irlande (eu-west-1) |
52.17.55.154, 52.209.87.92, 54.77.126.191
|
Autorisez l'ensemble de ces IP : les notifications peuvent provenir de l'une ou l'autre région.
3. Votre module PayPlug est-il à jour et correctement installé ? Une version obsolète ou une installation incomplète peut renvoyer une erreur. Vérifiez que vous utilisez la dernière version du module, et au besoin désinstallez/réinstallez-le. Contrôlez également les permissions des fichiers (0644) et des dossiers (0755) du module.
Une notification échouée ne peut pas être renvoyée
Il n'est pas possible de renvoyer une notification une fois qu'elle a échoué, et elle n'est pas réémise automatiquement.
Concrètement : une fois le blocage corrigé, seules les notifications à venir seront transmises correctement. Pour les commandes déjà impactées, vous devez mettre à jour leur statut manuellement, en vous appuyant sur le menu Paiements de votre portail PayPlug pour retrouver les transactions concernées.
Tableau de référence des codes de réponse
Si vous voulez comprendre le code affiché sur votre transaction :
| Code | Signification | Cause fréquente | Ce qu'il faut vérifier |
|---|---|---|---|
| 200 | OK | — | Rien, tout est bon |
| 301 / 302 | Redirection | Passage HTTP→HTTPS, refonte, changement d'URL | Notre serveur ne suit pas les redirections : renseignez l'URL finale, sans redirection |
| 400 | Requête invalide | URL mal formée | Vérifiez l'URL ; interrogez votre hébergeur si offre SaaS/intégrée |
| 401 | Authentification requise | URL ou site protégé par .htaccess
|
Rendez l'URL de notification accessible sans authentification |
| 403 | Accès refusé | Pare-feu / WAF / module de sécurité bloquant | Autorisez les IP PayPlug (voir réflexe n°2) ; autorisez le POST entrant |
| 404 | Ressource introuvable | URL renommée ou supprimée | Vérifiez vos URL de retour/notification ; réinstallez le module |
| 405 | Méthode non autorisée | URL erronée ou mauvais verbe HTTP (GET au lieu de POST) | Vérifiez l'URL et que le POST est accepté |
| 500 | Erreur interne serveur | Config serveur, permissions, fichiers manquants | Consultez vos logs serveur ; vérifiez permissions et .htaccess ; passez en revue vos changements récents |
| 502 | Bad gateway | DNS, serveur d'origine injoignable, pare-feu | Vérifiez la résolution DNS et l'accessibilité du serveur ; autorisez les IP PayPlug |
| 503 | Service indisponible | Serveur surchargé, en maintenance, ou sous-dimensionné | Vérifiez la disponibilité et le dimensionnement de votre hébergement |
Besoin d'aide ?
Si le problème persiste après ces vérifications, contactez le support PayPlug en précisant l'ID de transaction concerné et le code de réponse affiché.