Skip to main content

Troubleshooting the Khumo & Khumo Print

Find answers to the most frequently asked troubleshooting questions about the Khumo/Khumo Print and Khumo 2/Khumo Print 2.

Meet the NEW Khumo 2 and Khumo Print 2

Powerful, all-in-one handheld POS that's built to keep you moving.

  • Get paid up to 2x faster

  • Work smarter on a bigger HD touchscreen

  • Keep selling with a battery that lasts up to 18 hours

  • Never miss a sale with stronger connectivity

  • Handle busy environments with a dust- and water-resistant exterior


General


Restarting your Khumo

  1. Press and hold the power button on the right-hand side of your Khumo/Khumo Print or Khumo 2/Khumo Print 2 until the power off and restart options appear on the screen (at least 2 seconds).

  2. Select Restart and allow the device to reboot.

Performing a factory reset on your Khumo

→ Khumo/Khumo 2

  1. Swipe down from the top of the screen twice to access the quick menu.

  2. Tap the Settings (cog) icon.

  3. Scroll down and select System.

  4. Tap Reset options.

  5. Choose Erase all data (factory reset).

  6. Confirm that you want to complete a factory rest by tapping Erase all data again.

→ Khumo Print/Khumo Print 2

  1. Power off the device completely.

  2. Press and hold the Up Volume button (top button on the right side).

  3. While holding the volume button, press the Power button to turn on the device.

  4. Continue holding until the system menu appears.

  5. Use the Down Volume button to navigate to Wipe data/factory reset.

  6. Press the Power button to confirm.

  7. When prompted, enter the reset code 334455 to start the reset.

Tip: Once you've completed the factory reset, select Settings (cog icon) About device → Software update on your device to check that it's running the latest software version.


Finding the serial number for your Khumo

If you have a Khumo, Khumo Print, or Khumo Print 2, you'll find the serial number printed on a white sticker on the back of the device.

If you have a Khumo 2, the serial number is on the box as well as inside the back cover of the device. To remove the back cover:

  1. Switch off the device.

  2. Turn the Khumo 2 over and hold it with the name closest to you (the Yoco logo will be upside down).

  3. Place your thumbs just below the ridge at the top of the device.

  4. Apply downward pressure with both thumbs, then push away from you to slide the back cover off.

  5. To access the serial number, remove the battery, then look for the white sticker with S/N XXXXXXXXXXX.

Struggling to make out the serial number on your Khumo device? You can also find it by following these steps:

  1. Go to Settings (cog icon) on the device.

  2. Select About device.

  3. You’ll find the serial number at the top of the screen.


Updating your Khumo software


Software updates improve the performance of your Khumo/Khumo Print and Khumo 2.0/Khumo Print 2.0 and enable new features that help you run your business even better. We'll let you know when an update is on its way. Look out for notifications in the Yoco App (mobile or web) and keep an eye on your inbox too.

Why do updates matter? Keeping your Yoco device updated is essential for:

  • Enhanced functionality and features.

  • Improved security.

  • Maintaining compatibility with transactions and external systems.

  1. Connect your Khumo/Khumo Print or Khumo 2/Khumo Print 2 to Wi-Fi.

  2. Make sure the device has at least 30% battery power.

  3. The firmware will be sent to your device.

  4. Depending on the firmware version, you’ll either receive a pop-up giving you the option to skip the software download, or your Khumo/Khumo Print or Khumo 2/Khumo Print 2 will simply start downloading the software in the background. You’ll still be able to accept payments while the download is happening.

  5. Once the download is complete (this takes 5–7 minutes), your Khumo/Khumo Print or Khumo 2/Khumo Print 2 will automatically restart to install the new software. The restart will take about five minutes.

  6. Once your Khumo/Khumo Print or Khumo 2/Khumo Print 2 has restarted, verify that the firmware is updated by going to Settings > About device and checking the firmware version.

  7. Please also reset your sales tools settings once your Khumo/Khumo Print or Khumo 2/Khumo Print 2 has restarted.

✨ Skipped the software download? You’ll be prompted to do it next time you restart your Khumo/Khumo Print or Khumo 2/Khumo Print 2. Alternatively, you can download the software manually:

  1. Got to Settings on your card machine.

  2. Select About device.

  3. Select Software updates.


