Lightspeed

In this section we will explain the steps needed to connect your account to Lightspeed.

Information

Summary

Available payment methods

eCommerce: all online payment methods
POS: offline/instore payment methods

Name

Lightspeed | e-Commerce platform | App | Hosted Solution

Download location

App store

Refunds

Via Lightspeed backoffice or My.pay

Multi-store

Yes, you can configure an SL-code per app per domain

Instore

Yes - pin processing only. No real-time transaction insights. Giftcards and QR payments are not supported.

Payment filters

Min/max amount | country | B2B/B2C

New payment options

Automatically (no update required)

Set-up

Installation & configuration

You can easily install the app via your Lightspeed backend. Have your credentials ready.

  1. Click here and hit Install
  2. Select the webshop you would like to add the app to (login if needed)
  3. Click on Go to App to configure the app
  4. Select the Shop ID you would like to configure and fill in the following details:
  5. Service-ID (SL-xxxx-xxxx)
  6. API-token (a3e314ee...)
  7. Click Save to load all payment methods activated in your sales location
  8. Configure your plugin and click the Save button to save your changes
Installation instructions directly from backend
  1. Go to your Lightspeed backend > App Store > search for Pay.nl > Install app
  2. Click on Go to App to configure the app
  3. Select the Shop ID you would like to configure and fill in the following details:
  4. Service-ID (SL-xxxx-xxxx)
  5. API-token (a3e314ee...)
  6. Click Save to load all payment methods activated in your sales location
  7. Configure your plugin and click the Save button to save your changes

NB: you can always access the app via Purchased Apps > Go to App

Additional app settings

You will see 2 other menu's:

1. Options

Cancel order after cancelling payment

No (default) - after cancelling a payment method, the enduser can complete the transaction with an alternative payment method
Yes - order will be cancelled when the payment is cancelled

Refund

Determines which orderstate an order should have after a refund.

Auto-refund

Enable auto-refund. Select which action should trigger a refund:
No - no refund initiated
Yes - on product return
Yes - on credit invoice
Yes - both ways

Auto-Capture

Enable this setting to automatically capture authorised payments (generally Buy Now Pay Later orders) when a shipment is created.

Testmode

Enable this option to start all transactions in sandbox mode, without making any real payments.

Save order-id at note

After a completed payment, the Pay.-orderID can be added to the note-field of your Lightspeed order for reference.

Translations based on

Checkout country - payment screens will open in the same language as the checkout country
Webshop language - payment screens will open in the same language as the webshop language

Image style

Newest (default) - ensure you always have the latest brand icons in your checkout
Classic - older styles for the brand icons. This was introduced for a transition period. Please ensure you use the "Newest""setting.

Language of payment screen

Order - payment screens will open in the same language as the order
Webshop language - payment screens will open in the same language as the webshop language

2. Payment methods

Payment methods

List of available payment methods, as activated in your Sales Location.
Coloured - payment method is activate in Lightspeed
Greyed out - payment method is disabled in Lightspeed. Double click the brand icon to activate.

👍

You have now successfully connected your Pay. account to Lightspeed

Releases

Not applicable; Lightspeed is a hosted solution. You do not need to install external software. Simply connect to the app (which is hosted by Pay.) and you are ready to go.

Features

Refunds

There are 2 ways to process a refund. Please check your auto-refund settings (as described in the Set-up chapter under Additional app settings).

📘

Bear in mind that with OmniChannel, refunds can not be made from within Lightspeed.

1. Refund via credit invoice

  1. Go to Orders and select the order you would like to refund by clicking the order ID
  2. Click on Add a credit invoice
  3. Select the amount you would like to refund, ensure the Status is Not Paid
  4. Click Add
    In the order notes, you will see the message "Auto-refund success". It will be delayed for 5 minutes in case you need to make any changes.

2. Refund via product return

  1. Go to Orders and select the order you would like to refund by clicking the order ID
  2. Click on Create Return
  3. Select the products you would like to return, ensure the Status is Return Authorized
  4. Click Add
    In the order notes, you will see the message "Auto-refund success". It will be delayed for 5 minutes in case you need to make any changes.
🚧

The refund will be cancelled, if the status of the invoice or return is changed

Capture (BNPL)

When you offer Buy Now Pay Later payment methods in your checkout, the idea is to invoice your customers after they have received their products or services.

Example:

customer places order > transaction status is AUTHORIZED > webshop ships the product(s) > CAPTURE is created

In this app, it is possible to automate this flow.

Under Apps > Purchased Apps > select Pay > Go to App you will find the Auto-capture settings.

Enable this setting to automatically capture authorised payments (generally Buy Now Pay Later orders) when a shipment is created.

Paylink

It is possible to add a payment link to an email template, for example a payment reminder. A paylink can be added to each template with the ordernumberid available. Below we will show you how.

  1. Go to Settings > Notification Emails > Order payment notification
  2. Enter the relevant text. For the paylink, use the following format for the URL
    https://www.example.com/payment/pay/[[ordernumberid]]. Replace https://www.example.com with your own URL
  3. To send a payment reminder, go to Orders > select an Order > More > Send Payment Reminder
Example Paylink

Ensure the ordernumberId is added to the email template, like so:

A paylink will then be added when sending out Payment Reminders:

Instore

It is possible to connect a card terminal to the Lightspeed POS for transaction processing only. See this Lightspeed page for instructions. The instore transactions will be started from the POS, not the Pay. API. These transactions will be visible in Reports / Management and Reports / Paid transactions when we have received the monies.
Transactions can be paid out the day after, depending on your pay out (clearing) frequency.

Business Orders

Certain payment methods, like Biller, can only be used with B2B orders. We recommend enabling the following settings if you are processing B2B orders:

  1. Go to Apps > Purchased Apps > click on Pay. > Go To App
  2. Set Auto-capture to Yes
  3. Go to your B2B payment method and set Customer Type to Business
  4. Go back to Checkout > Configuration > Additional customer fields > Edit
  5. Configure these settings. For B2B orders a Company name or COC numberis generally Required.

Error Message Definitions

Error CodeDescriptionPossible solution
PAY-LIGHTSPEED-101We can't find your shop.Please contact Pay.
PAY-LIGHTSPEED-102App can't connect to Lightspeed.Check your connection.
PAY-LIGHTSPEED-103Entered credentials are incorrect.Check your API-Token and Service-Id (SL-XXXX-XXXX).
PAY-LIGHTSPEED-104We can't find your shop.Please contact Pay.

Translations

Translations are managed via 2 settings:

  1. Translations based on:
  2. Checkout country: country as selected in the checkout
  3. Webshop language: language the customer is viewing the shop in
  4. Language of payment screen:
  5. Order language: based on delivery address country
  6. Webshop language: language the customer is viewing the shop in

Payment method settings

It is possible to change a few settings via Apps > Purchased Apps > click on Pay. > Go To App

  • Description: name as shown in checkout
  • Limits: optional. Set the minimum and/or maximum amount to show this payment method. When both are 0 the method will always be displayed.
  • Fees: optionally set the payment costs for a payment method. Choose a fixed amount or a percentage.
  • Countries: select in which country the payment method should be available. No selection means available in every country.
  • Customer Type: select for which customer type the payment method should be available.

Sorting your payment methods in checkout

To change the order in which the payment methods are shown in checkout:

  1. Go to Apps > Purchased Apps > click on Pay. > Go To App
  2. Drag & drop the payment methods as you wish