Magento 2 – DPO Pay Plugin

Accept payments in Magento 2 using DPO Pay

The DPO Pay Magento 2 plugin enables merchants to accept secure online payments directly from their Magento 2 stores using the DPO Pay platform.

This official module integrates Magento checkout with DPO Pay’s hosted payment gateway, allowing customers to pay using cards and other supported payment methods across Africa and beyond.


Why Use the DPO Pay Magento Plugin?

By installing the DPO Pay module for Magento 2, you can:

  • Accept credit and debit card payments

  • Support multiple African payment methods

  • Process secure hosted payments

  • Offer customers a trusted checkout experience

  • Manage transactions through your DPO Pay merchant account

Pricing:
The plugin is free to install. Standard DPO Pay transaction fees apply.


Download the Plugin

The latest version of the Magento 2 plugin is available from the official DPO Pay GitHub repository:


What You’ll Need

Before installing the module, ensure you have:

  • An active DPO Pay merchant account

  • Your merchant credentials and configuration details

  • Access to your Magento 2 admin panel

  • Command-line access to your Magento server

If you do not yet have a DPO Pay account, please visit:
https://dpogroup.com/get-started/


Installation Guide

The DPO Pay Magento 2 module can be installed in two ways: automatically using Composer, or manually.


Option 1 – Automatic Installation (Recommended)

Install the module using Composer with the following command:

composer require dpo/dpo-gateway

After the package is installed, run the Magento setup commands listed below.


Option 2 – Manual Installation

  1. Visit the Releases section of the repository

  2. Download the latest Dpo.zip package

  3. Extract the contents of the ZIP file

  4. Upload the extracted Dpo directory to:

<magento_root>/app/code/

Magento CLI Commands

After installing the files (either via Composer or manually), run the following Magento CLI commands from your Magento root directory:

composer require dpo/dpo-pay-common:1.0.2
php bin/magento module:enable Dpo_Dpo
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:clean

These commands enable the module and ensure Magento recognizes the new payment method.


Configuration Guide

Once installation is complete:

  1. Log in to the Magento Admin Panel

  2. Navigate to:

flowchart LR
    Admin --> Stores --> Configuration --> Sales --> Payment_Methods --> DPO_Pay
  1. Locate DPO Pay in the list of payment methods

  2. Enter your DPO Pay merchant credentials and required settings

  3. Configure the module according to your business requirements

  4. Click Save Config

DPO Pay will now be available as a payment option on your Magento checkout page.


Customer Payment Flow

After configuration:

  1. Customers add products to their cart

  2. At checkout they select DPO Pay as the payment method

  3. They are redirected to the secure DPO Pay hosted payment page

  4. After successful payment, they return to Magento with an updated order status

No additional coding is required.


Frequently Asked Questions

Is a DPO Pay merchant account required?

Yes. You must have an active DPO Pay merchant account and credentials to configure this module.


Is the plugin free?

Yes. The Magento 2 plugin is free to download and install. Standard DPO Pay processing fees apply.


Do I need an SSL certificate?

Yes. Magento stores processing payments should always use HTTPS and a valid SSL certificate.


Who can help if I need support?

For assistance with installation or configuration, please contact the DPO Pay Support Team:


Troubleshooting Tips

If you experience issues after installation:

  • Confirm that all Magento CLI commands were executed successfully

  • Verify that the module is enabled in the Magento configuration

  • Ensure merchant credentials are correct

  • Clear Magento cache after making configuration changes

  • Confirm your DPO Pay account is active and properly configured


Plugin Details

  • Developer: DPO Group

  • Platform: Magento 2

  • Supported Version: Magento 2.4.7

  • Plugin Version: v1.3.0

  • Category: Payment Gateway

  • Languages: English