ShopKeep Register on The Mini, built by Clover Troubleshooting

This guide focuses on solving issues that affect The ShopKeep Register on The Mini, built by Clover.

If you are having problems using the Clover Mini as a customer facing display with the ShopKeep Register for iOS, visit this troubleshooting guide instead.

Table of Contents

Setup Issues

This section deals with issues you may run into while setting up the register.

My device is not powering on.

If the screen does not turn on after plugging the power cable into an outlet, the device is most likely not receiving power. After each step below, check to see if the problem is resolved.

  1. Unplug the power cable from the power adapter, then plug it back in.
  2. Unplug the power cable from the Hub, then plug it back in.
    Click to Enlarge
  3. Unplug the power cable from its power outlet, then plug it into a different power outlet.

    Make sure to use a known working outlet.

  4. If a cash drawer is connected to the Hub, make sure the correct cable is in use.
    • For APG cash drawers, the CD-101A cable is the only compatible cable. If a different cable is connected, the device will not power on. Purchase a new cable here, if necessary.
    • For the Clover cash drawer, you must use the cable that came with the drawer.

"You've entered the wrong password"

This error appears on the register when you enter a Wi-Fi network’s password incorrectly.

  1. Look to see if you are connecting to the correct network.

    If you selected the wrong network, tap ‘Cancel’ and pick the correct one.

    Click to Enlarge
  2. Tap 'Try Again' and re-enter the network's password.

    Be aware that Wi-Fi passwords are case-sensitive.

    Click to Enlarge
  3. If the problem persists, try to confirm the Wi-Fi password with someone.

I can’t locate the activation code email.

An activation code is required for device setup. If you cannot find the activation code email in your inbox, continue reading for help.

  1. Make sure you are checking the correct email account.

    The code is sent directly to the Business Owner. Unless changed, this is the email address originally used to set up the ShopKeep account.

  2. Check your spam folder as the email may have been incorrectly filed there.
  3. Still cannot find the activation email? Contact ShopKeep Customer Care.

"Invalid activation credentials"

This error appears when the wrong activation code is entered during setup.

  1. Check your email to verify the activation code.
  2. If you have multiple Clover devices, make sure you entered the code assigned to that specific device.

    Match the number on the bottom of the Hub with the ‘Device ID’ in each activation email.

  3. Re-enter the activation code.

"Invalid activation store name and/or manager code"

Make sure that the store name and manager code combination being used are the same as listed in BackOffice. Be sure that the store name is entered using all lowercase and no spaces. The manager code is four digits.

Click to Enlarge

"Unable to activate register; no available licenses"

This error message is received if there are no available register licenses. If you need to add an additional register or need to reactivate a register, contact us for assistance.

Transaction Screen Issues

Having trouble while running transactions? We can help. Find your issue in this section and follow the troubleshooting steps.

Items don't appear on the register when I scan them.

Follow the specific steps below that reflect whether you are scanning barcodes using a connected USB barcode scanner or with The Mini’s built-in front-facing camera.

USB Barcode Scanner

Check to see if your USB barcode scanner is properly connected to the register and communicating with The Mini inside the ShopKeep app.

  1. If the scanner beeps but the item does not appear on screen, follow the bullets below this step. Otherwise, skip to step 2.
    • In BackOffice, open the Item List and search for the UPC code of the item.
      • If an item appears on the Item List, return to the register and tap ‘Get Updates’ on the register menu. Then, go to the Transaction screen and scan the item.
      • If no item appears on the Item List, the scanned UPC is not associated with an item in inventory. Either add a new item with that UPC or add the UPC to an existing item. If the item’s barcode was printed using ShopKeep Label Printing, print a new label for the item.
  2. Disconnect and reconnect the scanner.
    • Unplug the scanner from The Mini’s Hub.
    • Plug the scanner back into the Hub.

The Mini’s Built-In Camera

Make sure you are using proper technique when scanning barcodes using The Mini’s built-in camera.

  1. Make sure the barcode is aligned with the red line on screen.
    Click to Enlarge
  2. Ensure there is adequate lighting in the area where the barcode is being scanned.
  3. Move the barcode closer to or further from the camera until it appears in focus.
  4. If The Mini beeps but the item does not appear on the screen, follow the bullets below this step.
    • In BackOffice, open the Item List and search for the number below the item’s barcode.
      • If an item appears on the Item List, return to the register and tap ‘Get Updates’ on the register menu. Then, go to the Transaction screen and scan the item.
      • If no item appears on the Item List, the scanned UPC is not associated with an item in inventory. Either add a new item with that UPC or add the UPC to an existing item. If the item’s barcode was printed using ShopKeep Label Printing, print a new label for the item.

