Troubleshooting Stripe Custom Payment Terminals

If your Stripe BBPOS WisePOS E terminal isn't connecting or processing payments, find your symptom below and follow only those steps. If you have a specific error code on screen, jump to the error code section at the bottom.

📶 Terminal won't connect or transactions time out
Step 1
Check which Wi-Fi band the terminal is on
  1. On the terminal, swipe in from the left edge and go to Settings > Network Settings.
  2. Confirm it is connected to a 2.4 GHz network. Avoid 5 GHz — it drops more frequently under load.
  3. If your router broadcasts both bands under the same name, ask your IT contact to split them so you can force the terminal to stay on 2.4 GHz.
Your POS computer and terminal must be on the same network for them to communicate.
✓ Did this fix it? If yes, you're done. If no, continue to Step 2.
Step 2
Reconnect to Wi-Fi (or switch to Ethernet)
  1. On the terminal, go to Settings > Network Settings.
  2. Forget your current network and reconnect to it fresh.
  3. If Wi-Fi keeps dropping, connect the dock to Ethernet instead. Make sure the terminal is fully seated with the charging pins aligned and the indicator lights on.
  4. Use only one connection type at a time — Wi-Fi or Ethernet, not both.
If customers regularly pick the terminal up out of the dock, Ethernet will cut the connection each time. In that case, stay on Wi-Fi and focus on improving signal quality instead.
✓ Did this fix it? If yes, you're done. If no, continue to Step 3.
Step 3
Run built-in diagnostics
  1. Swipe in from the left edge and open Settings.
  2. Enter the admin PIN: 07139.
  3. Tap Diagnostics and run all available tests.
  4. Each test should show Passed. If the Stripe Connectivity test fails, the network is the likely cause — revisit Steps 1 and 2.
✓ Did this fix it? If yes, you're done. If no, continue to Step 4.
Step 4
Check signal strength and router placement
  1. Weak signal or interference can cause timeouts even when the terminal shows as connected.
  2. Try moving your router or access point closer to the front desk, or add a Wi-Fi booster.
  3. Restart the router if nothing else has helped.
The WisePOS E does not work on open networks or IPv6-only networks.
Still not working? See what to include when you contact Rock Gym Pro Support.
Terminal won't turn on or hold a charge
Step 1
Check the power source
  1. Plug the terminal into a wall outlet or USB power brick — not a computer USB port, which may not supply enough power.
  2. If using a dock, confirm the terminal is seated securely with the charging pins making contact and the indicator lights on.
  3. Try a different power brick or cable to rule out a faulty accessory.
✓ Did this fix it? If yes, you're done. If no, continue to Step 2.
Step 2
Check the LED indicators

The LED lights give status information about power and connectivity. Refer to the Stripe Terminal LED Indicators guide for what each pattern means.

✓ Did this fix it? If yes, you're done. If no, continue to Step 3.
Step 3
Force restart the terminal
  1. Hold the power button for about 6 seconds until the terminal restarts.
  2. Let it fully boot before testing again.
Still not working? See what to include when you contact Rock Gym Pro Support.
💳 Card chip, swipe, or tap isn't working
Step 1
Check how the card is being presented
  • Chip: Insert fully with the chip facing up. Leave it in place until the transaction completes.
  • Tap: Hold the card flat and close to the screen. Remove cases or thick wallets that may block the signal.
  • Swipe: Magnetic stripe facing the correct direction, one smooth motion through the slot.
✓ Did this fix it? If yes, you're done. If no, continue to Step 2.
Step 2
Restart the terminal
  1. Hold the power button for about 6 seconds to restart.
  2. Wait for it to fully boot and try again.
✓ Did this fix it? If yes, you're done. If no, continue to Step 3.
Step 3
Note any error codes on screen
  1. Write down any codes shown on screen, such as WR5 or F-INSTALL.
  2. Check the Stripe Error Codes reference for that specific code.
  3. If you can't resolve it from that page, include the code when contacting support.
✓ Did this fix it? If yes, you're done. If no, continue to Step 4.
Step 4
Delete and re-register the terminal

Follow the steps in Purchasing, Registering, and Connecting Stripe Terminals to delete and re-add the terminal.

Still not working? See what to include when you contact Rock Gym Pro Support.
🔄 Software update won't complete
Step 1
Let the terminal update overnight
  1. Leave the terminal powered on and connected to the internet overnight. Updates install automatically.
  2. In the morning, go to Settings > Diagnostics > Software Version to confirm it updated.
If the update still doesn't complete, a network issue is almost always the cause. Work through the connection steps first.
✓ Did this fix it? If yes, you're done. If no, continue to Step 2.
Step 2
Verify the network allows update traffic
  1. Run diagnostics: swipe in from the left, go to Settings, enter PIN 07139, and run all tests.
  2. The Stripe Connectivity test must pass for updates to download.
  3. If you are on a restricted or firewall-controlled network, check with your IT contact whether Stripe's update servers are blocked.
Still not working? See what to include when you contact Rock Gym Pro Support.

⚠️ Error code reference

See an error message on screen? Find it below. If your code isn't listed, write it down exactly as it appears and include it when you contact support.

Reader ID is requiredWorkstation can't find the configured terminal

Reader ID is required error message on screen

Example of this error as it appears on screen

  1. Go to Data Entry > Manage > Settings > Payment & Billing.
  2. Next to POS, click Configure and select the correct terminal from the list.
  3. Save your settings and try the transaction again.

If no terminal appears in the list, it needs to be re-registered. Follow the steps in Registering and Connecting Stripe Terminals to delete and re-add it, then return here and select it.

Still not working? See what to include when you contact Rock Gym Pro Support.
Error processing token [hash string]Terminal lost sync with Stripe — card read but charge couldn't complete

Error processing token message on screen

Example of this error as it appears on screen

Before retrying, check for a duplicate charge to avoid double-charging the customer.

  1. Go to payments.rockgympro.com and check whether the transaction appears.
  2. If it went through — do not retry. The payment was successful despite the error.
  3. If it did not go through, delete and re-register the terminal following the steps in Registering and Connecting Stripe Terminals.
  4. Once re-registered, run a test transaction to confirm it is working.

If the error repeats on all cards after re-registering, run diagnostics (Settings > PIN 07139 > Diagnostics) and contact support with the full token string from the error message.

Still not working? See what to include when you contact Rock Gym Pro Support.
Seeing a code not listed here? Write it down exactly as it appears and include it when you contact Rock Gym Pro Support.

When to Contact Rock Gym Pro Support

If you've worked through the steps above and the terminal still isn't working, contact Rock Gym Pro Support. Include the following so we can help you faster:

  • Terminal serial number (found on the back of the device or in payments.rockgympro.com > Terminals)
  • Any error messages or codes shown on screen
  • Approximate date and time of the issue
  • What you were doing in the software when it happened
  • Steps you already tried
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.