PrestaShop

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

Overview

PrestaShop is a freemium, open-source e-commerce platform. It is designed for small to large online merchants to set up their e-commerce sites seamlessly. Geidea Payments Online is a gateway module that allows you to accept payments through Geidea. You can easily accept credit cards and other payments through mobile wallet providers or Buy-Now-Pay-Later (BNPL) providers.

Integrating our payment gateway with PrestaShop's online stores has never been easier. Through the PrestaShop module, 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
PrestaShop8.0.2 or greater
Geidea Online Payments module3.2.0
PHP7.4 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

After you successfully set up your PrestaShop store, follow the following steps

Step 1: Obtaining the module

Clone the plugin from the GitHub folder (link). Zip the folder and rename it as geideapay.zip

Step 2: Installing the module (Fresh install)

  1. Log in to your PrestaShop admin account.

  1. To test the module before enabling it for your customers, you can use the Demo mode in the PrestaShop framework. You can activate the Demo mode by toggling the Demo mode button in the admin dashboard

  1. Click on Modules > Module Manager

  1. Click on Upload a module and navigate to the downloaded module.

  1. Once you upload or drag the file, the module automatically installs and will be available for configuration. Click on the Configure button after installation.

Step 2.1: Installing the module (Upgrading)

If you are upgrading your Geidea Online Payments module, please follow the following steps.

❗️

While many software support directly installing the latest version over the prevuious installation, it is prudent to uninstall the previous version and then install the latest version. When uninstalling, please select maximum options to remove traces of the previous installations.

You can uninstall a previous installation of your Geidea Online Payments module using the following steps

  1. Expand the dropdown arrow next to the module and click on the uninstall option. A pop-up appears as shown below. Check the "Optional: delete module folder after uninstall." and click on the "Yes, uninstall it" button.

  1. If the Geidea module is still visible in the Payment section, then refresh the page.

Now please follow the steps required for installing a fresh module in Step 1.

Step 3: Configuring the module

  1. Click on the Configure button after installing the module.

Alternatively, you could navigate to the module through the Module Manager by navigating as follows:

Modules > Module Manager > Search the GeideaPay module in the Payment category and click on the Configure button on the right side.

  1. Fill in the form to configure the module
Setting optionMandatory/OptionalDescriptionComments
ActiveMandatoryChecking this option enables you to Enable or Disable the Geidea Online Payments module. This is the same as enabling or disabling the payment method by using the Enable option on the Module Manager page. If you want to accept payments using Geidea, you must enable this option.Toggle switch
TitleMandatoryText to display to your customers during checkout
ModeMandatoryControls whether you are using a test (sandbox) or live environmentDefault is sandbox
EnvironmentMandatorySelect the environment in which you would like to execute the transactions

1. EGY-PROD

2. KSA-PROD
3. UAE-PROD
Dropdown
Enable ReceiptOptionalUsed to select whether a summary of the payment transaction must be displayed after the transaction is completeToggle switch
Enable EmailOptionalDisplays the option to edit the email of the customer in the payment widgetToggle switch
Enable Phone NumberOptionalDisplays the option to edit the phone number of the customer in the payment widgetToggle switch
Enable AddressOptionalDisplays the option to edit the shipping and billing addresses of the customer in the payment widgetToggle switch
Hide Geidea LogoOptionalHides Geidea logo in the widgetToggle switch
Hosted payment page styleOptionalUsed to set the experience for the payment widget. It has 2 values - Simple, CompressedDrop-down
Header ColorOptionalHexadecimal code of the colour that is displayed at the top of the payment widget# 333FFF
Upload ImageOptionalThe logo of the merchant is presented on the payment widget
Sandbox Merchant API PasswordMandatoryYour 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
Sandbox Merchant 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
Production Merchant API PasswordMandatoryYour 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
Production Merchant 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
  1. Click on Save.

After following these steps, Geidea Online Payments should be configured successfully, and you should be able to test the gateway by completing a checkout process.

1294

PrestaShop checkout page

1294

Geidea Hosted Payment Page