"Invalid search"

This message appears if a transaction number is entered incorrectly when attempting a return. Double check the numbers on the receipt and the numbers entered on the transaction history screen to make sure that they are correct.

"Something went wrong"

This error can occur if the register has lost internet connection.

  1. Pull up on the bottom of the screen to access the menu.
  2. Tap the menu button.
  3. Tap 'Settings'.
  4. Whether using ethernet or wifi, make sure that you are connected to the network.

    If you connect using Wifi and your device is connected to the wrong network, tap ‘Cancel’ and connect the device to the correct network.

  5. If the problem persists, contact your internet service provider.

"Card number is invalid" / "Card number length is not correct"

These errors appear on the register’s screen if a customer makes a mistake while manually entering their credit card information.

  1. Tap 'OK' to dismiss the error.
  2. Have the customer re-enter their card number.

"Transaction failed: invalid card"

This error appears on the register’s screen if a customer swipes something other than a credit/debit card, like a gift card. It can also occur if the card’s magnetic strip is damaged.

  1. Tap 'OK' to dismiss the error.
  2. Have the customer swipe a valid credit or debit card.
  3. If the swipe fails again, manually enter the card information.

I'm receiving a credit card processing error not listed on this page.

  1. If you cannot find the error, contact ShopKeep Customer Care.

Checks Screen Issues

This section covers issues related to the Checks screen.

“Unable to merge”

This error occurs when a manager tries to merge checks with different owners. Transfer checks to the same employee to be able to merge them.

  1. Tap ‘OK’ to dismiss the error.
    Click to Enlarge
  2. Transfer checks being merged to the same employee.
  3. Complete the merge again.

“Check merge warning”

When checks are merged, high-level settings such as customer assignments, transaction-level discounts, and tax removal are not automatically applied to the merged check. Decide whether to continue with the merge, then reapply these settings if necessary.

  1. Tap ‘Yes’ to merge the checks or ‘No’ to cancel the merge.
    Click to Enlarge
  2. (Optional) If yes, reapply the relevant check-level setting(s) to the new merged check.

    Assign a customer, apply a transaction-level discount, or toggle the tax off.

“Register Offline Warning”

When modifying a check from a register without an internet connection, the register may not be in sync with the latest version of the check. Review the best practices within this warning to determine how to proceed.

  1. Tap ‘Show Best Practices’.
    Click to Enlarge
  2. Read the best practices, then tap ‘Cancel’ or ‘Continue’.

    We recommend tapping ‘Cancel’, then switching to an online register to modify the check. If you only have one register, it is safe to continue, but the check will not be backed up until connectivity is restored.

    Click to Enlarge
  3. Continue troubleshooting below based on the option selected in the previous step.
    If you tapped ‘Cancel’:
    • Go to an online register and modify the check from there. Do not create or modify checks on the offline register until internet connectivity is restored.
    • If no other registers are online, modify the check from the offline register, tap ‘Continue’, then skip to the section below.
    • Troubleshoot the internet connection of the offline register. If connected via ethernet, make sure the cable is plugged into both The Mini’s Hub and the router. If connected via Wi-Fi, exit to the The Mini’s home screen from the register menu, then open the ‘Settings’ app and reconnect to your network.
    • Be aware that once connectivity is restored to the offline register, changes made from online registers will automatically sync to it.
    If you tapped ‘Continue’:
    • Finish modifying or processing the check on that register.
    • Do not modify the check from other registers until the offline register is brought back online.
    • Do not create or modify any checks from the offline register until internet connectivity is restored. If all registers are offline, only create and modify checks on a single register able to accept all payment tenders needed for checkout.
    • Troubleshoot the internet connection of the offline register. If connected via ethernet cable, make sure the cable is plugged into both The Mini’s Hub and the router. If connected via Wi-Fi, exit to the The Mini’s home screen from the register menu, then open the ‘Settings’ app and reconnect to your Wi-Fi network. If all registers are offline, reboot the router or contact your internet service provider for help restoring the internet connection.
    • If you intend to always operate this register offline, disable Check Sync & Backup to avoid receiving future warnings.
    • Be aware that once connectivity is restored to the offline register, the updated check will automatically sync to other registers.

