Les webhooks sont essentiels pour maintenir une communication en temps réel entre Adyen et vos systèmes intégrés. Lorsqu’un webhook échoue, certains statuts de transaction ou mises à jour peuvent ne pas être correctement reflétés dans votre environnement. Vous trouverez ci-dessous une approche de dépannage recommandée ainsi que des conseils pour les partenaires de la plateforme Adyen en cas de webhooks défaillants.
Scénario courant
Il peut arriver que certains événements webhook ne soient pas reçus ou traités, même si Adyen semble les avoir envoyés. Cela peut entraîner des mises à jour manquantes, telles que :
• Autorisations ou captures de paiement
• Remboursements
• Rétrofacturations (chargebacks)
• Changements de statut des versements (payouts)
Dans certains cas, un grand volume d’événements webhook peut être placé dans une file d’attente de reprise (retry queue), ce qui peut retarder ou bloquer les nouveaux événements jusqu’à ce que les précédents soient reconnus.
Étapes de dépannage recommandées
Si vous soupçonnez un échec ou un blocage des webhooks, suivez les étapes suivantes :
1. Vérifier les journaux de votre endpoint
• Vérifiez si votre endpoint a bien reçu les événements concernés.
• Consultez les codes de réponse — Adyen attend un statut 200 OK pour confirmer la réception.
• Les délais ou échecs répétés peuvent créer un arriéré, entraînant des délais d’attente (timeouts) ou des traitements ignorés.
2. Accéder aux journaux de notifications (via le Centre d’aide Adyen)
• Adyen n’affiche pas tous les journaux de livraison des webhooks dans le portail.
• Vous pouvez toutefois soumettre un ticket de support à Adyen et demander un examen des journaux de webhooks échoués pour votre compte commerçant ou votre identifiant webhook.
• Adyen peut confirmer si les événements ont été envoyés, combien de fois, et s’ils ont été correctement reconnus.
3. Renvoyer les webhooks
Si l’échec est confirmé :
• Il peut être nécessaire de renvoyer manuellement les notifications webhook.
• Adyen permet de renvoyer des événements individuels ou en lot via le Customer Area ou via l’API, si la fonctionnalité de reprise est activée.
Conseils de prévention proactive
• Surveillez régulièrement les journaux webhook sur vos serveurs afin de détecter les événements échoués ou non traités.
• Assurez-vous que vos endpoints HTTPS sont valides, sécurisés et capables de gérer des pics de notifications.
• Utilisez un mécanisme de file d’attente ou de mise en mémoire tampon pour traiter les volumes élevés de manière asynchrone.
• Envisagez d’implémenter une logique de reprise avec temporisation exponentielle (exponential backoff) afin d’éviter de surcharger votre système.
Vous rencontrez encore des problèmes ?
Si vous pensez que le problème de webhook provient d’Adyen ou que la file d’attente de reprise est bloquée :
• Soumettez une demande de support dans le portail Adyen en incluant :
Le nom de votre compte commerçant
L’endpoint webhook ou la clé HMAC
La période durant laquelle les événements étaient attendus mais non reçus
• Le support Adyen pourra examiner les journaux backend afin de confirmer l’état de livraison et recommander les prochaines étapes.
Exemple de cas d’utilisation
Un partenaire a constaté que les événements webhook n’atteignaient pas son endpoint, ce qui affectait le flux de transactions. Après analyse, Adyen a confirmé que les événements échouaient et étaient placés en file d’attente de reprise. Le renvoi des webhooks depuis Adyen a permis de vider la file d’attente et le partenaire a repris le traitement normal.