Here are instructions on how to troubleshoot connectivity issues, along with common error messages.
Error Code: Reader is unable to connect
To check connectivity, go to settings > WiFi settings. This displays all available WiFi networks. To see more details about the connection, tap on the connected network name.
Make sure the network is connected and has internet access.
The computer and terminal should be on the same network
The signal strength is good.
The device has an IP address assigned.
The subnet matches the one that your application is connected to.
Follow each step to continue troubleshooting:
Step 1: Local Network Settings
If your studio is using a MacOS device (version 15 Sequoia or later) to make sales via the POS, ensure that the Google Chrome toggle has been enabled in your Local Network settings. On your device:
Open System Settings on your macOS device.
Navigate to Privacy & Security.
Select Local Network from the options.
Find your browser application in the list and toggle the switch to allow local network access.
Step 2: Chrome Site Permissions
When the terminal is first connected, and a POS sale is attempted, a Google Chrome site permission pop-up should surface, confirming whether you want to allow or block the terminal connection.
At some point, an employee may have clicked Block, which has now saved that site permission, automatically blocking the terminal connection every time a connection is attempted.
To fix, you will need to reset your Admin site permissions by:
Access the Admin site in Google Chrome
Click the View Site Information icon next to the URL:
Click Site Settings, which should open a new Settings tab in Google Chrome
Ensure the site listed is the Mariana Tek URL [tenant.marianatek.com]
Click Reset Permissions > Reset:
Once completed, attempt a new sale in the POS. A pop-up should surface, confirming whether you would like to allow or deny the terminal connection > select Allow.
Step 3: DNS Changes
Your default DNS provider (OS Default) may not allow the terminal connection through Google Chrome. In these cases, follow these steps:
Access your Google Chrome settings via the menu in the top right corner > Settings
Click Privacy and Security > Security.
Ensure the Use secure DNS toggle is enabled.
If this is not enabled, and cannot be enabled, your computer is likely managed by your HQ, and you will need to contact the HQ team for assistance.
Change the Select DNS provider to any of the options in the following order:
Between each change, refresh your POS and attempt a sale.
Google (Public DNS)
Cloudflare (1.1.1.1)
Any other option the studio has listed
For more details based on your specific terminal:
Error Code: Reader is unable to update
If your reader doesn’t update, it’s possible that it can’t connect to Stripe. To check its connectivity to Stripe, go to Settings > Diagnostics. This displays a list of troubleshooting tests. Check Stripe connectivity and ensure it says Passed.
For more details based on your specific terminal:
If you are seeing the following, please reach out to support to further troubleshoot: Reader has IP address but is unable to communicate with Stripe
Error: The Stripe Terminal SDK is encountering DNS errors when connecting to an Internet Reader
Some DNS providers block DNS resolution of local IP addresses. You can check whether DNS resolution is successful by going to Settings > Diagnostics and checking the DNS resolution test results. Please view this Stripe Help article for additional steps.
If troubleshooting does not fix the device issue, please reach out to support so the team can further assist.
When reaching out, we request that you include your reader's version to expedite the support. You can find your reader’s versions in the Diagnostics menu by swiping in from the left edge of the screen, tapping Settings, and entering the admin code, 0-7-1-3-9.