Si vous déployez des terminaux de paiement Adyen avec une intégration POS ValPay, votre réseau doit être configuré correctement afin que le POS, le terminal et la plateforme Adyen puissent communiquer de manière sécurisée et fiable. Adyen exige un accès sortant vers certains domaines et ports, prend uniquement en charge les versions modernes de TLS et recommande des configurations spécifiques d’adresses IP selon que vous utilisez des communications locales ou infonuagiques.

Cet article s’adresse aux partenaires ValPay qui effectuent l’intégration ou le soutien de commerçants utilisant des terminaux Adyen avec une intégration de point de vente ValPay.

Assurez-vous de savoir si votre configuration utilise :

Communications locales

L’application POS communique directement avec le terminal sur le réseau local.

Communications infonuagiques (cloud)

L’application POS communique avec les points d’accès infonuagiques d’Adyen, qui communiquent ensuite avec le terminal.

Adyen précise que les paiements hors ligne sont seulement disponibles pour les intégrations utilisant les communications locales.

Votre pare-feu doit autoriser le trafic HTTPS sortant depuis les adresses IP de vos appareils POS et terminaux de paiement vers les domaines suivants :

Adyen recommande d’autoriser l’accès par nom DNS, et non par adresse IP codée en dur, puisque les adresses IP d’Adyen peuvent changer et ne sont pas publiquement publiées.

Votre pare-feu devrait actualiser les changements DNS au moins toutes les 60 secondes.

Important :

Ne configurez pas les règles du pare-feu avec des adresses IP Adyen statiques. Ces adresses peuvent changer et ne sont pas partagées publiquement.

Assurez-vous que les ports suivants sont ouverts :

Ces ports sont nécessaires pour permettre une communication sécurisée entre l’environnement POS, les terminaux et les services Adyen.

Si votre intégration ValPay utilise des communications locales, Adyen exige que :

Bonne pratique :

Dans les configurations utilisant les communications locales, assurez-vous que la segmentation Wi-Fi du commerce ou les règles VLAN ne bloquent pas le trafic entre l’appareil POS et le terminal.

Adyen utilise TLS 1.2 pour la transmission sécurisée des données sur Internet.

Si vous utilisez TLS 1.0 ou TLS 1.1 pour les communications locales, les terminaux exécutant la version logicielle 1.81 ou plus récente ne pourront pas traiter les transactions.

Les points d’accès infonuagiques d’Adyen n’acceptent pas non plus les versions TLS inférieures à 1.2.

Suites de chiffrement TLS 1.2 prises en charge :

Recommandation pour les partenaires :

Assurez-vous que toute l’infrastructure du magasin, les solutions intermédiaires (middleware) et les environnements POS locaux prennent en charge TLS 1.2 ou TLS 1.3 avant la mise en production.

Pour envoyer les paiements pour autorisation en ligne, chaque terminal doit avoir une adresse IP valide.

Adyen prend en charge trois options :

IP dynamique

Attribuée automatiquement par DHCP.

Réservation DHCP

Le serveur DHCP attribue toujours la même adresse IP en fonction de l’adresse MAC du terminal.

IP statique

L’adresse IP est configurée manuellement sur le terminal.

Adyen précise également :

Pour la plupart des environnements gérés par des partenaires :

Adyen recommande également de configurer une durée de bail DHCP d’au moins 24 heures lorsque possible.

Dans les configurations utilisant les communications locales, si un terminal se reconnecte à un autre point d’accès ou rencontre un problème réseau, son adresse IP peut changer.

Cela peut entraîner une perte de connexion entre le POS et le terminal.

Adyen propose une fonctionnalité optionnelle webhook qui envoie la nouvelle adresse IP lorsque le terminal revient en ligne.

Le webhook inclut :

Pour activer cette fonctionnalité, Adyen demande aux commerçants ou partenaires de contacter leur équipe de support et de fournir :

Note ValPay :

Cette fonctionnalité est particulièrement utile pour les partenaires utilisant les communications locales, où la stabilité de l’adresse IP du terminal est importante.

Adyen recommande les pratiques suivantes pour réduire les problèmes de connectivité :

Avant la mise en production, confirmez les éléments suivants :

Si un partenaire ValPay ou un commerçant ne peut pas traiter de transactions, vérifiez d’abord :