Cashier Functions Troubleshooting
Troubleshoot issues that may occur while performing cashier functions on the register’s Main Menu, such as problems with returns, shift reports, or gift cards.
Sales History Issues
Troubleshoot issues with the Sales History screen functions, such as returning sales or reprinting receipts.
I accidentally returned a sale.
Though returns cannot be canceled or undone, you can balance out the day’s net sales and inventory quantities by running another sale.
- Run a sale for the same items that were returned.
-
Finish the sale to the same tender as the return.
If the return was for Credit, you will need to swipe the customer’s card again to charge them.
I cannot find the sale I need to return.
The Sales History screen displays transactions processed at that register during the current register shift and excludes transactions processed in the Lightspeed Pay and Lightspeed Pocket apps. Follow the steps below to return a sale from a previous shift or one tendered outside the Retail POS (S-Series) app.
For help returning Lightspeed eCom (E) orders, visit the eCommerce Troubleshooting guide.
-
For sales processed during a previous register shift or in the Lightspeed Pay app, use the search bar to look up the sale.
Search by transaction number, last 4 digits of the credit card used, or scan the barcode on the receipt.

Or tap the expand arrow and select Customer to search by customer name, email, or phone number.

- For sales processed in the Lightspeed Pocket app, complete a manual return.
- Finish returning the sale.
Refer to the Performing Returns article for more information.
"No matching results" / "Invalid search"
These errors indicate a problem with the criteria used to search for a transaction. Check that everything was entered correctly to resolve the issue.
-
If searching by transaction number, check that you entered the correct number from the receipt. It is the 19-digit Transaction #, not the Order #.

- If searching by the last 4 digits of a credit card, make sure you entered the digits correctly.
- Re-enter the transaction number or last 4 digits and try again.
The 'Credit' button is missing from the return screen.
Cashiers can only return a sale to credit if the original sale was paid by credit card. If the Credit button isn't displayed, you must return the sale as a different tender, such as Cash.
“Returning too much” or "Already returned"
These errors indicate that the amount you are trying to refund exceeds what is allowed. This is because either part of the sale or the entire sale was already returned. Remove items from the return or process a manual return.
"Unknown error. Could not verify the original sale with BackOffice."
This error occurs when returning a sale while BackOffice is undergoing scheduled maintenance. Read below to learn how to proceed.
-
Tap OK to dismiss the error.

-
Either process a manual return or try the return again later once maintenance is complete.
You can monitor the status of the maintenance work at status.shopkeep.com.
"Connection failed"
This error means the register has either an unstable connection or no internet connection. The Lightspeed Retail POS must be connected to the internet to utilize certain features, such as returning a sale.
-
Tap OK to dismiss the error

