The BBPOS WisePOS E is a countertop reader for Stripe Terminal apps. It connects to the Stripe Terminal SDK over the internet.
For BBPOS WisePOS E readers, we recommend the server-driven integration, which uses the Stripe API instead of a Terminal SDK. To view the reader’s parts and features, see the BBPOS WisePOS E product sheet.
Troubleshoot the reader
To begin troubleshooting, use the following common scenarios to help diagnose the issue.
Reader is unable to connect
To check connectivity, go to settings, then select 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 signal strength is good.
- The device has an IP address assigned.
- The subnet matches the one that your application is connected to.
Reader is unable to connect to Ethernet, even though docked
You must connect both cables before inserting the reader into the dock. Remove the reader and re-insert into the dock.
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, then select Diagnostics. This displays a list of troubleshooting tests. Check Stripe connectivity and ensure it says “Passed.” If the Stripe connectivity test fails, follow these steps.
Reader has IP address, but is unable to communicate with Stripe
Here are some common reasons why this happens with corresponding troubleshooting steps.
Stripe endpoints can’t be accessed:
- Check your computer’s firewall/deny-list.
The network source isn’t connected to the internet:
- In the case of bridged connections, ensure that the selected source is connected to the internet.
- In the case of router connections, refer to your router’s documentation to restart the network.
Reader has IP address and can communicate with Stripe, but not with your point of sale application
Make sure the device running your point of sale application and your reader are able to communicate over the local network (typically this means they’re on the same subnet).
Stripe Terminal requires that both the point of sale application and the reader are able to interact with specific domain names, all of which are allowlisted on your network.
Stripe Terminal also requires that your reader be assigned an IP address in one of the private IPv4 address blocks.
Some ISP provided routers only support IPV6 addresses which are not supported by the WisePOS E. Most 3rd party routers support IPV4 and IPV6. You may create a separate network using a 3rd party WiFI router and connect your WisePOS E to the new network.
Some DNS providers block DNS resolution of local IP addresses. You can check whether DNS resolution is successful by going to settings 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. If your DNS provider blocks local IP resolution, change your network settings to use one of the following DNS providers:
Stripe reader software
Stripe maintains the software that controls the BBPOS WisePOS E. The reader receives updates automatically from Stripe when not in use. These can include improvements and required security updates from Stripe and our hardware partners. As reader software updates are made available, update your readers to the latest available version to continue using Stripe Terminal. Failing to install a required update can prevent a reader from accepting payments.
The reader restarts every day at midnight for PCI compliance, and disconnects from the POS app every morning. Leave your reader on and connected to power to receive automatic software updates. This ensures that updates happen at midnight (in the timezone of the assigned location) to avoid interruption to sales. If you unplug the reader at night, an update could start when you turn it back on. To manually check for an update, reboot the reader.
Reader software version
The BBPOS WisePOS E software consists of four components: the reader application, firmware, configuration, and key identifier. The following table summarizes the latest version of each of these components for the countries where WisePOS E is available. 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.
Reader software changelog
2022-09-19 (version 184.108.40.206)
- Rolled out support for dark/light themes in reader update screen.
2022-06-13 (version 220.127.116.11)
- Rolled out new default splash screen.
- Rolled out access to Appearance setting screen to switch between dark and light theme.
2022-04-13 (version 18.104.22.168)
- Improved reliability and security of Stripe SDK to reader connectivity.
- Improved support for custom splash screens by applying opacity to status bar.
Accessories for the reader
You can design your own accessories for the BBPOS WisePOS E. To download the BBPOS WisePOS E mechanical design files (.STP), you must first review and accept our Terminal Design File License Agreement. By downloading the file below, you agree to the terms outlined in the license.
The BBPOS and Chipper™ name and logo are trademarks or registered trademarks of BBPOS Limited in the United States and/or other countries. The Verifone® name and logo are either trademarks or registered trademarks of Verifone in the United States and/or other countries. Use of the trademarks does not imply any endorsement by BBPOS or Verifone.