Exigences de réseau pour Terminal

Assurez-vous que votre réseau est prêt pour Terminal et résolvez les problèmes courants.

Les exigences du réseau Terminal varient en fonction des lecteurs que vous utilisez et de la structure de votre intégration. Si votre réseau ne répond pas aux exigences énoncées ci-dessous, votre intégration Terminal ne fonctionnera pas comme prévu.

Si vous prévoyez d’utiliser des lecteurs Terminal dans des lieux reculés où les conditions du réseau sont inhabituelles ou inconnues, préparez-vous à traiter des problèmes de réseau inattendus. Lorsque vous utilisez des lecteurs intelligents, nous recommandons une intégration pilotée par serveur afin de limiter le nombre de problèmes de réseau que vous pourriez rencontrer.

Lecteurs mobiles

Les lecteurs mobiles dépendent de votre appareil de point de vente pour la connectivité Internet et doivent répondre aux exigences suivantes en matière de réseau :

Votre appareil de point de vente doit être connecté à Internet, et doit être en mesure de se connecter à l’infrastructure de Stripe.
L’environnement d’exploitation doit être exempt d’interférences qui empêcheraient les appareils Bluetooth de fonctionner normalement (par exemple, l’utilisation excessive d’un four à micro-ondes produit des interférences sur la bande de 2,4 GHz et peut perturber les connexions Bluetooth).

Les lecteurs mobiles suivants sont disponibles.

Lecteurs intelligents

Leslecteurs intelligents se connectent directement à votre réseau et utilisent cette connexion pour accéder à Internet et à Stripe. Lorsque vous utilisez l’un de nos SDK Terminal, votre appareil de point de vente communique directement avec le lecteur intelligent sur votre réseau local.

Les lecteurs intelligents suivants sont disponibles.

Les lecteurs intelligents doivent répondre aux exigences suivantes en matière de réseau :

Votre réseau doit être compatible IPv4.
- Les réseaux exclusivement IPv6 ne sont pas pris en charge.
- Certains lecteurs peuvent se connecter à des réseaux IPv6 via le protocole DHCP, mais une adresse IPv4 doit également leur être attribuée. La modification des paramètres avancés tels que l’IP statique, le routeur, le masque de sous-réseau et le DNS n’est pas prise en charge avec IPv6.
Une adresse IP privée doit être attribuée aux lecteurs Terminal.
Le lecteur Terminal et votre appareil de point de vente doivent tous deux être en mesure de se connecter à l’infrastructure de Stripe.
Si vos lecteurs Terminal prennent en charge à la fois le Wi-Fi et l’Ethernet, utilisez l’un ou l’autre, mais pas les deux. L’utilisation simultanée du Wi-Fi et de l’Ethernet entraîne une connexion instable et des temps d’arrêt intermittents.
- Si vous utilisez le Wi-Fi, vous pouvez utiliser une station d’accueil sans connecter de câble Ethernet (par exemple, pour la recharge ou les accessoires uniquement).
Vos réseaux Wi-Fi doivent utiliser un chiffrement WPA/WPA2/WPA3-Personal ou WPA2/WPA3 EAP-PEAP Enterprise, et être protégés par un mot de passe.
- Les lecteurs Terminal ne prennent pas en charge le Wi-Fi 6, également connu sous le nom de 802.11ax.
- Les lecteurs Verifone P400 ne prennent en charge que le chiffrement WPA-Personal ou WPA2-Personal.
Les réseaux Ethernet doivent prendre en charge les appareils 10/100 Ethernet.
Si votre réseau utilise l’attribution dynamique d’adresses IP, la configuration de votre serveur DHCP doit permettre aux lecteurs Terminal de conserver la même adresse IP pendant au moins une journée de travail entière.
Si votre réseau limite la durée des sessions réseau (y compris les sessions d’inactivité), les sessions pour les lecteurs Terminal doivent durer au moins une journée de travail entière.
Si vous utilisez l’un de nos SDK Terminal sur un appareil de point de vente distinct (par exemple, pas une application exécutée sur le lecteur Terminal lui-même), vous devez également répondre aux exigences suivantes :
- Le lecteur doit se trouver sur le même réseau local que votre appareil de point de vente.
- Le lecteur doit pouvoir communiquer directement avec votre appareil de point de vente via votre réseau local.
- Les serveurs DNS utilisés par votre appareil de point de vente doivent être en mesure de résoudre les noms d’hôtes routables via Internet en adresses IP locales.

Résolution des problèmes

Lorsque des problèmes liés au réseau surviennent, du personnel expérimenté doit être physiquement présent pour diagnostiquer et corriger les problèmes. Veillez à en tenir compte lors de la planification de votre intégration, déploiement et maintenance de Terminal.

Remarque

En raison de la grande variété de configurations et d’infrastructures de réseau, Stripe ne peut vous apporter qu’une assistance élémentaire dans ce domaine. Le fonctionnement et le dépannage de votre réseau relèvent de votre responsabilité.

Si vous rencontrez un problème, déterminez s’il est lié au réseau ou à autre chose. Pour vérifier si le réseau est à l’origine du problème, connectez momentanément un ou plusieurs de vos lecteurs Terminal et appareils de point de vente à un autre réseau et une autre connexion Internet et vérifiez si cela engendre le même problème. Les points d’accès mobiles fonctionnent bien pour ce type de test.

Si le problème persiste sur un autre réseau et une autre connexion Internet, effectuez des tests supplémentaires et déboguez le code de votre intégration. Si vous avez besoin d’aide, contactez le service Support et fournissez autant de détails techniques que possible (par exemple, les messages d’erreur, les logs, etc.).

Si le problème survient uniquement sur votre réseau, essayez ce qui suit :

Assurez-vous que votre réseau répond à toutes les exigences énoncées ci-dessus, en particulier si un élément du réseau a été modifié récemment.
Vérifiez votre pare-feu et autres configurations de sécurité pour vous assurer que l’accès à l’infrastructure de Stripe n’est pas bloqué.
Essayez de connecter le lecteur Terminal et votre appareil de point de vente d’une autre manière (par exemple, passez du Wi-Fi à l’Ethernet).
Pour le Wi-Fi, assurez-vous que la puissance du signal de tous les appareils est suffisamment forte.
Pour l’Ethernet, essayez d’utiliser des câbles réseau différents.
Vérifiez si l’adresse IP et le sous-réseau attribués aux lecteurs intelligents sont corrects.
Si vous utilisez des lecteurs intelligents et notre SDK Terminal sur un autre appareil de point de vente :
- Sur votre appareil point de vente, essayez de résoudre 10-42-42-42.test.device.stripe-terminal-local-reader.net en adresse IP. Ce nom d’hôte doit être résolu à l’adresse IP 10.42.42.42. Si l’adresse IP est différente ou si la résolution DNS échoue, configurez votre appareil de point de vente pour qu’il utilise les serveurs DNS Cloudflare (1.1.1.1 et 1.0.0.1) ou les serveurs DNS Google (8.8.8.8 et 8.8.4.4), puis réessayez.
- Vérifiez la configuration de votre routeur pour voir si les connexions entre les clients sans fil (Wi-Fi) et les clients câblés (Ethernet) sont bloquées.
- Assurez-vous de pouvoir envoyer un ping à l’adresse IP du lecteur Terminal à partir de votre appareil de point de vente.