VaocherApp
Docs

Lightspeed Restaurant (K-Series) - Integration Setup

Connect VaocherApp with Lightspeed Restaurant (K-Series) to manage gift vouchers directly from your POS.

The integration allows your team to sell, issue, and redeem VaocherApp gift vouchers while keeping voucher balances synchronised between Lightspeed and VaocherApp.

This integration is designed for hospitality businesses using Lightspeed Restaurant, including restaurants, cafés, bars, hotels, and other venues.

Before you start

Before connecting Lightspeed Restaurant (K-Series), make sure you have:

  • An active VaocherApp account.
  • An active Lightspeed Restaurant (K-Series) account.
  • Administrator access to both platforms.

Create a Gift Vouchers accounting group in Lightspeed

First, create an accounting group that will be used for voucher transactions.

In Lightspeed Back Office, go to:

MenuAccounting Groups

Click Add Accounting Group.

Configure the following:

Field Value
Name Gift Vouchers
Accounting ID vaocherapp_accounting_group
Tax Profile Tax Free

Click Save.

Create Accounting Group
Create Accounting Group

Create a Gift Card item

Next, create a dedicated gift card item in Lightspeed.

Go to:

ItemsCreateSingle Item

Configure the item:

Field Value
Item Name Gift Card
Accounting Group Gift Vouchers
Price Type Manually Entered Price

Click Save.

Create Gift Card Item
Create Gift Card Item
Gift Card Item Details
Gift Card Item Details

Connect Lightspeed to VaocherApp

  1. Log in to your VaocherApp account.
  2. Go to SettingsIntegrationsLightspeed Restaurant (K-Series).
  3. Click Connect Lightspeed.
  4. You will be redirected to Lightspeed. Approve the connection request and return to VaocherApp.
  5. Configure the following:
  • Business
  • Location
  • Gift Card Item
  1. Select the Gift Card item you created earlier.
  2. Click Save Changes.

Your Lightspeed integration is now connected.

Create the VaocherApp Web Extension

The Web Extension allows Lightspeed POS to communicate with VaocherApp.

In Lightspeed Back Office, go to:

OperationsWeb Extensions

Click Create Web Extension.

Create Web Extension
Create Web Extension

Open your VaocherApp integration settings in another browser tab and copy your Web Extension URL.

Copy Web extension URL
Copy Web extension URL

Configure the following:

Setting Value
Name VaocherApp Gift Cards
URL Your VaocherApp Web Extension URL
Provide Javascript Context Enabled
Allowed Loading Domain lightspeed-kseries-web-extension.vaocher.app
Configure VaocherApp Web Extension
Configure VaocherApp Web Extension

Click Save.

Add Gift Cards to your POS menu

To access VaocherApp vouchers from Lightspeed POS, add a Gift Cards button.

Go to:

Menu ManagementMenus

  1. Open your active menu.
  2. Under Main Screens, click Add.
  3. Create a new button with:
  • Name: Gift Cards
  1. Open the new button.
  2. Click Add ButtonWeb Extension.
  3. Select VaocherApp Gift Cards.
  4. Click Update & Reload Devices.
Add to POS Menu
Add to POS Menu
Add Button Web Extension
Add Button Web Extension
Add Gift Cards Button
Add Gift Cards Button

The Gift Cards button will now appear on your POS.

Enable Real-Time Notifications

Real-Time Notifications (RTN) allow voucher sales created from Lightspeed POS to sync automatically with VaocherApp.

Without RTN enabled, vouchers issued from Lightspeed cannot be created automatically in VaocherApp.

To enable RTN:

  1. Go to your VaocherApp integration settings.
  2. Click Copy Notification Template.
  3. Contact Lightspeed Support and request that Real-Time Notifications (RTN) be enabled.

Support email: k-series.support@lightspeedhq.com

Once RTN has been enabled, voucher orders created through Lightspeed will sync automatically.

Email Template to Enable RTN
Email Template to Enable RTN

Create a VaocherApp payment method

Create a dedicated payment method in Lightspeed.

Create VaocherApp Payment Method
Create VaocherApp Payment Method

For example:

VAOCHERAPP

After creating the payment method:

  1. Go to POS ConfigurationPayments.
  2. Remove VAOCHERAPP from the accepted payment methods.

This payment method is used internally for voucher processing.

POS Configuration - Payments
POS Configuration - Payments

Your Lightspeed Restaurant (K-Series) integration setup is now complete.