LS Pay Service and LS Express Setup

LS Express has integrated communication with the LS Pay Service, a service run locally handling the connection to all EFT devices supported by LS Pay. LS Pay Service is a Windows service hosting LS Pay with a SignalR endpoint.

New partners and customers are encouraged to utilize the LS Pay Service, while existing customers are urged to migrate to it as well. LS Retail plans to phase out the older LS Pay UWP app and discontinue support for it in the future.

Hardware and Software requirements

The computer that will be running the service needs to be running on Windows and have the .net(#) package installed. When installing the LSPay service exe file, you should be notified if your computer is missing the package and, it redirects you to a website where you can download.

How to: Get the LS Pay Service

The first step is to download the LSPay service package from the LS Retail Partner Portal.

Detailed setup instructions can be found on the LSPay Online Help.

Configure the appsettings.json

Important note: In order for the LS Pay service to have access into LS Express, the Admin UI URL needs to be configured. The configuration file is located in the installation folder named appsettings.json (the default path is C:\LS Retail\LSPay\Service unless it was altered in the setup).

Open the file appsettings.json and modify the AdminUI URL:
Save the file.
The LS Pay service needs to be restarted for this change to take effect.
Open Windows Services, scroll down to locate the LS Pay Services in the list and Restart the service.

Add and Configure a Terminal Connection

Once you have installed the LS Pay Service app and configured the appsettings.json, you can add a terminal connection to connect the LS Pay Service. The LS Pay Admin tool provides all the configuration needed for the LS Pay Service to work. Detailed configuration step-by-step can be found here.

Connect LS Express to the LS Pay Service

To configure LS Express to use the LSPay Service, open the LS Express Administration, and turn on the Enable LS Pay Service toggle.

Note: This toggle is visible in Cronus demo companies and companies that have added the LS Pay module to the LS Express license.
Then open the Sales Profile card. Path: Administration > Navigate > Sales Profile
On the Sales Profile Card, enter the Connection ID and URL.

Now LS Express should be able to run the service.

Operating LS Express POS with the LS Pay Service

For LS Pay to be triggered in the POS, a Payment Method needs to be configured to use the LS Pay Service.
Either add LS Pay to an existing payment method or create a new one.
Once LS Pay has been added to the subscription (or if it is a Cronus company), and the Enable LS Pay Service toggle has been activated, a toggle is visible in the Payment Method's settings.

To accept and refund the payment using the LS Pay Service, see How to use LS Pay Service.