The BBPOS WisePOS E is a countertop reader for Stripe Terminal apps. It connects to the Stripe Terminal SDK over the internet.
Turn the reader on and off
When you first receive the device, install the battery. With the back of the device facing you, lift up from the indentation at the bottom left corner to detach the back cover. Insert the battery by sliding it into the exposed slot with the gold connectors at the top aligned. After the battery is in place, charge the reader. Connect the reader to power by plugging the provided cable into the port with the lightning bolt symbol.
After the reader is fully charged, hold down the power button on the right hand side until the screen turns on. After the device powers on, press the power button to sleep or wake the device. To fully power off the device, hold down the power button until the power off option is shown on the screen, then select it.
In a countertop deployment, leaving the device on for extended periods is expected.
To open the settings menu, swipe right from the left edge of the reader screen to reveal a settings button. Tap the settings button and enter the admin PIN
07139. From here you can update your WiFi settings or generate a pairing code for device registration. Battery percentage is displayed at the top right of this screen. To close the settings screen, click the back arrow in the top left corner.
Connect the reader to the internet
Because the BBPOS WisePOS E is internet enabled, its reader software communicates directly with Stripe, managing connectivity through a LAN. The reader must connect to the same local network as your point of sale application.
To connect to WiFi or switch networks, go to settings, then select WiFi settings to choose the network and connect. Attempting to join a new network disconnects the reader from any existing wireless connection.
Your WiFi network must use WPA-Personal or WPA2-Personal encryption and be password protected. Non-password-protected networks or enterprise networks are not supported. If needed, you can set a static IP on the device from the Wireless settings screen.
Ethernet connectivity requires the use of an optional dock, which provides wired Ethernet connectivity and keeps your smart reader fully charged using the included charging cable. You can purchase the dock separately through the Stripe dashboard.
The Ethernet Dock features a 10/100 Ethernet port and rubber feet for stable countertop use, and is designed for easy docking and undocking using the pins on the back of the reader. The dock has a minimum power requirement of 5V-2A (10W) and includes a charging cable, which you can plug into any USB-A power adapter (not included).
The reader obtains an IP address using DHCP. As soon as the network cable is plugged in, the reader attempts to establish communication with Stripe.
The BBPOS WisePOS E prioritizes connecting through Ethernet if possible. Even if previously configured for WiFI, the reader switches to using an Ethernet connection when connected to the dock with a plugged-in Ethernet cable. If the reader is removed from the dock, it switches back to the WiFi connection.
The BBPOS WisePOS E resets its priority to Ethernet when rebooting. Even if previously configured for WiFi, the reader switches to Ethernet if it detects an Ethernet cable connection while starting up.
If the reader is docked but there is no Ethernet cable plugged in, it uses WiFi. Regardless of connectivity while docked, you can still connect to WiFi and manage networks on the device.
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 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 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:
The 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.
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.
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.