Khumo isn’t showing on the Yoco POS App

The Khumo/Khumo Print and Khumo 2/Khumo Print 2 are standalone devices powered by the Yoco POS App, so it’s not necessary to connect them to the Yoco POS App on your mobile in order to transact.


Khumo Print is in protection mode

Protection mode is a critical security feature of your Khumo Print that’s triggered when someone tries to tamper with it. Protection mode can also be activated when your Khumo Print is dropped, if there’s water damage, or if there's a hardware fault and the device is no longer secure.

When your Khumo Print enters protection mode, standard functionality is no longer accessible to ensure security. Unfortunately, once this happens, the card machine has to be replaced. If the warranty on your device is still valid, we’ll send you a new one. Please contact our Support Team via the Yoco App (mobile or web) in-app chat to order your replacement Khumo Print. If your warranty has expired, you can purchase a new device from yoco.com.


Khumo Print/Khumo Print 2 has a paper jam

Lift the paper roll cover on your Khumo Print/Khumo Print 2 and check that:

  • There’s still paper on the paper roll.

  • The paper is straight and facing the correct direction.

  • The paper is the right size.

  • The paper extends at least 2 cm above the cover when it’s closed.

Close the cover when you’re done with these checks and try to print the receipt again.

🖨️ Printer protocol: Always tear the paper off the roll from left to right, or right to left.


Payment issues


Tap function isn’t working

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 isn’t accepting tap payments, follow the steps below.

1. Check for software updates

  1. Go to Settings (cog icon) on your device.

  2. Tap About device.

  3. Tap Software updates.

  4. If an update is available, install it and test the tap function again.

Khumo Print still not accepting tap payments after software update? Your device may need to be replaced. Please contact Yoco Support via our in-app chat.

2. Check that the back cover is fitted securely (Khumo only)

  1. Place your thumb on the front of your Khumo, just above the power button on the right-hand side. Place your index/second finger in the same spot at the back of your Khumo so that you have a good grip on the device. See the image below for where to position your fingers. Now press your fingers together gently to 'squeeze' your Khumo.

  2. Tap a different contactless card to check if the issue has been resolved.

  3. Restart your card machine and test again.

  4. If the issue still isn’t resolved, move on to step 3.

3. Remove and refit the back cover (Khumo only)

Important: Only remove the back cover of your Khumo if absolutely necessary. Doing so exposes the device to elements like water and can lead to the cover clips breaking over time.

  1. Switch your Khumo off.

  2. Remove the back cover by using the indent (bottom left of back cover) to loosen it and then gently releasing the clip points around the edge of the cover.

  3. Now clip the cover back into place. Apply pressure near the edges so that you hear clicks as each clip slots back in, and to make sure that there are no gaps.

  4. If your Khumo still isn’t working, it may need to be replaced. Please contact our Support Team via the Yoco App (mobile or web) in-app chat.


Khumo isn’t reading chip cards

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 isn't reading chip cards and the payments keep failing, try the following steps in the order provided below.

  1. Check that you’re inserting the card correctly: The card should be placed into the slot face up, with the numbers showing, and with the chip inside the card machine.

  2. Try another card: Retry the transaction with a different card as chips can wear down with constant use and can also get damaged.

  3. Check slot for obstructions: If the new card also isn’t working, shine a torch or bright light into the card slot to see if anything is stuck inside. Card machines that are carried loose in bags can get paper, tissue, or tiny objects stuck inside the card slot. If you see something, blow lightly over the slot. If this doesn't work, try to remove the object very gently, without damaging any of the internal parts.

  4. Check for software updates: Complete the steps below. If an update is available, install it and test the tap function again.

    • Go to Settings on your card machine.

    • Tap About device.

    • Tap Software updates.

If you’ve tried all of the above and the card machine still isn’t reading chip cards, please contact Yoco Support via the in-app chat.