“Check Sync & Backup Unavailable”

When disabling Check Sync & Backup on a register, the register will try to sync updated versions of its checks to your other registers. If the checks cannot be synced due to an internet connection issue, you must either resolve the issue or choose to delete checks from that register checks.

  1. Read the warning message and decide how to proceed.

    In most cases, we recommend tapping ‘Cancel’, then troubleshooting the register’s internet connection. If you do not want the checks to be synced, tap ‘Delete’ to remove them.

    Click to Enlarge
  2. If you tapped ‘Cancel’ in the previous step, continue troubleshooting below:
    a Troubleshoot the register’s internet connection.
    • If connected via ethernet, make sure the cable is plugged into both the Mini’s Hub and the router.
    • If connected via Wi-Fi, exit to the The Mini’s home screen from the register menu, then open the ‘Settings’ app and reconnect to your Wi-Fi network.
    • If the problem persists, reboot the router or contact your internet service provider for help restoring the internet connection.
    b Once the connection is restored, disable Check Sync & Backup again.

“Check Not in Sync”

This warning appears when the version of a check stored on a register differs from the version backed up in the cloud. Since the version in the cloud takes priority, changes made on the register will be overwritten.

  1. If there are changes you want to document, tap ‘Print’ to print a copy of the check.
    Click to Enlarge
  2. Read the warning message, then tap ‘Cancel’ or ‘Continue’.

    ‘Cancel’ will stop the current action and ‘Continue’ will overwrite the local version of the check with the version stored in the cloud. If the check was closed on another register, ‘Continue’ will remove the check from this register.

    Click to Enlarge
  3. If you tapped ‘Continue’ in the previous step, follow the steps below.
    a Review the updated check.
    b If necessary, make changes to the check.
    c Save or tender the check.

Printer and Cash Drawer Issues

Look no further for help with issues affecting the Clover device’s receipt printer, kitchen printer, or cash drawer connection.

Receipts print blank.

The printer requires special thermal receipt paper. If you loaded regular paper, receipts will print out blank.

  1. Pull open the back cover.
    Click to Enlarge
  2. Check to see if you are using thermal receipt paper.

    Thermal paper is shinier on one side and turns black when scratched.

  3. Make sure the paper is installed correctly.

    Thermal paper only prints on one side. The paper must be loaded so it feeds up from the top of the roll.

    Click to Enlarge

Not using thermal receipt paper? Purchase some from the ShopKeep Store.

My kitchen printer is not listed on the Available Printers screen.

There are a few reasons why this problem can occur while you are setting up your kitchen printer. The printer may be disconnected, connected to the wrong network, or there could be a hardware issue.

Follow the steps below to troubleshoot this issue. After each step, check if the problem is resolved.

  1. Check that the printer is connected to power and turned on.

    Visit our Epson Kitchen/Ticket Printer article for help completing this step.

  2. Make sure the printer is plugged into the same router that The Mini is connected to via ethernet or Wi-Fi.
  3. Try a different ethernet cable and router port.
    • Unplug the ethernet cable from the printer and router. Connect a new ethernet cable to the printer and plug the cable into a new port on the router.
    • Flip the printer’s power switch to turn it off, wait 10 seconds, and turn the printer back on.
  4. Restart your router.
    • Unplug the router from power, wait 10 seconds, and plug it back in.
    • Once the router is back online, turn the printer off, wait 10 seconds, and turn it back on.
  5. If the printer is connected to an extender or switch, try plugging it directly into your router.
    • Turn off the printer and unplug its ethernet cable from the extender/switch.
    • Plug the ethernet cable directly into the router, then power the printer back on.

“Kitchen ticket print failure”

This error appears when you print a ticket to a kitchen printer that is disconnected.

  1. Follow these steps above to troubleshoot and resolve this issue.

My kitchen printer is connected, but tickets do not print.

