Verifica della funzionalità dell'SDK JavaScript di Stripe Terminal su macOS 15

Panoramica

Con l'ultimo aggiornamento macOS 15 (Sequoia), Apple ha introdotto alcune modifiche che influiscono sulle connessioni di rete locale. In particolare, per le applicazioni come l'SDK JavaScript di Stripe Terminal, che richiedono l'accesso alla rete locale, gli utenti devono concedere esplicitamente le autorizzazioni per consentire alle app del browser di rilevare e comunicare con i dispositivi sulla rete locale. Questa guida indica la procedura necessaria per stabilire correttamente la connessione con Stripe Terminal.

Problema comune

Con l'upgrade a macOS 15, gli utenti potrebbero riscontrare problemi di connessione tra l'SDK JavaScript di Stripe Terminal e i lettori sulla rete locale. Tali problemi sono legati alle nuove impostazioni per la privacy che richiedono autorizzazioni esplicite per l'accesso alla rete locale.

Procedura di risoluzione

1) Consenti l'accesso nel primo avviso:

  1. quando apri la prima volta l'app del browser (ad es.: Google Chrome) che tenta di comunicare con un dispositivo sulla rete locale, visualizzerai un avviso simile a quello riportato sotto:

google chrome allow image.png

  1. Azione: fai clic su Consenti per concedere l'accesso alla rete locale.

Nota: Se selezioni Non consentire, l'SDK JavaScript di Stripe Terminal non funzionerà come previsto.

2) Concedi l'accesso manualmente:

Se nel primo avviso hai selezionato Non consentire o se hai bisogno di concedere l'accesso in un momento successivo, segui questa procedura:

  1. Apri le Impostazioni di sistema sul dispositivo macOS.
  2. Vai alla sezione Privacy e sicurezza.
  3. Tra le opzioni, seleziona Rete locale
  4. Cerca l'applicazione browser che usi (ad es.: Google Chrome) nell'elenco e attiva l'opzione per consentire l'accesso alla rete locale.

Screenshot_2024-10-21_at_9.19.37aAM.png

Ulteriori informazioni

Errori dovuti a certificato mancante nell'SDK JS di Stripe Terminal durante la connessione a un lettore Internet

Requisiti di rete per lettori intelligenti Stripe Terminal

La mia applicazione POS non riesce a collegarsi al lettore intelligente Terminal con gli SDK Terminal