'Something went wrong’ message shows during a sale

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 gets stuck with the ‘Something went wrong’ error message on your screen when you’re trying to process a sale, there could be an issue with your user permissions, or your account may need to be updated.

  1. Log in to the Yoco App (mobile or web).

  2. Go to the Manage tab.

  3. Select the Staff tile/widget.

  4. Select the staff member in question.

  5. Select the Edit icon on the top right of the screen.

  6. Select the down arrow next to Permissions.

  7. Check that the Make Sales permission is enabled for the staff member.

If the problem persists, it could be because your Yoco profile has been suspended due to an incomplete Profile Update, or paused due to a transaction review. Please check your email inbox to see if we’ve tried to contact you about resolving either of these issues.

✨ Find out more about paused and suspended profiles here.


Network and connectivity issues


Checking which network your Khumo is on

Older Khumo/Khumo Print devices have two SIM slots, with a Vodacom SIM card in one slot and an MTN SIM card in the other. Both SIM cards are active at all times. The signal strength of each network is visible in the top right corner – the first icon reflects MTN signal strength and the second reflects Vodacom signal strength.

If your Khumo/Khumo Print has two SIM slots, the device comes automatically connected to MTN, but it’s easy to switch to Vodacom.

  1. Select Settings on the card machine.

  2. Select Network & Internet.

  3. Select SIM cards.

  4. Toggle the Vodacom button to the ‘on’ position.

✨ Newer Khumo and Khumo Print devices and all Khumo 2/Khumo Print 2 devices have one Telkom SIM card that roams across networks to secure the best connection at all times.


Khumo isn’t connecting to Wi-Fi

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 can’t connect to Wi-Fi, you'll need to perform a reboot.

  1. Go to Settings (cog icon).

  2. Tap on System.

  3. Tap on Reset options.

  4. Select Reset WiFi, Mobile & Bluetooth.

  5. Tap the Reset settings button.

  6. Restart the card machine to get the SIM card's APN settings back.


Khumo isn't connecting to mobile networks

If you can't connect to a network with your Khumo/Khumo Print device:

  1. Switch to an alternative network (Vodacom to MTN or vice versa).

  2. If you’re unable to connect with Vodacom or MTN, please check if you have network coverage in your area.

  3. If your network coverage is poor, switch to Wi-Fi.


Khumo is connected to Mobile Networks, but network bars are displaying an X

If you’re trying to connect to the network on your Khumo/Khumo Print or Khumo 2/Khumo Print 2, but your network bars are showing an X and you’re seeing the message: ‘Something went wrong. Network error. Please check your connection’, it means that your SIM card(s) has been deactivated.

This happens when your business hasn’t processed any transactions for six months, or it has demonstrated consistently low transaction activity over time.

✨ Find out more about SIM card deactivation here.

To request a new SIM card, please send Yoco Support this message via our in-app chat:'My SIM card was deactivated and I'd like to request a replacement.’ They’ll make sure you get a new SIM card within 3–4 working days.


Khumo is displaying ‘Waiting for 4G networks’ message

If you see the ‘Waiting for 4G networks’ message on your Khumo/Khumo Print, tap Try again. If the issue persists, tap Network connection settings below the error message, then select the SIM card with the best connection (MTN or Vodacom) – or Wi-Fi, if you have access to it.

You may also need to reset your network connection by following these steps:

  1. Go to Settings (cog icon).

  2. Tap on System.

  3. Tap on Reset options.

  4. Select Reset Wi-Fi, Mobile & Bluetooth.

  5. Choose the alternate network (MTN or Vodacom).

  6. Tap the Reset settings button.

  7. Restart the card machine to get the SIM card's APN settings back.


Power problems


Khumo keeps switching off

The Khumo/Khumo Print and Khumo 2/Khumo Print 2 are programmed to auto shutdown after an hour of no activity.

The timer resets whenever you plug your Khumo/Khumo Print or Khumo 2/Khumo Print 2 into a power source, or when you use the device and the screen lights up.

You can reprogramme the timer as follows:

  1. Go to Settings

  2. Select Display

  3. Select Auto shutdown.

  4. Choose the setting you prefer:

    • Never

    • 15 minutes

    • 30 minutes

    • 1 hour

    • 2 hours


Khumo only turns on when charging

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 only turns on when it’s connected to a charger, please contact Yoco Support via our in-app chat.

