1. Sign in to the app.
2. Tap the hamburger menu and go to Environment.
3. Edit your API key and/or the Environment.

To change the order in which payment methods appear on your checkout page, follow these steps:

1. Go to Settings > Payment method settings.
2. Drag and drop the payment methods to the preferred order.
3. Click Save.

How to set the payment method order per language

To set the payment method order for different languages, under the Payment method settings select a country / store language and set the order per language.

If no specific rule is set for a country, the Default order is used.

When changing internationalization in your Lightspeed eCom backend, do not change the primary language setting while installing the app.

Lightspeed eCom requires a language, an API key, and a cluster to validate API requests.

If you remove the language used during installation instead of deactivating it, the app cannot communicate with Lightspeed eCom services.

To view your shop ID, follow these steps:

1. Sign in to the /admin area of your Lightspeed app.
2. Click Help in the bottom-left corner.
3. A popup appears containing your shop ID (also known as the store ID).

Per payment method

To set a maximum/minimum order amount for a payment method to display on your checkout page, follow these steps:

1. In the Payment methods ordering list, click the + button to open the relevant payment method.
2. Enter an amount in EUR cents in the:
   • Maximum field, e.g. A maximum value of 1500 cents means the payment method only appears on the checkout page if the total order amount is less then 15 EUR. If you don't want a maximum amount, enter -1.
     OR
   • Minimum field, e.g. A minimum value of 1500 cents means the payment method only appears on the checkout page if the total order amount is more then 15 EUR.

Per language

To set different maximum/minimum order amounts for different languages, under the Payment methods ordering header > Country list, select a country and set the maximum/minimum amount per language.

If no specific rule is set for a language, Default language is used.

1. Sign in to your Lightspeed app.
2. Go to Apps > Purchased apps > MultiSafepay payments.
3. Click Go to app.
4. In the Setup page:

• Enter your email address, account ID and site API key.
• Select Test or Live environment, and then click Save and continue.
  You are redirected to the Settings page.

5. On the Payment method settings tab:

• Select the relevant Payment method settings.
• To expand the payment method, click on the tab.
• On the Enable MultiSafepay Components and select the Enabled checkbox.

6. On the Enable MultiSafepay checkout scripts tab, select the Enabled script checkbox.
7. Click Save.

• Cards: All
• Banking methods: All, except iDEAL QR and TrustPay
• BNPL: All
• Wallets: All
• Prepaid cards:
  • Baby gift card
  • Beauty and Wellness gift card
  • Bloemencadeaukaart
  • Boekenbon
  • Degrotespeelgoedwinkel
  • Edenred
  • Fashion Cheque
  • Fashion gift card
  • Fietsenbon
  • Gezondheidsbon
  • Goodcard
  • Nationale bioscoopbon
  • Nationale tuinbon
  • Parfumcadeaukaart
  • Sport en Fit
  • VVV gift card
  • Webshop gift card
  • Wijncadeau
  • Winkelcheque
  • Yourgift

To use MultiSafepay payment method icons, see GitHub MultiSafepay icons .

By default, the app does not support adding payment methods logos to your site footer. We provide a script for this, or you can ask your developer to add the logos to your theme. Themes can differ and you may need to make some changes for it to function.

How to add logos via our script

1. Sign in to your Lightspeed app.
2. Go to Apps > Purchased apps > MultiSafepay payments.
3. Click Go to app.
4. In the Setup page:

• Enter your email address, account ID and site API key.
• Select Test or Live environment, and then click Save and continue.
  You are redirected to the Settings page.

5. On the Storefront payment icons tab, click Copy to clipboard.
6. In your Lightspeed admin area, go to Settings > Web extras and custom Javascript.
7. Paste the script into the Javascript textbox, and set the status to Enable.
8. Click Save.
   The logos appear in the footer.

Display order

Depending on the storefront, the display order of the logos is determined by the settings at the time of generation. If you update these settings, you must update the script as well.

Size

By default the logos are 16 px high. In most themes, footer logos are found in the "div.payment-methods p". If needed, you can change the selector based on the theme.

How to resize logos

1. In the JavaScript for displaying the logos, locate the following img element near the end of the script:

   <img src="${msplt[e]}" alt="${e}" />
   

2. Specify the height and width in pixels as required, e.g.:

   <img height="16" width="37" src="${msplt[e]}" alt="${e}" />
   

How to add missing logos

Logos may be missing due to your site theme settings.

To add missing payment method logos, follow these steps:

1. Download the logos from our Github repo .
2. Rename the file with upper case formatting, e.g applepay.png > APPLEPAY.png.
3. Sign in to your Lightspeed app.
4. Go to Design > Theme editor > Advanced > Edit code > Assets, and drop in the logos.

