Documentation
Documentation
Lightspeed eCom

1Connecting with Lightspeed eCom

To use the Lightspeed eCom integration please proceed as follows:

  1. Select the app from the Lightspeed eCom marketplace.

  2. Click on the install button. You will now be redirected to your Lightspeed eCom store to login and grant us access.

  3. After you have granted the permissions, you will be requested to authenticate. If you don’t have an account yet, please use the signup button to create one.

  4. When the installation of the app is successful, you should see the Lightspeed eCom integration with the options you can use.

  5. Invoice settings can be found in your Lightspeed eCom store back office. The invoice creation method should be set to Paid or Direct. If the Manual create method is set, the order state will not be updated automatically.

Lightspeed eCom Store Back Office - Invoice Settings
Figure 1. The invoice creation method setting in Lightspeed eCom store.

This is all that is necessary. The payment method’s name, description, etc. are now synchronized automatically to Lightspeed eCom. Make sure that you have selected your payment processor.

2Transaction Maintenance

Please note that it is not possible to capture and refund payments from the Lightspeed eCom admin area. All maintenance operations for refunds and captures have to be done within your Wallee Group AG account.

3Order Status Handling

The order status is automatically updated by Lightspeed eCom according to the payment status of the order. The payment status is set to pending once the user is redirected to Wallee Group AG. When the transaction reaches the FULFILL state the payment status of the order is set to PAID. Depending on the product the order is marked as ready to be shipped or as ready to be downloaded. When the transaction is marked as DECLINED or when the transaction is marked as VOIDED the order status is set to cancelled. This is required to prevent the buyer from getting again into the payment process in these cases through their account within Lightspeed eCom.

3.1State Graph

The diagram below shows the state machine of Lightspeed eCom orders, including additional information for the state transitions.

Lightspeed eCom orders - State transitions
Figure 1. State transitions for Lightspeed eCom orders.

4Payment Method Adjustments

Lightspeed eCom updates the displayed payment methods directly from Wallee Group AG. This means any payment method configured is automatically available in Lightspeed eCom. The names of the payment methods and their icons can be configured in the payment method configuration.

Lightspeed eCom is not updating the payment methods on each reload of the payment method selection page. As such you might need to restart the checkout process to see the updates.

5Payment Method Fees

Each payment method allows to have an additional payment fee (payment cost). The calculation of the fee depends on the total amount with a percentage of it or the fee can be a fixed amount. There must be at least one payment method configured otherwise no fee can be assigned to it.

Lightspeed eCom Store - Payment method fee
Figure 2. The payment method fee on the Lightspeed eCom checkout page.
Important
 Payment Method Fees: Lightspeed Ecom allows setting fees for payment methods. In the Upgraded Checkout, these fees currently apply solely to regular products and shipping, excluding gift cards. Unlike Legacy Checkout, those fees applied to all products.
Warning
 Gift Card Cancellations: If a customer attempts to pay with a gift card but cancels the checkout process, Lightspeed Ecom will still mark the gift card as redeemed. Lightspeed is aware of this limitation and is working on a fix.

6Gift Cards

Gift cards are such a popular and practical solution—they’re a step more personal than cash, so they make gift-buying easy.

You can capitalize on the popularity of gift cards by making it easy for your customers buy and redeem them from your business—both in store and online. Where you decide to sell gift cards and allow customers to redeem them is entirely up to you.

Get started by configuring your gift card settings in Lightspeed eCom store.

Lightspeed eCom Store - Purchased gift card line item
Figure 3. The purchased gift card on the Transaction Line Items.
Lightspeed eCom Store - Applied gift card line item
Figure 4. The applied gift card code on the Transaction Line Items.

6.1Refund a gift card (in Lightspeed eCom)

Currently, refunding a customer for a gift card they purchased is not supported in Lightspeed eCom store.

However, it is possible to refund your customer in Lightspeed eCom by:

  1. Canceling the gift card

  2. Creating a unique discount code

See more: Refunding gift cards purchased online in Lightspeed eCom

6.2Refund a gift card (in Wallee Group AG)

You have the possibility to refund already completed transactions, from the Wallee Group AG. In order to do so, open the completed transaction. By clicking on Refunds the window for refunds will show.

Note
 Ensure that the connector which processed this payment supports the refund feature. In order to check that have a look at the processor list and check the connector of a processor.

You can carry out as many individual refunds as you wish until you have reached the quantity of the original order.