Troubleshooting
Have you tried updating the firmware on your reader?
Updating the firmware version on the reader can sometimes resolve issues if there is a known bug that has since been fixed within our app. For more information on updating the firmware of your device click the link below to the Firmware Updates page:
Managing Firmware UpdatesHow to restart the payment app?
From any screen in the app, you may press and hold the green circle button to reboot the device.
How to shutdown the reader?
To shutdown the reader, you can either unplug the device from the power source or press and holdfor at least 5 seconds.
Error screen appears?
Many issues can be fixed by restarting the payment app. If you see this screen, follow the prompt to "Restart the App". Alternatively, you may press and hold the green circle button to reboot the device.
Can't connect to Sandbox
Check that your sandbox credentials are correct and that your device is connected to the WiFi Network. If the problem persists please contact us.
Is your reader connected to your network but not reaching the Braintree platform?
This can happen if your onsite network has a firewall that may be blocking communication from the Braintree platform endpoints to and from the reader. Please double-check that your network firewall is not blocking network traffic with the Braintree Endpoints. If you're still having issues try running our network diagnostics tool.
Having network connectivity issues?
As of version 5.1.0 we now support a network diagnostics tool that can be accessed from the reader admin menu. You can access the admin menu by pressing 2+8 on the number pad, then enter your admin menu password and press the Run Connection Test button to begin. This tool helps you identify where the breakdown in communication may be occurring on your network.
Need to contact our Support team?
If you still need help after trying some of the troubleshooting tips, please reach out and provide detailed information on the issue you are experiencing as outlined on our contact page.