The Stripe Terminal JavaScript SDK is encountering DNS errors when connecting to an internet reader

Note: If you frequently experience connectivity issues caused by DNS issues, we would recommend exploring server-driven integration mode, as it uses the Stripe API as the intermediary between the user's point of sale and the reader.

Overview

Some DNS providers block DNS resolution of local IP addresses. You can check whether DNS resolution is successful by going to settings on your reader and selecting Diagnostics, and checking the DNS resolution test results. Stripe Terminal uses the partially qualified domain name *.[random-string].device.stripe-terminal-local-reader.net, which resolves to the local IP address of your BBPOS WisePOS E or S700. If your DNS provider blocks local IP resolution, change your network settings to use one of the following DNS providers:

Please note that this will only affect the Stripe Terminal JavaScript SDK, so if you are using the server-driven integration or any of our mobile SDKs (Android, iOS, React Native) to communicate with our smart readers, this will not affect you.

If you need to change DNS settings:

If you have access to your router settings, we recommend making this change on your router at the location where you are accepting in-person payments. This way, all devices at that location will receive the correct DNS configuration.

Otherwise, use the instructions below, depending on the system of your point-of-sale device.

Changing DNS on the router:

If you have more than one smart reader, you may prefer to modify the DNS of your Wi-Fi on your network router to avoid changing the DNS settings for each point of sale. There should be no impact on any of your regular internet traffic by changing the router's DNS to any of the well-known providers listed above.

Sample instructions for how to change the DNS settings on your router are available here.

CHANGING DNS ON THE DEVICE:

Microsoft Windows:

If you are using a Windows machine as your point of sale, follow the steps listed here or here to change the DNS settings. Note: You may need device administrator permissions to modify DNS settings. You will need to change the DNS on each Windows machine used with Stripe Terminal.

Apple devices:

If you are using a Mac, follow these steps to change your point-of-sale DNS settings in macOS. If you are using an iPad, follow these steps. Note: You may need device admin permissions to modify the DNS. You will need to change the DNS on each Apple device that you are using as a point of sale.

CHANGING DNS IN THE Browser:

Most modern browsers, such as Google Chrome or Firefox, support modifying the DNS in use directly in the browser by using DNS over HTTPS. Detailed instructions for how to modify the DNS that your browser uses are available here. Note: You will need to change the DNS on each browser that you use as your point of sale.

Firefox:

blob

Chrome:

blob

Please be aware that Apple Safari does not currently support DNS over HTTPS, therefore any DNS changes have to be performed on the device itself.

Additional information