Overzicht

Met de laatste macOS 15-update (Sequoia) heeft Apple wijzigingen geïntroduceerd die van invloed zijn op lokale netwerkverbindingen. Specifiek voor applicaties zoals de Stripe Terminal JavaScript-SDK die lokale netwerktoegang vereisen, moeten gebruikers expliciete toestemmingen geven aan hun browser-apps om apparaten op het lokale netwerk te detecteren en ermee te communiceren. Deze handleiding beschrijft de stappen die nodig zijn om ervoor te zorgen dat de Stripe Terminal verbinding maakt zoals verwacht.

Vaak voorkomend probleem

Bij het upgraden naar macOS 15 kunnen gebruikers problemen ondervinden met de Stripe Terminal JavaScript-SDK die geen verbinding kan maken met kaartlezers op het lokale netwerk. Dit komt door nieuwe privacy-instellingen die expliciete toestemming vereisen voor lokale netwerktoegang.

Probleemoplossing

1) Toegang verlenen bij de eerste prompt:

1. Wanneer je voor het eerst een browserapplicatie start die probeert te communiceren met een lokaal netwerkapparaat (bijvoorbeeld Google Chrome), krijg je een melding zoals hieronder:

2. Actie: Klik op Toestaan om toegang te verlenen tot het lokale netwerk.

Opmerking: Als 'Niet toestaan' is geselecteerd, zal de Stripe Terminal JavaScript-SDK niet werken zoals verwacht.

2) Handmatig toegang verlenen:

Als je in eerste instantie op 'Niet toestaan' hebt geklikt of op een later moment toegang moet verlenen, volg dan deze stappen:

1. Open de systeeminstellingen op je macOS-apparaat.
2. Ga naar Privacy en beveiliging.
3. Selecteer Lokaal netwerk in de lijst met opties.
4. Zoek je browserapplicatie (bijv. Google Chrome) in de lijst en schakel de optie voor toegang tot het lokale netwerk in.

Aanvullende informatie

De Stripe JS Terminal-SDK geeft aan dat er fouten zijn door een ontbrekend certificaat bij het maken van een verbinding met een internet-kaartlezer

Netwerkvereisten voor slimme Stripe Terminal-kaartlezers

Mijn POS-applicatie kan geen verbinding maken met de slimme Terminal-kaartlezer via Terminal-SDK's