PHPackages                             payflex/magento2-gateway - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. payflex/magento2-gateway

ActiveMagento2-module

payflex/magento2-gateway
========================

Payflex Gateway

v2.0.3(1mo ago)0142↑12.8%OSL-3.0PHPPHP &gt;=7.4

Since Jul 13Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/PayFlexSA/payflex-magento-2-4-module)[ Packagist](https://packagist.org/packages/payflex/magento2-gateway)[ RSS](/packages/payflex-magento2-gateway/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (11)Versions (3)Used By (0)

Payflex Magento 2.4 Gateway Plugin
==================================

[](#payflex-magento-24-gateway-plugin)

Overview
--------

[](#overview)

The Payflex Magento 2.4 Gateway plugin integrates Payflex with your Magento store, adding Payflex "pay in instalments" as a checkout payment method.

**Requirements:** PHP 7.4 or newer, and one of the Magento versions listed below.

Tested Magento2 Versions
------------------------

[](#tested-magento2-versions)

- Magento 2.4.5
- Magento 2.4.6
- Magento 2.4.7
- Magento 2.4.8
- Magento 2.4.9

Installation Steps
------------------

[](#installation-steps)

Follow these steps to install the Payflex Gateway plugin:

> ⚠️ **Choose one installation method — 1a *or* 1b, not both.** Keeping a copy in `app/code/Payflex/Gateway` (1a) *and* installing via Composer (1b) means two copies of the module on disk. The module's `registration.php` guards against a double-registration fatal — whichever copy loads first wins and the other silently defers — but running both is confusing and makes updates unpredictable. If you are migrating from a manual install to Composer, delete `app/code/Payflex/Gateway` first (and vice versa).

### 1a. Copy Plugin to Directory (Manual)

[](#1a-copy-plugin-to-directory-manual)

- Paste the plugin into the appropriate directory: `/app/code/` for a release (downloaded a zip), or `/app/code/Payflex/Gateway` if you're using the repo directly
- This README.md should be located here if done correctly: `/app/code/Payflex/Gateway/README.md`

### 1b. Install via Composer

[](#1b-install-via-composer)

From your Magento root directory, run:

```
composer require "payflex/magento2-gateway:^2.0"
```

`^2.0` tracks the latest stable `2.x` release; `composer update payflex/magento2-gateway` pulls newer ones later. (Windows `cmd` users: keep the quotes so `^` isn't treated as an escape.)

### 2. Run Magento Setup Commands

[](#2-run-magento-setup-commands)

- Open your terminal and navigate to your Magento root directory.
- Execute the following commands:

    ```
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy -f
    chmod -R 775 var/ pub/ pub/static/ generated/
    php bin/magento cache:clean
    ```

    > **Note:** `setup:static-content:deploy -f` is only required in production mode; in developer mode you can skip it. Adjust the `chmod` target ownership/permissions to match your hosting setup — `775` with the correct web-server group is generally sufficient. See Magento's [file system permissions](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/prerequisites/file-system/overview) guidance if in doubt.

### 3. Configure the Payment Method

[](#3-configure-the-payment-method)

Once the setup commands finish, enable and configure the gateway in the Magento admin:

1. Go to **Stores → Configuration → Sales → Payment Methods → Payflex**.
2. Enter your Payflex **Client ID** and **Client Secret**, and select the correct **Environment** (Sandbox or Production).
3. Set **Enabled** to *Yes* and save.
4. Flush the cache (`php bin/magento cache:flush`) if the method does not appear at checkout immediately.

Upgrading from Previous Versions of This Plugin (&lt;V2.0.0)
------------------------------------------------------------

[](#upgrading-from-previous-versions-of-this-plugin-v200)

1. **Check Pending Orders:**

    - Ensure there are no current orders pending payment that are newer than about an hour old. Existing orders that were completed will still contain their order notes but will effectively be treated as a separate gateway.
    - We suggest putting up a maintenance page while installing this module to avoid any risk of in-progress orders failing during the upgrade process
2. **Check your current config**

    - Review your configuration for Payflex in the admin panel, make sure you have your client details because you will need to fill them in again at the end
3. **Backup:**

    - Make a database and file backup before upgrading.
4. **Remove Old Module:**

    - Delete the old `/app/code/MR/` folder.
5. **Add New Module:**

    - Add the new Payflex module in its place.
6. **Run Upgrade Commands:**

    - Run the necessary commands as you usually would to activate the new module.
7. **Configuration:**

    - Once the new module is active, input your client details and set up the configuration on the configuration page. All new orders should work as normal.
8. **Legacy files**

    - Older modules needed to have `symfony/lock` installed via composer, and the `SourceSandboxproduction.php` file added to `Magento/Config/Model/Config/`. Once you upgrade to the new module, these can be removed if you wish, though leaving them shouldn't cause any issues.

Additional Information
----------------------

[](#additional-information)

- Ensure that you have the necessary permissions to execute the commands.
- It is recommended to back up your Magento store before performing the installation.
- For any issues or support, please contact the Payflex support team.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance90

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/194436fd09c6acc8c4e1c68380e75c4ddcd8780894b894e184cf6cdd59714646?d=identicon)[NHoffmann](/maintainers/NHoffmann)

---

Top Contributors

[![nmjbhoffmann](https://avatars.githubusercontent.com/u/737370?v=4)](https://github.com/nmjbhoffmann "nmjbhoffmann (29 commits)")

### Embed Badge

![Health badge](/badges/payflex-magento2-gateway/health.svg)

```
[![Health](https://phpackages.com/badges/payflex-magento2-gateway/health.svg)](https://phpackages.com/packages/payflex-magento2-gateway)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1162.0M19](/packages/mollie-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50413.8k26](/packages/dotdigital-dotdigital-magento2-extension)[buckaroo/magento2

Buckaroo Magento 2 extension

32431.3k8](/packages/buckaroo-magento2)[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8054.9M54](/packages/smile-elasticsuite)[yireo/magento2-emailtester2

Preview transactional emails and test send them in your backend

34452.5k](/packages/yireo-magento2-emailtester2)[loki/magento2-admin-components

Admin Panel grids and forms created via Loki Components

1712.4k10](/packages/loki-magento2-admin-components)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
