664

OpenCart is an easy to-use yet powerful open-source online store management program that can manage multiple virtual shops from a single back-end – it can be downloaded and updated free of cost, and with no monthly fees.

It offers users built-in SEO and efficient management of customers, products, coupon codes, tax rules, orders, and more.

You can learn more about OpenCart here.

Prerequisites

OpenCart needs the following server configuration to run:

  • Web Server (Apache suggested)
  • PHP 5.4+
  • Database (MySQLi suggested)

Required PHP libraries / modules:

  • Curl
  • ZIP
  • Zlib
  • GD Library
  • Mcrypt
  • Mbstrings
  • Xml

More on system requirements can be found here

Download

The latest version of the plugin can be downloaded here

Installation

  1. Login to OpenCart Admin Panel
  2. Navigate to Extensions. Under Extensions, click on Installer and then click on the Upload button
624
  1. Select the OpenCart ZIP file. Once selected, the plugin will be installed and a success message will be displayed.
624 624

Configuration

  1. Click on Extensions and select Payments from the drop-down menu
624
  1. Scroll down to the N-Genius Payment Gateway plug-in entry and click on the configure button (this will look like a pencil icon).
624
  • Status: Enable/Disable plugin
  • Title: Text to display in the front-end
  • Environment: Sandbox/Live
  • Payment Action: Authorize/Sale/Purchase
  • Sandbox/Live API URL – Default URLs pre-loaded. For Partners - Enter URLs provided by the Bank
  • Outlet Reference ID: Provided by NI/Partner. Currency & ID should match the environment selected
  • Add Additional Outlet Reference ID’s: Additional Currencies can be configured if provided by NI/Bank
  • Hosted Payment Page API Key: API Key should match the environment selected.
  • Debug: Yes/No. Log file will be created if yes is selected

Customer Shopping and Payment Page Redirection

When the customer is doing online shopping on the merchant’s website, the “N-Genius Online” Payment Gateway will now be available as a payment option on the “Checkout” Page.

To check this, please follow these steps...

  1. Open the OpenCart Website and add some items to the cart. Click on the Checkout button and follow the steps in the Checkout process
624
  1. Continue with the checkout process. You will notice that N-Genius Online Payment Gateway is available as a payment option. Select the Payment Option and accept T’s & C’s and then click Continue & confirm the order to be redirected to the Payment Page.
624

The page will then be redirected to the “N-Genius Payment Page”. Fill in the card details. After submitting the details, the page will be redirected to a 3D Secure page.

472 477
  1. Once the payment is processed, your browser will be redirected back to the OpenCart Website.
624
  1. To view the test order you just placed, go to the OpenCart Admin Panel, then click Sales and select Orders
624 624
  • When viewing the order, you will be able to Void the transaction if the transaction type was Authorize
  • When viewing the order, you will be able to Fully Capture the transaction if the transaction type is Authorize
  • When viewing the order, you will be able to Refund the transaction after 24 hours if the transaction type was Sale or Purchase.
  1. To Refund an Order, Go to Sales > Orders and then click View on the order you’d like to Refund. Once the order is displayed, scroll down to Order History and click on N-Genius Online Payment Gateway. Enter the amount you’d like to refund and click the Refund button. The status of the order will change to Fully Refunded. If you’d like to process a partial refund, you can enter the amount you would like to refund and then click the Refund button. Please note that the status of the order needs to be N-Genius Complete in order to process a refund.
624
  1. To Void or Capture an Order, Go to Sales > Orders and then click View on the order you’d like to void (authorization reversal) or capture. Once the order is displayed, scroll down to Order History and click on N-Genius Online Payment Gateway. Click Void. A pop-up box will be displayed to confirm the void. Click OK. The transaction will now be reversed. Please note that you can only void a transaction if the transaction has a transaction status ‘N-Genius Authorized’.

To capture a transaction, click Capture. A pop-up box will be displayed to confirm the capture. The transaction status will change to N-Genius Complete. Please note that you can only capture a transaction if the transaction has a transaction status ‘N-Genius Authorized

624 288 288

Troubleshooting

  1. If you receive the below error, please check if you have the correct API URL loaded
418
  1. If you receive the below error, please check if you have the correct Environment, API Key or Outlet ID loaded
258
  1. If you receive the below error, the currency is not linked/loaded to the Outlet ID
473
  1. If you receive the below error, the plugin hasn’t been configured. Please check that all fields are configured
353