Skip to content
This repository has been archived by the owner on Oct 10, 2024. It is now read-only.

Lunar Online Payments for Opencart 3.x

License

Notifications You must be signed in to change notification settings

lunar/payments-plugin-opencart-3

Repository files navigation

Lunar Online Payments for Opencart 3.x

Released under the MIT license: https://opensource.org/licenses/MIT

You can also find information about the plugin here: https://lunar.app

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

Installation

*NOTE: It requires PHP version >=7.4

Once you have installed OpenCart, follow these simple steps:

  1. Signup at lunar.app (it’s free)
  2. Create an account
  3. Create an app key for your OpenCart website
  4. Upload the lunar.ocmod.zip file from the Github release in the extensions uploader.
  5. Log in as administrator and click "Extensions" from the top menu then "extension" then "payments" and install the Lunar plugin by clicking the Install link listed there.
  6. Click the Edit Lunar button
  7. Select a store for your configuration
  8. Add the Public and App key that you can find in your Lunar account and enable the plugin
  9. Save the settings

Updating settings

Under the extension settings, you can:

  • Choose the OpenCart store to make settings for
  • Update the payment method text in the payment gateways list
  • 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 type (Instant/Delayed)
  • Change the order statuses that the orders will get after a certain payment action is done (authorization/capture/refund/cancel)

How to capture / manage transactions

In Delayed mode you can make transactions (full capture, refund, cancel) from admin panel, for each order info page, adding a history to the order. The Order Status that is wanted to be set for specific transaction must be identical with that set in Lunar extension page (Advanced section/tab). By default it is Completed for capture, Refunded for refund and Voided for cancel an order.

  1. Capture

    • In Instant mode, the orders are captured automatically
    • In Delayed mode you can do this in admin panel, order info page, adding Completed order status history to the order.
  2. Refund

    • In Delayed mode you can do this in admin panel, order info page, adding Refunded order status history to the order.
  3. Cancel

    • In Delayed mode you can do this in admin panel, order info page, adding Voided order status history to the order.

Available features

Multistore support

  • The Lunar multi-store functionality allows the merchant to have different sets of keys for each store.
  • You need to have a separate merchant account for a single store to keep Lunar transactions for each store independently.

Transactions

  1. Capture
    • Opencart admin panel: full capture
    • Lunar admin panel: full/partial capture
  2. Refund
    • Opencart admin panel: full refund
    • Lunar admin panel: full/partial refund
  3. Cancel
    • Opencart admin panel: full cancel
    • Lunar admin panel: full/partial cancel

Changelog

2.0.0:

  • Changed flow to hosted checkout + Added MobilePay payment method

1.0.0:

  • Initial version