All Collections
Onboarding
POS Setup
Set up Stripe POS swipe terminal
Set up Stripe POS swipe terminal

How to set up your Stripe POS terminal to swipe credit cards in VinesOS

Updated over a week ago

Warning

Stripe readers aren’t liquid-proof and we recommend that users make appropriate efforts to make sure their devices remain dry. If your device has experienced liquid ingress, we recommend that you stop using the device and let it dry thoroughly before attempting to re-use or charge the device. If your device doesn’t properly operate or charge properly after drying, you need to replace it.

Step1: Connect the reader to 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 by using an outlet or the optional ethernet dock. 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. With a full charge, you can expect the battery to last about eight hours.

Note

Even when it’s not in use, leave the BBPOS WisePOS E plugged in and powered on to receive automatic software updates.

Access settings

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 status is displayed at the top right of this screen. To close the settings menu, click the back arrow in the top left corner.

Settings button

Admin PIN screen

Connect the reader to the internet

Because the BBPOS WisePOS E is a smart reader, its reader software communicates directly with Stripe. Your point of sale application communicates with the reader through the internet. When communicating with the reader through the LAN, the reader must connect to the same local network as your point of sale application. If you’re running into issues connecting your reader to the internet, follow the troubleshooting steps to diagnose the issue.

WiFi

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. The BBPOS WisePOS E does not support non-password-protected networks, enterprise networks, or IPV6 networks. Follow the troubleshooting steps to diagnose issues with IPV6 networks. If needed, you can set a static IP on the device from the Wireless settings screen.

Ethernet

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.

To set up the dock:

  • Connect the Ethernet cable from your dock to your router.

  • Connect the dock to power. It 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).

  • When both cables are connected, insert the reader into the dock.

To confirm that the reader is properly docked, verify the reader is charging, and the Ethernet icon is visible in the status bar.

Charging icon

Ethernet icon

Note

The dock’s charging cable must be USB-A to USB-C. The dock doesn’t work with a USB-C to USB-C connection.

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.

Network priority

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 you remove the reader 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 you dock the reader, 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.

Step 2: Register the Reader on VinesOS

Please also note that the terminal must be on the same WiFi network as your tablet or device.

To complete your setup, you will need to enter information from your Stripe terminal into your Settings page within VinesOS.


1. In the sidebar, go to POS > Settings.

2. If you have more than one terminal, please note that in the description field in VinesOS, name your terminal something that will be obvious on checkout (e.g., Winebar, Front bar, etc.). This way, your staff will know which terminal the order is being sent to. Required field.

3. Enter the Activation Code from the terminal unit in order to pair VinesOS with your terminal. Required field.

4. Other options for the POS. These are optional, not required fields.

5. Save


Terminal Troubleshooting

If you’re running into issues and your terminal is not connecting to the POS, follow the troubleshooting steps to diagnose the issue.

Learn how to use the Point of Sale

Follow the Operations Guide to learn how to swipe a transaction.

Did this answer your question?