This document presents the steps for integrating the Geidea payment gateway with your OpenCart store.

Overview

OpenCart is an online store management system. It is PHP-based, using a MySQL database and HTML components. It is designed for small to large online merchants to set up e-commerce sites seamlessly and quickly. Geidea Payments Online is a gateway plugin that extends OpenCart, allowing you to accept payments through Geidea. You can easily accept credit card payments and other payments through wallet providers or Buy-Now-Pay-Later (BNPL) providers.

Integrating our payment gateway with OpenCart's online stores has never been easier. Through the Geidea Online Payments plugin in our GitHub repository, our payment gateway can be seamlessly integrated with just a few lines of code.

Pre-requisites

You will need a merchant account with Geidea and the following software running in your hosting environment to accept payments using the Geidea payment gateway.

SoftwareVersion
OpenCart4.0.2 or greater
Geidea Online Payments plugin4.0.0
PHP8.2.0 or greater

❗️

While we make every effort to test software or module or plugin updates rigorously, there is no guarantee that a plugin or module would work seamlessly with your hosting environment. So please back up your website before updating any plugins or modules. This helps you restore your website from backup in case you run into unexpected errors.

Software and plugin or module updates involve programming code changes. The updates may often request upgrades to the server or other hosting software such as PHP as well.

Integration Steps

Step 1 - Installing the plugin

  1. Download the Geidea Online Payments for OpenCart from here.
  2. Log in to your administrator account of your OpenCart store.

  1. Navigate to the extension installation menu Extensions > Installer.
  2. Click on the upload icon to upload the plugin. Browse the plugin on your local machine and select the plugin.

📘

Note

The plugin must be uploaded as a “.zip” file format to be accepted by the plugin installer.

  1. The plugin is automatically installed.

Step 2 - Configuring the plugin

  1. Navigate to the extensions menu and select the installed Geidea Online Payments plugin through the following path

Left Sidebar > Extensions > Extensions

  1. Select Payment Extensions from the dropdown values of Choose the extension type option

  1. Scroll down to the Geidea Online Payments plugin and click on the Edit icon.

  1. Configure your Geidea Online Payments plugin with the merchant credentials you have received from the Geidea team.

Setting optionMandatory/OptionalDescriptionComments
StatusMandatoryChecking this option enables you to Enable or Disable the Geidea Online Payments plugin. If you want to accept payments using Geidea, you must select this option.Dropdown
Geidea Public keyMandatoryYour Merchant Account ID (Merchant Public Key) that you should have received after creating an account with Geidea. Please refer to this link for details.Sample: 1a2b3456-cb3b-11ed-afa1-0242ac120002
Geidea API Secret KeyMandatoryYour Merchant account password (API Password) that you should have received after creating an account with Geidea. Please refer to this link for details.Sample: 9z87y65x-cb3b-11ed-afa1-0242ac120002
HPP StyleOptionalHosted Payment Page Style
Used to set the experience for the payment widget. It has 2 values - Simple, Compressed
Dropdown
Header ColorOptionalHexadecimal code of the colour that is displayed at the top of the payment widget# 333FFF
Partner IdOptionalId of the Partner on Geidea's systemspq12r345-cb3b-11ed-afa1-0242ac120002
Receipt EnabledOptionalUsed to select whether a summary of the payment transaction must be displayed after the transaction is completeDropdown
Email EnabledOptionalDisplays the option to edit the email of the customer in the payment widgetDropdown
Phone Number EnabledOptionalDisplays the option to edit the phone number of the customer in the payment widgetDropdown
Address EnabledOptionalDisplays the option to edit the shipping and billing addresses of the customer in the payment widgetDropdown
Checkout logoOptionalThe icon displayed at the time of placing the order during the checkout process
  1. Click on the Save icon at the top right corner of the web page.

  1. After following these steps, the Geidea Online Payments plugin should be configured successfully.

You can now test the gateway by completing a test checkout process.

Geidea Checkout

1294

Geidea Hosted Payment Page