- Follow these steps to troubleshoot your network connection.
- If unable to complete a return, process a manual return.
I cannot find the receipt I need to reprint or resend.
By default, the Sales History screen only displays transactions from the current shift. If you cannot find the transaction you need to reprint or resend, use the search bar to search all shifts, past and present.
Refer to these steps for additional information.
I get an error message when I try to reprint a receipt.
Visit one of our printer troubleshooting guides to resolve the issue with your printer.
'Reprint Gift Receipt' is grayed out.
If the Reprint Gift Receipt option is grayed out, it means either a return or a sale from a previous shift is selected. Gift receipts cannot be reprinted for these types of transactions.
Register Shift Report Issues
Trouble with the Register Shift Report? We’ve got you covered.
I cannot print my X or Z report.
Use one of our printer troubleshooting guides to diagnose and solve the problem.
Transactions are missing from my X or Z report.
X and Z reports summarize sales activity taking place on a specific register during a register shift. If transactions appear to be missing from these reports, consider the following possible explanations:
- Transactions closed on other registers are only included in X and Z reports run from those registers.
- If a new register shift is opened, transactions processed during the new register shift are not included on Z reports for previous shifts.
- Sales processed outside the Retail POS (S-Series) app, such as in the Lightspeed Pocket and Lightspeed Pay apps, don't display on X and Z reports.
Gift Card Issues
Troubleshoot gift card-related issues.
"This register does not have gift cards set up yet."
If you got an email stating your account is set up for gift cards, follow the steps below to fix this issue.
This feature is only available for Lightspeed Retail merchants on select pricing packages.
- Make sure you followed all of our setup instructions.
- You must be logged into the Retail POS app as a Manager.
- Then, get updates from BackOffice on the register.
- Check the gift card balance again.
“Could not connect to processor” or “Cannot connect to processor”
These errors occur when the register has a poor connection to the internet or no connection at all.
This feature is only available for Lightspeed Retail merchants on select pricing packages.
- Press the Home button to exit the Retail POS (S-Series) app.
- Open a web browser and perform a Google search.
- If search results load, force quit and re-open the Retail POS (S-Series) app, then check to see if the issue is resolved.
- If search results don't load, follow these additional steps:
- Open Settings and tap Wi-Fi.
- Check if the register is connected to the correct network.
- If the register is connected to the correct network, reboot the device and try the sale again.
- If not, switch to the correct network, force quit the Retail POS (S-Series) app, and try the sale again.
- If the problem persists, reboot the router or contact your internet service provider for help restoring the internet connection.
Visit our Best Practices guide for tips to reduce network connectivity issues to ensure the most reliable Lightspeed Retail experience.
The register is prompting me to manually enter a gift card.
This means there is a problem with the connection between the register and your card reader. Visit one of our credit card reader troubleshooting guides for help resolving the problem.
This feature is only available for Lightspeed Retail merchants on select pricing packages.
A black box displays when I try to scan a gift card barcode.
If you're unable to scan gift card barcodes with the iPad camera, it means the Retail POS (S-Series) app does not have permission to use the iPad camera. Enable camera access for the Retail POS (S-Series) app to resolve the issue.
-
Tap Tap to Allow Lightspeed Camera Access to open iPad settings for Retail POS (S-Series).

-
Toggle the Camera setting on.

- Return to the Retail POS (S-Series) app, and complete the transaction.
“No response from gift card provider”
This error can occur if there is a problem with your register’s internet connection or a widespread gift card processing issue.
- Follow these steps to troubleshoot the register's internet connection.
- Visit the status page to check for any known gift card processing issues.
- If the problem persists, contact support.
Miscellaneous issues
Troubleshoot additional miscellaneous cashier issues.
I can't save a sale to a table in the Tables screen.
Saved sales must be created directly from the Tables Screen to be assigned to a table. Learn more by reading our article on Using the Table Layout.
“Quantity on Hand tracking disabled”
This error occurs when checking the quantity on hand (QoH) of an untracked inventory item. Read below to learn how to track the item.
-
Tap OK to dismiss the error.

- In BackOffice, enable inventory tracking for the item.
-
Ensure you're logged into the Retail POS app as a Manager. At the register, Get Updates from BackOffice to sync the change in inventory tracking to the register.

An item’s quantity on hand is incorrect.
An incorrect quantity on hand (QoH) may mean the item was not sold or returned properly, was not received in BackOffice, or was stolen. Adjust the item’s quantity to the correct number.
On the System Diagnostics screen, there are a number of items next to the Pending Queue or Delayed Queue.
The Pending Queue and Delayed Queue represent the amount of data on its way to BackOffice from the register. If the number of items in these queues does not go down, follow the steps below to fix the issue.
- Make note of the number of items in each queue.
- Check the internet connection on the register.
- Wait 10 minutes and check the queues again.
- Follow the specific steps below that reflect the behavior of the queues.
If the number of items in the queues has decreased, wait until each queue reaches 0.
If the number of items in the queues has not decreased:
- Check that the register is connected to the correct WiFi network. If not, reconnect it to your network.
- Load a website or perform another function that requires internet.
- Ask someone familiar with your network setup to reboot the modem and router.
- Contact your internet service provider for further assistance troubleshooting your network connection.
I'm having a problem with a cashier function not covered here.
Visit our Retail POS (S-Series) App Troubleshooting page for links to troubleshooting guides covering other cashier topics, such as the New Sale screen and Saved Sales screen.