Assurer la fonctionnalité du SDK JavaScript Stripe Terminal sur macOS 15

Présentation

Avec la dernière mise à jour de macOS 15 (Sequoia), Apple a introduit des changements affectant les connexions au réseau local. Plus précisément, pour les applications telles que le SDK JavaScript Stripe Terminal, qui nécessitent un accès au réseau local, les utilisateurs doivent accorder des autorisations explicites pour que leurs applications de navigateur détectent et communiquent avec les appareils sur le réseau local. Le présent guide décrit les étapes nécessaires pour s'assurer que le Stripe Terminal se connecte comme prévu.

Problème fréquent

Lors de la mise à niveau vers macOS 15, les utilisateurs peuvent rencontrer des problèmes liés à l'impossibilité pour le SDK JavaScript Stripe Terminal de se connecter aux lecteurs sur le réseau local. Cela est dû aux nouveaux paramètres de confidentialité, qui exigent une autorisation explicite pour l'accès au réseau local.

Étapes de résolution

1) Autoriser l'accès dès la première invite :

  1. Lorsque vous lancez pour la première fois une application de navigateur (par exemple, Google Chrome) qui tente de communiquer avec un périphérique de réseau local, vous recevez une invite comme celle ci-dessous :

google chrome allow image.png

  1. Action : cliquez sur Autoriser pour octroyer l'accès au réseau local.

Remarque : si l'option « Ne pas autoriser » est sélectionnée, le SDK JavaScript Stripe Terminal ne fonctionnera pas comme prévu.

2) Octroyer l'accès manuellement :

Si vous avez initialement cliqué sur « Ne pas autoriser » ou si vous devez autoriser l'accès ultérieurement, procédez comme suit :

  1. Ouvrez les Réglages Système sur votre appareil macOS.
  2. Accédez à Confidentialité et sécurité.
  3. Sélectionnez l'option Réseau local .
  4. Localisez l'application de votre navigateur (par exemple, Google Chrome) dans la liste et actionnez le bouton bascule pour autoriser l'accès au réseau local.

Screenshot_2024-10-21_at_9.19.37aAM.png

Informations supplémentaires

Le SDK JavaScript Stripe Terminal rencontre des erreurs DNS lorsqu'il se connecte à un lecteur Internet

Exigences relatives au réseau des lecteurs intelligents Stripe Terminal

Mon application de point de vente ne parvient pas à se connecter à un lecteur intelligent par le biais des SDK Terminal