Lightspeed Pay Troubleshooting

Login Issues

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

I am unable to log into Lightspeed Pay.

If you receive an error when logging into Lightspeed Pay, make sure you have BackOffice access, check that your login details are entered correctly in Lightspeed 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 Lightspeed 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 Lightspeed Retail 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 Lightspeed Pay

Logging out of the Lightspeed 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 Lightspeed Pay on the same device.

1. In Lightspeed 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 Lightspeed Pay app.

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

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

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

Saved Sale Syncing Issues

This section covers issues related to how saved sales sync to Lightspeed Pay from the Retail POS (S-Series) app and Lightspeed eCom (E).

Saved sales are not appearing in Lightspeed 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 Lightspeed Pay and on each register.

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

3. If online orders are not appearing in Lightspeed Pay, follow step 1 here to enable the online ordering feature in BackOffice.
4. In Lightspeed 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 Lightspeed 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 Lightspeed 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 Lightspeed 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 Lightspeed 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”

1. Follow the steps here to troubleshoot this issue.

Tapping a Pay by Link sale does not open the receipt screen.

Pay by Link sales are not currently supported in Lightspeed Pay and must be closed from the Retail POS (S-Series) app.

1. Open the Retail POS (S-Series) 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.
   • Credit Card Readers Troubleshooting
   • Receipt & Label Printers Troubleshooting

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

Because Lightspeed 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 Lightspeed 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 Lightspeed 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 Lightspeed 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 Lightspeed Pay app crashed.

The Retail POS (S-Series) 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 Lightspeed Pay app to the latest version.

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

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