Skip to main content

Lightspeed K-Series: Integration Troubleshooting

Fixing issues that might occur with the Lightspeed K-Series Integration

Written by Koen
Updated today

Your integration between Lightspeed K-Series and Leat is no longer working as it should. This article outlines how you can solve issues that might arise in this integration.


Loyalty Button on Lightspeed K-Series POS is not working

There are a few different things you can check to see where it might be going wrong.

  1. Make sure that the integration is currently active via your Business Dashboard

    1. Go to Apps -> Integrations -> Installed -> K-Series
      Click on the integration, if the integration hasn't been used for a while, you'll get a warning message and it will ask you to re-authorise. Follow the steps to re-authorise, then go back to your Lightspeed K-Series POS and check if the button is working.

  2. Verify that the correct Webextension URL is currently being used.

    1. Log-in to your Lightspeed K-Series backoffice. Using the menu on the left-hand of the screen navigate to Operations -> Web Extensions

    2. You should see a Loyalty (or Leat) web-extension listed here, click on it.

      1. You're going to double-check the URL to make sure it's correct.
        To check this, go to your Leat Dashboard then Apps -> Integrations -> Installed -> Lightspeed K-Series. Once you've clicked on the integration, go to the Web extensions tab. Use the top URL (All-in-One - Web extension URL) and copy it into the web-extension in your Lightspeed back-office.

      2. Also important is to make sure that the first checkbox is marked, and looks like it does in the image below.

      3. The last step is to make sure you press Save. Then you can go to the Lightspeed K-series POS, and check that it is now working.


Claiming a reward, or a voucher, through Lightspeed K-Series POS is not working

The first thing to check is the settings within the reward itself.

  1. Open your Leat Dashboard and navigate to the rewards. Loyalty -> Rewards and click on the reward that is not working as it should. Click on K-Series.

    1. You should see three fields: Discount, Apply to and Items. If these fields are empty, that means that the POS does not know which items are linked or what kind of discount to give. Therefore it will not work. Follow the instructions within this article to set it up correctly.

      Once you are finished, it should look similar to the above example. Essentially what this set-up means is: the free drink of choice is a 100% discounted reward that is applicable to those items that are listed.

    2. If the reward is a sub-item please make sure you have created the special item as explained in the Integration Installation.

  2. In the case that a voucher is not working.

    1. Ensure that the correct redemption process is followed. Vouchers that offer a fixed € discount, or a % discount, need to be redeemed after items have been added to the bill. So that the calculation can take place how much should be discounted.

    2. If you are following the correct redemption process, navigate to your Business Dashboard -> Loyalty -> Promotions & Vouchers


The transactions on Lightspeed-K series are not coming through into Leat?

  1. Contact Lightspeed K-series Support and Double-check if realtime notifications are active. Ask their support team: please check if the Real Time notifications for Leat for the relevant business location(s) have been enabled.

    1. You can reach them via email or through the Lightspeed back-office (a human agent is needed to set it up or check in your Lightspeed account for you).

    2. If they have not been enabled, please ask Lightspeed support the following question:

    Could you please activate the Real-time notification for Leat for our location(s)?


Whenever we try to top-up a giftcard, we see a negative amount on the bill?

  1. This likely has to do with the set-up of the Giftcard Item in Lightspeed.

    1. Log-in to your Lightspeed K-Series backoffice. Once logged in, navigate to Menu -> Item list and check if there is an Item called LEAT-PRODUCT-ITEM.

      1. If that item does exists, open it and make sure that the price type is set to Manually-entered price.

      2. If that item does not exist, create a new item.
        As Item name, use: LEAT-PRODUCT-ITEM
        For the the SKU: LEAT-PRODUCT-ITEM

        And the price type is: Manually-entered price

      Once you're done, it should look like this:

Naming the Lightspeed discount for the integration

When creating the discount used for the Lightspeed K-Series integration, it’s important to follow a clear and consistent naming convention. Incorrect naming can cause the discount to not be recognised correctly by the integration.

Best practices are to:

  1. Avoid using capital letters

  2. Avoid using spaces

  3. Avoid using special characters (such as @, $, %, etc.)

For example, a discount name like leat_discount will work correctly, while names such as Leat Discount or LEAT-Reward% may cause issues with the integration.


'Session is locked' error code

This takes place when trying to redeem a reward when a customer has identified themselves by manually inserting their email address into the POS instead of scanning their wallet pass.

For Lightspeed k-series, if you would like to enable reward redemption at the POS with manual entry of their email address, the setting can be enabled under Apps -> Integrations -> Installed -> Lightspeed K-Series -> Settings.

Did this answer your question?