Aperçu
Lors de l’utilisation de terminaux de paiement Adyen intégrés à un système POS, vous pouvez parfois rencontrer des erreurs telles que :
« Terminal ne répond pas »
Transactions interrompues ou incomplètes
Le POS se fige après les invites EMV
Le terminal se reconnecte uniquement après le redémarrage du POS
Dans de nombreux cas, ces problèmes sont causés par des interruptions de connectivité réseau entre le système POS et le terminal de paiement, plutôt que par un problème matériel ou de configuration du terminal.
Ce guide présente la cause la plus fréquente ainsi que les étapes de dépannage recommandées.
Cause fréquente : expiration de session réseau
Les intégrations POS Adyen reposent généralement sur une connexion réseau persistante entre le système POS et le terminal, utilisant l’API Terminal.
Le POS maintient une session active avec le terminal afin de :
Envoyer des demandes de transaction
Effectuer des vérifications d’état
Traiter les annulations
Recevoir les réponses de transaction
Si le réseau interrompt ou coupe cette connexion, le POS peut perdre la communication avec le terminal et afficher des erreurs telles que « terminal ne répond pas ».
Cela peut également entraîner :
Des transactions qui semblent bloquées après l’interaction avec la carte
L’obligation de redémarrer le POS avant de pouvoir se reconnecter au terminal
Des vérifications d’état qui échouent de façon intermittente
Causes réseau courantes
Ces problèmes sont le plus souvent liés à l’infrastructure réseau du commerçant, notamment :
Expiration de session du pare-feu
Certains pare-feux ferment automatiquement les connexions inactives après une certaine période (par exemple 1 à 5 minutes). Lorsque cela se produit, le système POS perd sa session avec le terminal de paiement.
Appareils de sécurité réseau
Certains appareils de sécurité, tels que :
SonicWall
Fortinet
Cisco Umbrella
Sophos
Meraki
peuvent interrompre les connexions persistantes utilisées par les terminaux de paiement.
Commutateurs réseau gérés
Les commutateurs gérés peuvent introduire :
filtrage du trafic
délais d’expiration de connexion
inspection du trafic réseau
ce qui peut interrompre la communication avec le terminal.
Étapes de dépannage
1. Vérifier l’état du terminal dans l’Espace client Adyen
Confirmez que le terminal apparaît En ligne dans l’Espace client Adyen.
Étapes :
Connectez-vous à l’Espace client Adyen
Accédez à Paiements en personne
Sélectionnez Appareils de paiement
Localisez le terminal à l’aide du numéro de série
Vérifiez les informations suivantes :
État de l’appareil
Horodatage de la dernière activité
Type de connexion (Ethernet, Wi-Fi, cellulaire)
Des changements fréquents dans l’activité ou la connectivité peuvent indiquer une instabilité du réseau.
2. Consulter les journaux d’activité ou d’événements du terminal
Vérifiez les journaux du terminal pour repérer des indicateurs tels que :
Perte de connexion
Reconnexion au réseau
Interruptions de session
Ces événements peuvent aider à déterminer si le terminal perd la connectivité avec le POS ou la plateforme Adyen.
3. Confirmer la version logicielle du terminal
Un logiciel de terminal obsolète peut parfois affecter les intégrations ou les fonctionnalités de support à distance.
Assurez-vous que le terminal fonctionne avec une version du micrologiciel prise en charge et à jour.
Test réseau recommandé
Un moyen rapide de déterminer si le réseau du commerçant est à l’origine du problème consiste à effectuer un test avec un point d’accès mobile (hotspot).
Étapes
Activez un point d’accès mobile sur un téléphone.
Connectez un terminal de paiement au point d’accès.
Effectuez plusieurs transactions.
Résultats
Si le terminal fonctionne normalement via le point d’accès, le problème est probablement lié à la configuration réseau du commerçant.
Si le problème persiste, un dépannage supplémentaire peut être nécessaire.
Considérations de configuration réseau
Si des restrictions réseau sont suspectées, l’équipe TI du commerçant peut devoir s’assurer que les connexions sortantes suivantes sont autorisées :
Port TCP 443
Port TCP 8443
De plus, les pare-feux ou appareils de sécurité doivent permettre des connexions sortantes persistantes vers les services Adyen.
Bonnes pratiques
Pour maintenir une connectivité stable du terminal :
Éviter les délais d’expiration agressifs des sessions du pare-feu
S’assurer que les appareils réseau permettent des connexions sortantes persistantes
Maintenir le micrologiciel du terminal à jour
Utiliser des connexions filaires stables lorsque possible pour les terminaux fixes
Quand contacter le support
Si les problèmes persistent après avoir suivi les étapes de dépannage ci-dessus, rassemblez les informations suivantes avant de contacter le support :
Modèle et numéro de série du terminal
Description du message d’erreur
Heure de la dernière occurrence
Système POS utilisé
Détails de l’environnement réseau
Ces informations permettront d’accélérer le processus de dépannage.