WooCommerce

Summary

WooCommerce is a customizable, open-source eCommerce platform built on WordPress. It makes creating and managing an online store simple, with reasonable levels of flexibility and several vital features such as inventory and tax management, secure payments and shipping integration.

It’s a free plugin. It lets you turn a WordPress website into an ecommerce store. WooCommerce is fully compatible with the functions on your WordPress site. It allows you to add products, a shopping cart, and checkout options.

WooCommerce also offers many helpful features, like order tracking, customer engagement, delivery status updates, inventory management, and more. With over 27 million downloads to date, WooCommerce powers 99% of all WordPress stores. WooCommerce has a low degree of difficulty. It’s easy to use for beginner site owners.

Prerequisites

WooCommerce VersionMinimum WordPress VersionMinimum PHP Version
7.96.2.2PHP 8.0 +

Installation

Please download the latest version of the WooCommerce plug-in; it can be downloaded here:

https://github.com/network-international/ngenius-woocommerce-plugin/

  1. Login to WooCommerce Admin Panel and navigate to Plugins-> Add New-> Add Plugins
  2. Click on Upload Plugin and select the correct package file to upload

  1. Click on “Install” button, as above. Once the installation is completed, click on ‘’Activate Plugin”

  1. After successful installation and activation of the plugin, click on Settings to enable and configure the plugin.

Configuration

To correctly configure the plugin, please add the N-Genius payment details.

Go to Plugin ->Installed Plugins-> N- Genius Online Payment Gateway ->Settings Tab -> Configure N-Genius Online payment details and enter the following details:

  • 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 Partner
  • Currency & Outlet ID: It should match the environment selected.
  • Outlet 2 Currencies (Optional) – For merchants who have signed up for more than one currency. Limited to 3 currencies.
  • Outlet 2 Reference ID (Optional) – The Outlet ID for additional currencies
  • Hosted Payment Page API Key: It should match the environment selected.
  • Debug Log: log file will be created.

Customer Shopping and Payment Page Redirection

When the customer is doing online shopping on the merchant 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 WordPress WooCommerce Shop website and add some items to the cart. Click on Proceed to Checkout Button and follow the steps in the Checkout process.

  1. You will notice that N-Genius Online Payment Gateway is available as a payment option. Click on the same to place order Button. Click Place Order to be redirected to the Payment Page.

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

  1. Once the payment is processed, your browser will be redirected back to the WooCommerce Shop website.

  1. To view the test order you just placed, go to WooCommerce -> Orders

  • 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 Capture the transaction if the transaction type was Authorize
  • When viewing the order, you will be able to Refund the transaction after 24 hours if the transaction type was Sale or Purchase. The same applies when capturing the transaction.
  1. To Void an order, navigate to WooCommerce > Orders and select the Order you’d like to Void. Once in the Order view, there will be an N-Genius box on the right side of the page. Click Void. The status of the order will change to N-Genius Auth Reversed.

  1. To Capture an Order, Go to WooCommerce > Orders and select the Order you’d like to Capture. Once in the Order view, there will be an N-Genius box on the right side of the page. Click Capture. The status of the order will change to N-Genius Captured.

  1. To Refund an Order, Go to WooCommerce > Orders and select the Order you’d like to Refund. Once in the Order view, there will be a Refund button in the Product Box. Click Refund. You will now be able to edit the orders cost and quantity before Refunding the customer. Enter the desired Amount/Quantity and Click Refund via N-Genius. A Pop-up window will appear asking you to confirm. Click Ok. The status of the order will change to N-Genius Partially Refunded. If you’ve processed a Partial refund, you can repeat the same process to refund the remaining amount.

GitHub Notifications

To receive notifications when any Network International plugin versioning or new plugin has been released, you will need to follow the below steps:

  1. Create an account on GitHub here
  2. Once your account is created, click on this link which will take you directly to the Network International repository.
  3. Click follow. You will start receiving updates when new/updated plugins have been released

  1. Once in the network-international repository, scroll down or search for the plugin that you would like to be notified on.
  2. Once the plugin is found, go into the repository, and click Watch. You will now receive all notifications for the plugin.

  1. You can also use Custom notification settings by clicking on the down arrow if you would like to be notified of certain events

Troubleshooting

  1. If you receive the below error, please check if the correct environment is selected and that the API Key is correct

Error! Bad token request.

  1. If you receive the below error, Outlet ID is incorrect. Please confirm that you’ve inserted the Outlet ID

Failed! Access Denied

  1. If you receive the below error, this means that the currency added in WooCommerce does not match the currency that’s loaded for the Outlet ID for N-Genius. Please confirm the correct currency

`Failed! No payment method available for currency

  1. If you receive the below error, this means the API Key is incorrect or has an incorrect character

Error! Invalid configuration.