Skip to main content

How do I troubleshoot payment terminal issues?

This guide is designed to help you troubleshoot common terminal issues, so you can quickly identify and resolve any problems that arise.

Written by Cococart Support Team

Having trouble with your payment terminal's connectivity? Don’t worry, we’ve got you covered!
​
​The payment terminal works with the Cococart POS on both iOS and Android devices over Bluetooth.


Just follow these easy steps to get your payment terminal working smoothly.

Here’s what to check first:

  1. Make sure that before accepting payments or connecting the terminal, you have a stable internet connection to avoid multiple charges or failed payments.
    ​

  2. Always complete the OS update of the terminal when the prompt hits.
    Your device has to have at least 50% of battery charge to finish the process.
    ​

3. Disconnected terminals will show this prompt when you attempt to checkout an order after making the single long beep sound. Click Reconnect to address the issue.
​

4. Declined payments are caused by different factors such as invalid card use, insufficient funds, and connectivity problems. As soon as you see this prompt, please do not hesitate to reach out to our Support Team to identify the cause and how to address it.
​

Important: Check your account and refresh the POS app

Make sure the email address logged in on your device belongs to an active team member. If the account has been removed from your team, you may experience payment or connectivity issues.
​

If you're unable to connect to your payment terminal or see a Payment Declined page, try refreshing your session:

  1. Close the Cococart POS app completely.

  2. Log out of your account, then log back in.

  3. Reopen the POS app and try connecting to the payment terminal or processing the payment again.

Important App permissions that you need to have:For Android:

Enable location and Bluetooth permissions for the app.

  1. Turn Bluetooth off and then on

  2. Go into Settings -> Apps -> Cococart POS

  3. Make sure the following permissions are enabled

    1. Location

    2. Nearby devices
      ​

For iOS:

Allow Bluetooth access on the app by following these steps:

  1. Go to Settings

  2. Select App

  3. Find Cococart POS

  4. Turn on Bluetooth


​

🚩Limitation:

If the payment terminal does not connect to the POS, try disabling and re-enabling Bluetooth in your device settings

Related Articles
Did this answer your question?