Why is my terminal not working properly?

Last updated on April 15, 2025

Technology isn’t always perfect, and sometimes things don’t work the way they should. There can be various reasons for this, but the good news is that many issues can be quickly resolved with simple steps.
This guide will help you troubleshoot common problems you might encounter with your Vibrant payment terminal or payment app.

Troubleshooting Steps:
1. Force quit the app and reopen it

This is one of the most effective fixes and solves most issues – especially if you’re seeing a blank screen or an unexpected error when trying to take a payment. (Understand error codes here)

To force quit the app, follow these steps:
Go to Settings > Apps & notifications > Vibrant > Force stop > Confirm.
Then open the Vibrant app again.

👉 See our step-by-step guide to force quitting the app


  1. Check your internet connection:

Ensure your device has a strong and stable internet connection. The Vibrant app requires internet to function. Weak or non-existent connection could be the reason for your app getting stuck on a loading screen, or nothing happening after trying to log in.

3. Check the NFC/card reader (Sunmi v2s only)

If your terminal isn’t detecting a card after you’ve initiated the payment, and you’re using a Sunmi v2s device, there could be a simple fix: Open and close the orange compartment at the top of the device.
This is where the NFC reader is located, and doing this can help reset the contactless reader in case it’s temporarily unresponsive.

4. Log out and in the app:

Similarly to a restart, logging out and back into the app can solve some issues of the app repeatedly showing certain error codes.

5. Disable developer options (Last resort):

If you’ve tried everything else, and the issues are persisting, check if your “Developer options”  are disabled. This is a rare cause of issues, but it can sometimes affect card reading or login functionality.

How to Disable Developer Options:

  • Go to your device’s “Settings.”

  • Search for “Developer Options.”

  • If you can’t find it, enable “Show hidden settings” (Android 11 and above) or search online for specific instructions for your device model.

  • Toggle the switch to disable “Developer Options.”

  • Restart the Vibrant app.


If you’re still experiencing issues after trying these steps, please contact Vibrant Support for further assistance.
Remember to keep your Vibrant app and terminal firmware updated for optimal performance.

Can’t find what you’re looking for?

Our team is ready to help Mondays to Fridays from 8:00-16:00. Call us or send a mail and we will get back to you as soon as possible.

Contact us

A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background

Can’t find what you’re looking for?

Our team is ready to help Mondays to Fridays from 8:00-16:00. Call us or send a mail and we will get back to you as soon as possible.

Contact us

A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background

Can’t find what you’re looking for?

Our team is ready to help Mondays to Fridays from 8:00-16:00. Call us or send a mail and we will get back to you as soon as possible.

Contact us

A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background

Can’t find what you’re looking for?

Our team is ready to help Mondays to Fridays from 8:00-16:00. Call us or send a mail and we will get back to you as soon as possible.

Contact us

A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background
A portrait of a Vibrant employee with colorful background
Vibrant logo

Products

Industries

Resources