ShopKeep Pay Troubleshooting

This guide provides solutions to issues you may experience while logging into the ShopKeep Pay app, using it to close saved sales and eCommerce online orders, and running new cash and credit sales in the app.

Need help downloading and using ShopKeep Pay for the first time? Visit our ShopKeep Pay for iOS article.

Table of Contents

Login Issues

This section covers issues related to logging into the ShopKeep Pay app.

I am unable to log into ShopKeep Pay.

If you receive an error when logging into ShopKeep Pay, make sure you have BackOffice access, check that your login details are entered correctly in ShopKeep Pay, and try again.

  1. Ask the Business Owner or an employee with relevant permissions to check if you have BackOffice access.

    Cashiers and Register Managers must have a valid BackOffice login and cannot use a register code to log in. To prevent employees from accessing most BackOffice features while still being able to use ShopKeep Pay, assign them the ‘Receive Inventory’ role or uncheck all boxes on the ‘Permission List’.

    For help managing employee permissions, visit the Manage Staff article.

  2. Re-enter the store name.

    The store name is one word, lowercase, and contains no spaces.

  3. Re-enter the email address.
    • For Business Owners, this is the email originally used to create the ShopKeep account.
    • Other BackOffice users must provide the ‘Login Email’ entered for them in the Staff List.
  4. Re-enter the password.

    The password is case-sensitive and should be entered the same as when signing into BackOffice. Can’t remember your password? Follow the steps here to reset it.

  5. Tap 'Sign In'.

I need to log out of ShopKeep Pay

Logging out of the ShopKeep Pay app is not currently supported, but you can delete the app if it is no longer needed or reinstall the app to allow a different employee to use ShopKeep Pay on the same device.

  1. In ShopKeep Pay, open the Main Menu, tap 'System Diagnostics', and make sure there are 0 items in the 'Pending/Delayed Queue'.

    If there are more than 0 items, follow the steps here to troubleshoot the pending/delayed queue before completing the next step. Failure to resolve the queue will result in data loss after completing step 2.

  2. Follow the steps here to delete the ShopKeep Pay app.

    Failure to complete step 1 may result in data loss after completing this step.

  3. (Optional) Redownload ShopKeep Pay from the Apple App Store, and log in.

    For help with this step, visit our ShopKeep Pay for iOS article.

Saved Sale Syncing Issues

This section covers issues related to how saved sales sync to ShopKeep Pay from the ShopKeep Register app and ShopKeep eCommerce.

Saved sales are not appearing in ShopKeep Pay.

This issue usually indicates Saved Sales Sync is not enabled on each register, there are internet connection issues, or eCommerce online ordering is not enabled. After troubleshooting these potential causes, manually refresh the Saved Sales screen if necessary.

  1. Follow the steps here to enable Saved Sales Sync on all relevant registers.
  2. Troubleshoot the internet connection on the iPhone running ShopKeep Pay and on each register.

    For help completing this step, visit the next issue below.

  3. If online orders are not appearing in ShopKeep Pay, follow step 1 here to enable the online ordering feature in BackOffice.
  4. In ShopKeep Pay, open the Main Menu, tap 'Get Updates from BackOffice', and select 'Get Updates'.

“Register is Offline” or “Saved Sales Sync Unavailable”

These errors will appear when the device running ShopKeep Pay is experiencing an internet connection issue.

  1. Troubleshoot the internet connection on your device.
    • Make sure at least 2 cellular or Wi-Fi signal bars are lit up.
    • If connected to a Wi-Fi network, open the Settings app and check that you are still connected to the correct network.
  2. Open Safari and perform an internet search.
    • If search results load, force quit and re-open ShopKeep Pay.
    • If search results do not load, proceed to step 3.
  3. If the problem persists, perform steps 3a - 3b below.
    a  If connected to a Wi-Fi network, make sure your network follows our best practices. Ask someone familiar with the network to reboot the modem and router.
    b  Contact your internet service provider for help restoring the internet connection.

Credit Card Processing Issues

This section covers issues related to processing credit cards in ShopKeep Pay.

“Invalid Entry”

This error means the Card Number, Expiration Date, Billing ZIP, and/or CVV code were entered incorrectly for the credit transaction.

  1. Tap 'OK' to dismiss the error.
  2. Re-enter the card information.
    • Most credit card numbers are at least 14 digits and begin with 2, 3, 4, 5, or 6.
    • For Discover, MasterCard, & Visa: CVV is the 3 digits on the back of the card next to its last 4 digits.
    • For American Express: CVV is 4 digits on the front of the card above the card number.

“Gateway Couldn’t be Reached”

This error occurs as a result of the device running ShopKeep Pay having little to no internet connection.

  1. Follow the steps here to troubleshoot this issue.

"Card Declined" Or "Decline"

‘Card declined’ and ‘Decline’ both mean the attempted charge was refused by the customer’s bank.

  1. Tap 'Retry' to try charging the card again.
  2. If declined again, have the customer contact their bank, or finish the sale with a different card or tender.

My credit card processing error is not listed here.

  1. Visit a credit card reader troubleshooting guide on this page to see if the error is documented.
  2. If unable to resolve the error, contact Customer Care for assistance.

Miscellaneous Issues

This section covers miscellaneous issues not included in the sections above.

“Sync Error”

This error appears while getting updates if the device running ShopKeep Pay has little to no internet connection.
  1. Follow the steps here to troubleshoot this issue.

Pay by Link sales are not currently supported in ShopKeep Pay and must be closed from the ShopKeep Register app.

  1. Open the ShopKeep Register app.
  2. Follow the steps here to complete the sale at the register.

I’m having a problem with my credit card reader or receipt printer.

For help with issues related to integrated hardware, visit the dedicated troubleshooting guide for the credit card reader and/or printer you are using.

  1. Visit the relevant troubleshooting page listed below, then select the specific troubleshooting article for your card reader or printer.

Sales closed in ShopKeep Pay do not appear on X and Z reports or the Shifts Summary report.

Because ShopKeep Pay does not use register shifts, saved sales closed in the app will not appear on X and Z reports run at the register or in the BackOffice Shifts Summary report. Saved sales closed in ShopKeep Pay are included in other BackOffice reporting, such as the Dashboard and Transactions Report.

On the Diagnostics screen, there are items in the Pending / Delayed Queue.

The Pending Queue / Delayed Queue represents the amount of data on its way to BackOffice from ShopKeep Pay. If the number of items in these queues is more than 0, follow the steps below to fix the issue.

  1. Make note of the number of items in the queue.
  2. Follow the steps here to troubleshoot the internet connection of the device.
  3. Wait 10 minutes, then check the queue again.
  4. Follow the set of steps below that reflects the behavior of the queue.
    • If the number of items in the queue has decreased:
    a  Wait until the queue reaches 0.
    • If the number of items in the queue has not decreased:
    a  Make sure ShopKeep Pay has an internet connection.
    b  Load a website or perform another function that requires internet.
    c  If connected via Wi-Fi, ask someone familiar with your network to reboot the modem and router.
    d  Contact your internet service provider for help restoring the internet connection.

The ShopKeep Pay app crashed.

The ShopKeep Register app may close unexpectedly or crash if it encounters an error. Follow the steps below to troubleshoot and fix this issue.

After each step, check to see if the problem is resolved before completing the next step.

  1. Update the ShopKeep Pay app to the latest version.

    For help updating, visit our Introduction to the iPad article.

  2. Force quit, then reopen ShopKeep Pay.
  3. Turn your device off, then back on.
  4. Follow the steps here to delete and reinstall ShopKeep Pay.