lunar/lunar-magento

This package is abandoned and no longer maintained. No replacement package was suggested.

Lunar Online Payments for Magento 2

2.2.0 2024-03-07 20:20 UTC

Requires

• lunar/payments-api-sdk: ^1.0
• magento/module-checkout: >100.0.0
• magento/module-payment: >100.0.0
• magento/module-sales: >100.0.0
• paylike/php-api: ^2.0

GPL-3.0-or-later

README

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement.

Supported Magento versions

The plugin has been tested with most versions of Magento at every iteration. We recommend using the latest version of Magento, but if that is not possible for some reason, test the plugin with your Magento version and it would probably function properly.

Automatic installation

Once you have installed Magento, follow these simple steps:

1. Signup at lunar.app (it’s free);
2. Create an account;
3. Create an app key for your Magento website;
4. Purchase the extension archive from the Magento Marketplace;
5. Upload the files trough the Extension Manager;
6. Activate the module using the Extension Manager;
7. The module should now be auto installed and visible under "Stores >> Configuration >> Sales >> Payment Methods", the module will be listed here inside the "OTHER PAYMENT METHODS" list;
8. Insert the app key and your public key in the Payment module settings for the Lunar plugin.

Manual installation (mode 1)

Once you have installed Magento, follow these simple steps:

1. Signup at lunar.app (it’s free);
2. Create an account;
3. Create an app key for your Magento website;
4. Purchase and download the extension archive from the Magento Marketplace;
5. Login to your Magento 2.x Hosting site (for details contact your hosting provider);
6. Open some kind File Manager for listing Hosting files and directories and locate the Magento root directory where Magento 2.x is installed (also can be FTP or Filemanager in CPanel for example);
7. Unzip the file in a temporary directory;
8. Upload the content of the unzipped extension without the original folder (only content of unzipped folder) into the Magneto “<MAGENTO_ROOT_FOLDER>/app/code/Lunar/Payment/” folder (create empty folders "code/Lunar/Payment/");
9. Login to your Magento 2.x Hosting site using SSH connection (for details contact our hosting provider);
10. Run the following commands from the Magento root directory: * php bin/magento setup:upgrade * composer require paylike/php-api ^1.0.8 * php bin/magento cache:clean
11. Open the Magento 2.x Admin panel;
12. The module should now be auto installed and visible under "Stores >> Configuration >> Sales >> Payment Methods", the module will be listed here inside the "OTHER PAYMENT METHODS" list;
13. Insert the app key and your public key in the Payment module settings for the Lunar plugin.

Manual installation (mode 2) (more details here devdocs.magento.com)

Once you have installed Magento, follow these simple steps:

1. Signup at lunar.app (it’s free);
2. Create an account;
3. Create an app key for your Magento website;
4. Purchase the extension from the Magento Marketplace;
5. Login to your Magento 2.x Hosting site using SSH connection (for details contact your hosting provider);
6. Run the following commands from the Magento root directory (more info in the official documentation):
   • composer require lunar/lunar-magento (this will also install paylike/php-api ^1.0.8` package specified in composer.json file in this module)
   • php bin/magento module:enable Lunar_Payment --clear-static-content # this step can be skipped
   • php bin/magento setup:upgrade
   • php bin/magento setup:di:compile
   • php bin/magento cache:clean
7. Open the Magento 2.x Admin panel;
8. The module should now be auto installed and visible under "Stores >> Configuration >> Sales >> Payment Methods", the module will be listed here inside the "OTHER PAYMENT METHODS" list;
9. Insert the app key and your public key in the Payment module settings for the Lunar plugin.

Updating settings

Under the Magento Lunar payment method settings, you can:

• Enable/disable the module
• Update the payment method title in the payment gateways list
• Change the credit card logos displayed in the description
• Update the payment method description in the payment gateways list
• Update the title that shows up in the payment popup
• Add public & app keys
• Change the capture mode (Instant/Delayed by changing the order status)
• Enable sending invoices by email
• Change new order status
• Enable payment logs

Upgrading module

• To update or upgrade the module run following commands:

  • composer update lunar/lunar-magento (upgrade to latest version)
    or (for eg.)
  • composer require lunar/lunar-magento:^5.3.0 (upgrade to version 5.3.0)

• After that, run the following commands:

  • php bin/magento setup:upgrade --keep-generated
  • php bin/magento setup:static-content:deploy
  • php bin/magento cache:clean

How to

1. Capture
   • In Instant mode, the orders are captured automatically
   • In delayed mode you can capture an order by creating an invoice with Capture Online Amount status (at the bottom)
2. Refund
   • To refund an order you can use the Credit memo on the invoice.
3. Void
   • To void an order you can use the Void action if the order hasn't been captured. If it has, only refund is available.

Available features

1. Capture

   • Magento admin panel: full capture
   • Lunar admin panel: full/partial capture

2. Refund

   • Magento admin panel: full refund
   • Lunar admin panel: full/partial refund

3. Void

   • Magento admin panel: full void
   • Lunar admin panel: full/partial void

4. Multishipping support - a customer can place orders on multiple shipping addresses

5. Cron - check for unpaid orders - when a customer places an order, he pays for it, but does not return to the website (only for hosted checkout methods). - The schedule interval to be inserted into DB can be set from the admin panel: <admin_url>/admin/system_config/edit/section/system/