The logos won't appear instantly. It takes a little time.

JavaScript

For the best user experience, we provide some Javascript and images, e.g. to add a dropdown for iDEAL and MultiSafepay icons for other payment methods.

Some user-added themes or scripts may cause issues, e.g. missing images for payment methods.

For assistance, ask your developer.

All payment methods still work if you don't use the Javascript files.

To change the order in which payment methods appear on your checkout page, follow these steps:

1. Go to Settings > Payment method settings.
2. Drag and drop the payment methods to the preferred order.
3. Click Save.

Setting payment method order per language

To set the payment method order for different languages, under the Payment method settings select a country / store language and set the order per language.

If no specific rule is set for a country, the Default order is used.

You can enable and disable payment methods in the Payment method settings list. The dot next to the payment methods is green when enabled, and grey when disabled.

To disable payment methods for specific languages, follow these steps:

1. Sign in to your Lightspeed app.
2. Select the relevant storefont.
3. For each language, disable the relevant payment methods.

If no specific language rule-set is found, Default is used.

Missing payment methods

By default, newly activated payment methods for your MultiSafepay account are disabled in the Lightspeed app's MultiSafepay payments settings. You need to enable them in both environments.

If a payment method is missing:

1. Sign in to your MultiSafepay dashboard .
2. Go to Settings > Payment methods, and check that the payment method is enabled.
3. Sign in to your Lightspeed app, go to Settings, and then enable the payment method again.

After terminating your contract with MultiSafepay, our payment methods may still be visible in your checkout.

1. Sign in to your Lightspeed app.
2. Go to Apps > Purchased apps > MultiSafepay payments.
3. Click Go to app.
4. Sign in to the MultiSafepay app.
5. Click Disable all payment methods.

1. Sign in to your Lightspeed app.
2. Go to Apps > Purchased apps > MultiSafepay payments.
3. Click Go to app.
4. In the Setup page:

• Enter your email address, account ID and site API key.
• Select Test or Live environment, and then click Save and continue.
  You are redirected to the Settings page.

3. On the Allow refunds tab, select the Refunds enabled checkbox.
4. Select the relevant setting:
   • Refunds disabled (default)
   • Refunds enabled:
     • Create a refund when the credit memo status is Unpaid (default when refunds are enabled).
     • Always create a refund, no matter the credit memo status.

Notes

• If you use Lightspeed eCom linked to Lightspeed Retail to process refunds via MultiSafepay, you must enable the Always create a refund, no matter the status setting.

• When creating a credit memo, set the status to Not paid. If the Always create a refund, no matter the status setting is not enabled, MultiSafepay ignores Paid status.

• For refunds created in your Lightspeed backend, a short message appears in the Notes section of the order where any errors are explained.
• Refunds created in your MultiSafepay dashboard are not reported back to Lightspeed. Under Notification history, an error appears: "Already a completed transaction".
• Some BNPL orders:
  • Require product IDs for each refunded item. When using product variants, make sure each variant has a unique identifier. If you provide duplicate IDs, we cannot distinguish which items to refund.
  • Do not let you refund a partial amount and a full item in a single request, e.g. a shopping cart contains 3 items for a total of 1.70 EUR. If you refund 1 item and 0.40 EUR, it fails. Make sure you refund items and amounts separately.
• You cannot issue multiple refunds for the same amount within 5 minutes of each other, even for different items.

1. Sign in to the Admin section of your Lightspeed store.
2. In the sidebar, click Apps.
3. Click Purchased apps.
4. In the sidebar, click Apps.
5. Click MultiSafepay Payments, or to take you straight to the store page, paste /admin/store/apps/1517 after the base URL of your store.
6. On the store page, click Go to app / Ga naar app.

1. Sign in to your Lightspeed app.
2. Go to App > Purchased app > MultiSafepay app.
3. Select the payment method you want to apply a surcharge to.
4. Enter the surcharge amount as a:
   • Fixed amount under Flat payment fee, or
   • Percentage under Dynamic payment fee.
5. Click Save.

⚠️

Attention Dutch merchants

We strongly recommend not applying surcharges to BNPL orders. This is now considered providing credit under the Wet op het consumentenkrediet and article 7:57 of the Burgerlijk Wetboek, and requires a permit from the Authority for Financial Markets (AFM).

1. In the Lightspeed app manual, follow the steps to install the app.
2. Place a test order to make sure it's working properly.
3. Open the core integration, and then disable the payment provider.

To access the MultiSafepay Payments app Settings page:

• You are automatically redirected after installing the app, or
• Select the MultiSafepay Payments app, and then click Go to app.

1. Sign in to your Lightspeed backend.
2. Go to Settings > Payment providers > MultiSafepay.
3. At the top of the screen, click Disable this payment provider.