Resumen

Con la última actualización de macOS 15 (Sequoia), Apple introdujo cambios que afectan las conexiones de red local. En concreto, para aplicaciones como el SDK de JavaScript de Stripe Terminal que requieren acceso a la red local, los usuarios tendrán que conceder permisos explícitos para que sus aplicaciones de navegador detecten y se comuniquen con dispositivos de la red local. En esta guía se describen los pasos necesarios para garantizar que Stripe Terminal se conecte como se espera.

Problema común

Al actualizar a macOS 15, los usuarios pueden experimentar problemas con el SDK de JavaScript de Stripe Terminal al no poder conectarse a lectores en la red local. Este inconveniente se debe a la nueva configuración de privacidad que exige un permiso explícito para acceder a la red local.

Pasos para la resolución

1) Permitir el acceso en la primera solicitud:

1. Cuando ejecutes por primera vez una aplicación de navegador (por ejemplo, Google Chrome) que intente comunicarse con un dispositivo de red local, recibirás un mensaje como el que se encuentra a continuación:

2. Acción: haz clic en Permitir para conceder acceso a la red local.

Nota: Si se selecciona «No permitir», el SDK de JavaScript de Stripe Terminal no funcionará como se espera.

2) Conceder acceso manualmente:

Si inicialmente hiciste clic en «No permitir» o necesitas conceder acceso más adelante, sigue estos pasos:

1. Abre Configuración del sistema en tu dispositivo macOS.
2. Navega a Privacidad y seguridad.
3. Selecciona Red local en las opciones.
4. Busca la aplicación de tu navegador (por ejemplo, Google Chrome) en la lista y activa el conmutador para permitir el acceso a la red local.

Información adicional

El SDK de Stripe JS Terminal está experimentando errores de falta de certificado cuando se conecta con un lector de Internet.

Requisitos de la red de lectores inteligentes de Stripe Terminal

Mi aplicación del sistema de puntos de venta no puede conectarse al lector inteligente de Terminal mediante los SDK de Terminal