Magento

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

Overview

Magento is a premier open-source platform designed specifically for e-commerce needs. Owned by Adobe, Magento is built using the PHP programming language, widely recognized for its security and flexibility. 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 Magento's online stores has never been easier. Through the Magento module in the Marketplace, 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.

❗️

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 create and configure your Magento online store, please follow the following steps to accept payments using the Geidea payment gateway.

Step 1: Obtaining Geidea Payments Online plugin for Magento 2

You can get the latest version of the Geidea Payment Gateway Plugin from our GitHub repository.

Step 1: Install Geidea Payments Online plugin for Magento 2

To know your Magento CMS version, go to the Magento admin panel that is typically located in the admin path of your sites' URL such as https://your_magento_site_url/admin

You can find the version of your Magento 2 installation at the right corner of the bottom of the dashboard:

Plugin installation and setup

You can download the latest version of the plugin from our GitHub repository.

To obtain a previous version, visit the releases section here https://github.com/GeideaSolutions/Magento-Geidea-Module/releases and download the required version.

Step 1 - Installation

After downloading the plugin to your local machine, extract it on your local machine.

Create the following folder structure in the folder titled "app" on your server:app/code/Geidea/Payment

Place the contents of your zip file in the following path of your server.

Place archive content here:
https://your_magento_site_url/app/code/Geidea/Payment:

Now open a terminal, connect to your server, and run the following code on the server where Magento is installed:

1. Enable the new plugin: /bin/magento module:enable Geidea_Payment
2. Update Magento configuration: /bin/magento setup:upgrade

🚧

In case you face any issue with file access after running the code snippet shared above, please run the following code to update the permissions.

sudo chmod -R 0777 var/ generated/

Step 2 - Plugin configuration

Navigate to Stores -> Configuration

Then navigate to Sales -> Payment Methods _and click on _Configure _next to _Geidea Online Payments

You will be shown two categories of options to configure

1. General Settings
2. Payment system settings

Configuring General Settings

The below table presents the mandatory options that are required for using the Geidea extension for the Magento framework

Configuring Payment system settings

After entering the required details, click on the Save Config button

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.

Magento Checkout Page

Geidea Hosted Payment Page