Depending on the status of your one-year warranty, a replacement card machine will either be delivered to you free of charge, or you'll need to purchase a new device from yoco.com.


Settings


Products/staff aren’t visible

There are a few things you can check to resolve this issue on your Khumo/Khumo Print or Khumo 2/Khumo Print 2.

  1. Make sure you're logged in as an Administrator.

  2. Make sure that you’ve added Staff and Products in the Yoco App (mobile or web). Go to the Manage tab in the Yoco App (mobile or web) and select the Products tile or Staff tile.

    🍅 Haven't set up a product catalogue yet? Click here for a step-by-step guide.

  3. Check that your Khumo and Khumo Print are running the latest firmware version, by checking for updates:

    • Got to Settings on your card machine.

    • Select About device.

    • Select Software updates.

    If your device says ‘You’re up to date’, please contact Yoco Support via our in-app chat and ask for a firmware update to be sent to your device.


Error messages


‘Oops something went wrong’

If you see this error message on your Khumo/Khumo Print or Khumo 2/Khumo Print 2, try the following:

1. Check for software updates

  1. Go to Settings (cog icon).

  2. Tap About device.

  3. Tap Software updates.

  4. If an update is available, install it.

  5. If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 is still displaying the error message, try step 2.

2. Check your connectivity status

  1. Go to Settings on your card machine.

  2. Tap Network & internet.

  3. Toggle Wi-Fi to the ‘on’ position or (if you're using an older version of the Khumo/Khumo Print which has two SIM cards) tap SIM cards and then Preferred SIM for to switch from MTN to Vodacom or vice versa.

If the error message is still visible it’s likely that the software on your Khumo/Khumo Print or Khumo 2/Khumo Print 2 is corrupted and that the device will need to be replaced. Please contact Yoco Support via our in-app chat for further assistance.

Please note: The ‘Oops something went wrong’ error message is always followed by a message explaining the most likely cause of the issue. Please pass this message on to Yoco Support so that they can diagnose the issue as accurately as possible.


‘Provision request failed’

If you see this error message on your Khumo/Khumo Print or Khumo 2/Khumo Print 2, it means there’s a network error. Please check that you have network connectivity (SIM card or Wi-Fi) by following these steps:

  1. Go to Settings on your card machine.

  2. Tap Network & internet.

  3. Toggle Wi-Fi to the ‘on’ position or (if you're using an older version of the Khumo/Khumo Print which has two SIM cards) tap SIM cards and then Preferred SIM for to switch from MTN to Vodacom or vice versa.

If your Khumo/Khumo Print or Khumo 2/Khumo Print 2 still isn’t working, please contact Yoco Support via our in-app chat for further assistance.


‘Failed to allocate card machine’

If you’ve added your Khumo/Khumo Print or Khumo 2/Khumo Print 2 to your account via the Yoco App (mobile or web) and this error message appears, it means that there’s an allocation issue.

Please contact Yoco Support via our in-app chat and a consultant will help you resolve the problem.


‘Your card machine needs to be replaced'

If you see this error message on your Khumo/Khumo Print, or you've received a notification in the Yoco App (mobile or web) or via WhatsApp letting you know that your card machine needs to be replaced due to a configuration error or internal damage, please contact Yoco Support immediately via our in-app chat.

They'll make sure that your device is replaced and that it's delivered it to your door (free of charge), so that your business can keep growing with Yoco.


‘Unexpected error occurred'

If you see this error message on your Khumo Print/Khumo Print 2 when you’re trying to reprint a receipt, it's because there’s no contact number on your Yoco profile.


Follow these steps to add a contact number:

  1. Log in to the Yoco App (mobile or web).

  2. Tap on your business name in the top right-hand corner of the Yoco Mobile App, or click on it in the bottom left-hand corner of the Yoco Web App.

  3. When the Business settings page opens up, select the Business details tile.

  4. Select the Edit button next to the Basic details heading.

  5. Add a contact number and select the Save changes button.


Need more help?

Start a conversation with a Yoco Support consultant via our in-app chat.

✨ Important: Please give our Support Team as much information as you can when reporting a card machine issue, including the serial number for your device and details of any error messages you receive. The more they know, the sooner they can get you back to business.

Did this answer your question?