This problem usually occurs when you skip a step during the printer’s initial setup. If there are no error messages in ShopKeep and no error lights lit on the printer, continue below to troubleshoot.

  1. Follow the steps here to see if the printer is listed on the Kitchen Printers screen.
    Click to Enlarge
    • If the printer is not listed, tap the ‘+’ button to search for and set up the printer.
    • If the printer is listed but is not switched on, tap the switch to toggle it on.
    • If the printer is listed and is already switched on, go to step 2.
  2. In BackOffice, make sure Printer Groups are properly set up. Learn how to set up Printer Groups here.

    Printer Groups allow you to manage which items print to the kitchen printer. Each Printer Group must have at least one department or category of items and one or more printers assigned to it.

    Click to Enlarge
  3. On The Mini, tap ‘Get Updates’ on the register menu.
    Click to Enlarge

My kitchen printer’s ERROR or ! light is solid or blinking.

For issues involving the kitchen printer’s status lights, visit one of the troubleshooting guides below for help:

  • Kitchen/Ticket Printer Troubleshooting
  • Epson Printer Troubleshooting
  • The cash drawer does not open.

    This issue can occur for a variety of reasons. After each step below, check to see if the problem is resolved.

    1. If performing a sale, make sure you tendered it to Cash.

      The drawer opens for Cash sales but not for other tenders, such as Credit.

    2. Check that the drawer's lock is in the vertical position (unlocked).
    3. Make sure the correct cash drawer cable is in use.
      • For APG cash drawers, you must use the CD-101A cable. Purchase a new cable here, if necessary.
      • For the Clover cash drawer, you must use the cable that came with the drawer.
    4. Disconnect the cash drawer cable from the Hub and the drawer, then reconnect it.

    Settings Issues

    This section covers issues related to the options found in the Settings section of the register menu.

    Some credit sales do not ask for a customer signature.

    A signature threshold prevents sales below a specific amount from prompting for a signature. Change or remove this restriction in the Setup app.

    1. Sign into ShopKeep as a manager and tap ‘Settings’.
      Click to Enlarge
    2. Tap ‘Card signature threshold’ to open the Setup app.
      Click to Enlarge
    3. Follow the steps here to set a new threshold or disable it.

    ‘Print receipt’ or ‘Email receipt’ is automatically selected for every transaction.

    Disable the register’s optional receipt settings to turn off automatic receipt printing or emailing. Cashiers will still be able to manually print or email receipts for transactions that need them.

    1. Sign into ShopKeep as a manager and tap ‘Settings’.
      Click to Enlarge
    2. Toggle ‘Always print receipt’ and/or ‘Always email receipt’ off.
      Click to Enlarge

    Miscellaneous Issues

    This section covers miscellaneous issues unrelated to the sections above.

    The business name displayed on my device is incorrect.

    The ‘Sign in’ screen displays the business name entered for your receipts in ShopKeep BackOffice. Follow the steps below to learn how to update it.

    1. In BackOffice, click 'Settings' and select 'Receipts and Tips'.
    2. Click the 'Business Info' tab.
      Click to Enlarge
    3. Enter the correct 'Store Name'.
      Click to Enlarge
    4. Click 'Save'.
    5. Tap 'Get Updates' on the Clover device.

    I forgot my passcode.

    Don’t worry, just get in touch and we will resolve the situation.

    1. Contact ShopKeep Customer Care to reset the passcode.

    How do I power off my device?

    The Clover device can be left on indefinitely. If you need to relocate the device, complete the step below to power it down.

    1. Unplug your Clover device from its power outlet.

    How do I reboot my device?

    Sometimes rebooting is a necessary troubleshooting step that helps resolve stubborn issues.

    1. Sign into ShopKeep as a manager and tap the House icon.
      Click to Enlarge
    2. If prompted, enter the Clover device’s passcode.
      Click to Enlarge
    3. Swipe down from the upper right corner of the screen and tap 'Reboot'.
      Click to Enlarge
    4. Tap 'Reboot' again to confirm.
      Click to Enlarge

    There's been an error getting updates. Please try again later.

    This error can occur if the register has lost internet connection.

    1. Pull up on the bottom of the screen to access the menu.
    2. Tap the menu button.
    3. Tap 'Settings'.
    4. Whether using ethernet or wifi, make sure that you are connected to the network.

      If you connect using Wifi and your device is connected to the wrong network, tap ‘Cancel’ and connect the device to the correct network.

    5. If the problem persists, contact your internet service provider.

    • Help us improve ShopKeep Support. Was this article helpful?
    • YES   NO