Configuring ScanPayGo

In this article

Stores

Retail items

Hierarchy

ScanPayGo users

Offers and Published Offers

Purchase history

Notifications

This article is an overview of LS Central data setup that is used by the ScanPayGo app.

ScanPayGo customers are members in LS Central so Member Management must be set up.

The most important data is:

  • Items

    • Price
    • Image for the item
    • Detailed description for the item, the HTML text
    • Barcode
  • Member Management in general
    • Member logins with password
  • Offers and publish offers
  • Stores
    • Location on map
    • Store image
    • Store opening hours
  • Customer Order setup
  • Hierarchy
    • The hierarchy for the items that can be viewed in the app.

Stores

The ScanPayGo app can detect the store users are in, when they enter the store and open the app.

The app also offers the option of manually selecting the store from a list of stores. You can set up a default store in the app's Settings.

The app needs to know in which store the user is shopping, so the app can get the item list and other information from the store’s setup.

The ScanPayGo app needs the following information from LS Central’s Store card:

  1. General FastTab
    • Store name
    • Store address
    • Store phone number
    • Longitude and latitude coordinates for the store’s location on the world map.
  2. Omni FastTab
    • Loyalty, this is a toggle field. If the field is On , the store is included in the store list.
  3. Retail Calendar FastTab
    • Opening hours for the store are registered here.
  4. Hierarchy Dates FastTab
    • Here you put in the hierarchy code for the item list that is shown in the app.
    • Select Validation period.

Retail items

Items in the ScanPayGo app are the same items with the same information that LS Central uses. The app displays items with an expanded description and an image.

The app needs the following information from LS Central's Retail Item Card:

  1. Item description
  2. Unit price including VAT
  3. Item barcode that can be scanned
  4. Images - Retail image link
  5. Item HTML
    • Here you can create a detailed description for the item in HTML format.
      Note: This is not necessary for the ScanPayGo app, but you can entered this information here to provide extra information about the item in the hierarchy or while scanning.
  6. Other general data.

Hierarchy

The ScanPayGo app can display items in a hierarchy. For this to work, the setup must include:

  1. A hierarchy that includes the items to be displayed in the app.
  2. It is recommended to link images to the hierarchy’s nodes.
  3. It is recommended to link images to the item’s in the hierarchy. This is done in the Retail Item card in LS Central.
  4. The stores that can be used by the ScanPayGo app must have a link to their hierarchy.
    • This setup is in the Store card, in the Hierarchy Dates FastTab. Note: Make sure this setup is valid.
  5. For more information about Hierarchies, see the LS Central Help.

Tip: The LS Central Demo Data Company has an example of a hierarchy called Grocery that is linked to store S0001.

ScanPayGo users

ScanPayGo users or loyalty customers are members in LS Central, so the Member Management functionality in LS Central is required, that is data for member clubs, member schemes, member accounts, member contacts, member login, and so on.

For more information about Member Management in LS Central see the LS Central Help.

To login to the ScanPayGo app as a user, you must have a member login, that is a user ID and a password. User IDs and password can be created in the app and in BackOffice, in the Member Login Card.

For ScanPayGo demo purposes, the member club CRONUS-SPG is included in the LS Central Demo Data Company.

Offers and Published Offers

Data for offers in ScanPayGo are prepared in LS Central.

  1. Set up the offers in LS Central.
  2. Import the offers into Published Offers in LS Central, where you add an image and extra text for each offer.

Note:

  • Only offers that are included in Published Offers in LS Central can be displayed in the Offers part of the ScanPayGo app.
  • Only valid offers are displayed in Offers in the ScanPayGo app.

Offers in the ScanPayGo app can be divided into Personal and General groups:

  • Personal - are offers that are triggered with member information.
  • General - are offers that do not have triggers connected with members.

Purchase history

Purchase history in the ScanPayGo app can only be displayed when the loyalty customer or member has logged into the app, because the function only shows the purchase history of a logged-in user.

The Purchase History screen in ScanPayGo shows all POS sales and sales generated in the app.

Notifications

Notifications when Item is added or removed from basket or when new member is added or removed from basket, can be sent to all device of members that are sharing a Basket. To activate notification, open TenantConfig table in Commerce Database, and set these Keys:

  • SPG_Notify_FollowerUpdate: Send when member is added or removed from basket.
  • SPG_Notify_ItemUpdate: Send when item is added or removed from basket.

The text that is sent with each notification is set in notification.xml file that is located where Commerce is installed under .\bin\spg folder. There is also firebase.json file there with connection configuration to connect to Firebase.

Parameters in the text for fields are:

  • name: Member Name
  • cardid: Member Card number
  • itemid: Item Id
  • desc: Item Description
  • listid: Basket description