Magento v2

If you are already using Magento v2.x with your online store, Limepay can be added quickly and easily.


  1. Download the Limepay extension for Magento v2 .
  2. Extract the downloaded zip file to your desired location using a file extractor.
  3. Find and open the Magento root directory which can be found in your Magento installation files location.
  4. If there is already an app folder in the root directory, use the merge function to add the new files. If there is no app folder in the root directory, move the extracted app folder into the root directory. Confirm the appropriate files are now in the app folder.
  5. Depending on your version of Magento v2, run the following command lines to complete the installation:
Magento version 2.1.8 or older Magento version 2.1.9 or later
php bin/magento setup:upgrade php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy php bin/magento setup:static-content:deploy -f
  1. Ensure all Magento system permissions are applied. Use the Magento folders and permission reference if needed.

Magento v2 setup

With the Limepay extension installed, you are just a few steps away from activating it on your store page.

First log in to your Magento Admin Panel and go to Store > Configuration > Sales > Payment Methods. Click to expand Limepay.


  1. Enabled: Enable Limepay
  2. Multiple Payment Methods: When set to Yes, checkout will display Full and Split payment options as separate payment methods.
  3. Available Payment Options: Select your preferred payment options to be available in checkout.
  4. Limepay Publishable Key: Limepay publishable API key.
  5. Limepay Secret Key: Limepay secret API key.
  6. Request 3DS for Payments: When enabled, Limepay will be requested to perform 3DS challenge for payments.
  7. Minimum Amount for 3DS: [Optional] When an amount is set, 3DS challenge will not be requested for payments below the given amount. Leave empty if you intend to request 3DS challenge for all payments.
  8. New Order Status: Select your preferred order status.
  9. Primary Color: [Optional] Primary color of the checkout. Enter the hex code of the color.
  10. Default Payment Method: Set Limepay as default payment method.
  11. Title: Set the title as you prefer.
  12. Title Settings: Select whether you want to show card images with Title.
  13. Sort Order: Set this to 1 so Limepay will appear on top of the payment methods list in checkout.
  14. Instructions: [Optional] Instructions to appear in checkout.
  15. Allow Wallet payments to place the order: When set to Yes, Limepay will submit orders immediately when a digital wallet payment such as Apple Pay or Google Pay is selected.

Clear your cache by running the following command line: php bin/magento cache:clean Return to and refresh your store page to see your new Limepay checkout.

Enable ApplePay and GooglePay

To enable ApplePay and GooglePay, please follow the instructions available in your Limepay Merchant Dashboard's Settings -> Checkout payment options section.

What's next?

Visit the testing documentation page to confirm the integration is fully functional.

Learn about and access the Limepay merchant dashboard.

Return to documentation home.

Copyright © April Solutions 2023. All right reserved.