PHPackages                             payplug/payplug-magento2 - 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. payplug/payplug-magento2

ActiveMagento2-module

payplug/payplug-magento2
========================

Payplug Payments module for Magento 2

4.6.3(2mo ago)745.8k↓19%7[9 issues](https://github.com/payplug/payplug-magento2/issues)[8 PRs](https://github.com/payplug/payplug-magento2/pulls)1OSL-3.0PHPPHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0CI failing

Since May 6Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/payplug/payplug-magento2)[ Packagist](https://packagist.org/packages/payplug/payplug-magento2)[ RSS](/packages/payplug-payplug-magento2/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (12)Versions (117)Used By (1)

Payplug Payments Module
=======================

[](#payplug-payments-module)

Installation
------------

[](#installation)

### Pre-requirements

[](#pre-requirements)

- Adobe Commerce / Magento Open Source **2.4.1 – 2.4.8**
- PHP **8.1 – 8.4**
- PHP extension **openssl** (required)

### Installation via Magento Back Office

[](#installation-via-magento-back-office)

You can follow Magento’s instruction provided at

### Installation via composer

[](#installation-via-composer)

#### Composer

[](#composer)

How to get Composer : Please follow instructions on

How to update your Composer version : Please follow instructions on

#### Installation

[](#installation-1)

Run the following commands in Magento root directory:

```
composer require payplug/payplug-magento2  # (*)
composer install
php bin/magento module:enable Payplug_Payments --clear-static-content
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy   # (**)(***)
php bin/magento cache:clean

```

(\*) If you didn’t save them when you installed Magento 2, this command will ask for your Magento authentication keys (). Login = Public Key Password = Private Key

(\*\*) With the languages option, you can define for which language you want to generate your static content. Languages should be separated with a space. For example, to generate content for locales en\_US and fr\_FR, you can run the command:

```
php bin/magento setup:static-content:deploy en_US fr_FR

```

(\*\*\*) If you are not running on production mode, use the --force option. Otherwise the command will fail. For example, to generate content for locales en\_US and fr\_FR, you can run the command:

```
php bin/magento setup:static-content:deploy --force en_US fr_FR  # --force # if you are not running on production mode

```

**Troubleshooting:**

If you get a missing class error message while following the install process:

```
[ReflectionException] Class Payplug\Authentication does not exist

```

It’s likely that the Payplug PHP library was not installed along with the Magento module. This will happen if you did not run composer to install the module. To fix it, you should require the missing dependency with composer :

```
composer require payplug/payplug-php:^3.0

```

You will then need to install another library which we use to normalize the customers' phone number

```
composer require giggsey/libphonenumber-for-php:^8.10

```

### Cron Job Configuration

[](#cron-job-configuration)

The Payplug Payments module introduces new cron tasks that are grouped under the **`payplug`** cron group in `etc/crontab.xml`. These cron jobs **must** run for the module to function properly.

- **`payplug_payments_check_order_consistency`**: Checks and updates the consistency of orders with Payplug.
- **`payplug_payments_auto_capture_deferred_payments`**: Capture the deferred payments after too much time elapsed.
- If your orders get stuck in **`payment review`** status, it typically indicates that **`payplug_payments_check_order_consistency`** is not running. Be sure to include this cron in your system’s crontab so that it is executed regularly (every 15 min by default, but you can override it to run it more frequently).

#### Verifying Crons and Logs

[](#verifying-crons-and-logs)

- Ensure your Magento crontab is correctly configured to run all Magento cron groups, including the **`payplug`** group which should be handled by default with the **`cron:run`** native command, deployed by the other native **`cron:install`** command.
- If you need to investigate any issues with these jobs, you can consult the **`var/log/payplug_payments.log`** file to see detailed logs and errors related to the Payplug Payments module’s cron executions.

For more information on how to properly configure and schedule Magento 2 cron jobs, consult [Magento’s official documentation](https://experienceleague.adobe.com/fr/docs/commerce-operations/configuration-guide/cli/configure-cron-jobs)

For more information about the new **`payplug_payments_check_order_consistency`** cron, consult [the Payplug CRON documentation](docs/CRONS.md)

### Update Payplug Payments Module

[](#update-payplug-payments-module)

Run the following commands in Magento root directory:

```
composer require --update-with-all-dependencies payplug/payplug-magento2:VERSION_YOU_WANT_TO_UPDATE_TO  # (*)
composer install
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy   # (**)
php bin/magento cache:clean

```

(\*) To determine which value for `VERSION_YOU_WANT_TO_UPDATE_TO`, you can check out our [last releases](https://github.com/payplug/payplug-magento2/releases)For example, you can run:

```
composer require --update-with-all-dependencies payplug/payplug-magento2:^1.5

```

(\*\*) With the languages option, you can define for which language you want to generate your static content. Languages should be separated with a space. For example, to generate content for locales en\_US and fr\_FR, you can run the command:

```
php bin/magento setup:static-content:deploy en_US fr_FR

```

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance69

Regular maintenance activity

Popularity38

Limited adoption so far

Community29

Small or concentrated contributor base

Maturity98

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

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

Every ~56 days

Recently: every ~47 days

Total

72

Last Release

67d ago

Major Versions

2.7.0 → 3.0.02015-05-06

2.5.1 → 3.5.52015-05-06

1.27.4 → 4.0.02024-09-04

PHP version history (3 changes)2.0.0PHP &gt;=5.3.0

4.0.0PHP &gt;=8.1

4.5.0PHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/364668d1eebff4a07702d6adacdb3a026e4da45046ea1de66884893e43650827?d=identicon)[splanquart](/maintainers/splanquart)

![](https://www.gravatar.com/avatar/f4a287f22902e3f232d251237ec5cb36a0829c085f2a6145f100d47a8b6b14bd?d=identicon)[dmurillo-payplug](/maintainers/dmurillo-payplug)

---

Top Contributors

[![sophie-mulard](https://avatars.githubusercontent.com/u/22291441?v=4)](https://github.com/sophie-mulard "sophie-mulard (238 commits)")[![TristanBouchierAgenceDnD](https://avatars.githubusercontent.com/u/54933827?v=4)](https://github.com/TristanBouchierAgenceDnD "TristanBouchierAgenceDnD (217 commits)")[![esprit-dev](https://avatars.githubusercontent.com/u/7630693?v=4)](https://github.com/esprit-dev "esprit-dev (204 commits)")[![DnD-Rodgeur](https://avatars.githubusercontent.com/u/68945045?v=4)](https://github.com/DnD-Rodgeur "DnD-Rodgeur (199 commits)")[![alopez-pp](https://avatars.githubusercontent.com/u/63304175?v=4)](https://github.com/alopez-pp "alopez-pp (54 commits)")[![PPmmesquita](https://avatars.githubusercontent.com/u/96418914?v=4)](https://github.com/PPmmesquita "PPmmesquita (49 commits)")[![dan-payplug](https://avatars.githubusercontent.com/u/75317753?v=4)](https://github.com/dan-payplug "dan-payplug (42 commits)")[![Aphy](https://avatars.githubusercontent.com/u/497749?v=4)](https://github.com/Aphy "Aphy (37 commits)")[![GhDj](https://avatars.githubusercontent.com/u/2568401?v=4)](https://github.com/GhDj "GhDj (25 commits)")[![lacan1](https://avatars.githubusercontent.com/u/89386372?v=4)](https://github.com/lacan1 "lacan1 (16 commits)")[![Dixeat](https://avatars.githubusercontent.com/u/10630490?v=4)](https://github.com/Dixeat "Dixeat (13 commits)")[![juchi](https://avatars.githubusercontent.com/u/3333098?v=4)](https://github.com/juchi "juchi (13 commits)")[![zadil99](https://avatars.githubusercontent.com/u/110617024?v=4)](https://github.com/zadil99 "zadil99 (6 commits)")[![dmurillo-payplug](https://avatars.githubusercontent.com/u/159765202?v=4)](https://github.com/dmurillo-payplug "dmurillo-payplug (5 commits)")[![ronan-jaffre](https://avatars.githubusercontent.com/u/49979586?v=4)](https://github.com/ronan-jaffre "ronan-jaffre (5 commits)")[![mrorgues-payplug](https://avatars.githubusercontent.com/u/43468427?v=4)](https://github.com/mrorgues-payplug "mrorgues-payplug (5 commits)")[![hdelaforce-payplug](https://avatars.githubusercontent.com/u/51410640?v=4)](https://github.com/hdelaforce-payplug "hdelaforce-payplug (3 commits)")[![dnd-mistert](https://avatars.githubusercontent.com/u/181051267?v=4)](https://github.com/dnd-mistert "dnd-mistert (2 commits)")[![vvanroye-payplug](https://avatars.githubusercontent.com/u/141426066?v=4)](https://github.com/vvanroye-payplug "vvanroye-payplug (2 commits)")[![EA-SK](https://avatars.githubusercontent.com/u/143426277?v=4)](https://github.com/EA-SK "EA-SK (1 commits)")

### Embed Badge

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

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

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[pagbank/payment-magento

PagBank - Payment for Magento and Adobe

2128.3k7](/packages/pagbank-payment-magento)[o2ti/sigep-web-carrier

O2TI - Sigep Web Carrier

141.5k](/packages/o2ti-sigep-web-carrier)

PHPackages © 2026

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