Troubleshooting

Have you tried updating the firmware on your reader?AnchorIcon

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 Updates

How to restart the payment app?AnchorIcon

From any screen in the app, you may press and hold the green circle button to reboot the device.

How to shutdown the reader?AnchorIcon

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?AnchorIcon

Something went wrong error screen.

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 SandboxAnchorIcon

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?AnchorIcon

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?AnchorIcon

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.

Example screenshots of the network diagnostics tool

Need to contact our Support team?AnchorIcon

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.