# payrexx/payment-gateway

> Payrexx Payment Gateway module for Magento 2

`composer require payrexx/payment-gateway`

Canonical URL: https://packagento.com/payrexx/payment-gateway

## At a glance

- **Vendor**: payrexx (https://packagento.com/payrexx.md)
- **Latest version**: 1.4.9 — released 2026-06-16
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/payrexx/payment-gateway and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require payrexx/payment-gateway:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Payrexx Payment Gateway module for Magento 2

## README

A Payrexx plugin to accept payments in Magento.


### Support

This module supports Magento versions **2.2.\*** - **2.4.\***  
*Note: It may work on future Magento releases, but performance cannot be guaranteed.*

### Preparation

The usage of this module requires Payrexx REST API credentials. To obtain Payrexx REST API, please create your account in [Payrexx](https://www.payrexx.com/?ref=magento).
### Integration
#### 1. Installation

###### Download the module as "zip" archive

1. Locate the **/app/** directory which should be under the Magento root installation.

2. Create the folder structure **code/Payrexx/PaymentGateway/** inside the **app** folder.

   (i.e) **app-> code->Payrexx->PaymentGateway**

3. Download the package from the github site (https://github.com/payrexx/magento-payrexx-gateway.git).

4. Extract the zip contents to the **PaymentGateway** folder you just created. The README.md and all other files and folders is stored in **PaymentGateway** folder.

#### 2. Requirements
 This extension requires the [Payrexx API library for PHP.](https://github.com/payrexx/payrexx-php)

If you are not using Composer already, then you should read the installation guide http://getcomposer.org/download/

Enter the following command in your Magento root folder:

 ```
 $ composer require payrexx/payrexx
 ```

**Note:**
If Composer needs username and password, refer http://devdocs.magento.com/guides/v2.2/install-gde/prereq/connect-auth.html

While running Composer, If you can't login to `repo.magento.com`, rename the file **auth.json.sample** into **auth.json** which is present inside Magento root directory and insert your Public Key & Private Key in the  **auth.json**.

#### 3. Magento Setup

##### Enable Extension Via Admin Web Setup Wizard

Log in to your Magento Admin Panel.

1. Go to **SYSTEM** -> **Web Setup Wizard** -> Choose **Module Manager**

2. Find **Payrexx_PaymentGateway** and select **Enable** from the Select drop-down menu.

3. Complete the Step 1: Readiness Check, Step 2: Create Backup, Step 3: Enable Module  
   Please wait until the process is completed.

##### Enable Extension via command line.

Go to Magento root directory and execute the following commands

```
$ bin/magento setup:upgrade

$ bin/magento setup:di:compile

$ bin/magento cache:clean
```

**Note:** It takes sometime for the process to complete.

#### 4. Configuration in Magento

 To configure the module, log in to your Magento Admin panel.
1. Go to **Stores** -> **Configuration** -> **Sales** -> **Payment methods** 

2. Find and click on **Payrexx** under **OTHER PAYMENT METHODS**

3. To configure your Payrexx Module Configuration, use the **Instance Name** and **API Secret**  obtained earlier while creating your account in Payrexx.
   (e.g. If you have registered the url as  https://testing123.payrexx.com your instance will be  ‘testing123’).

4. Click **Save Config** to save the configuration values.

#### 5. Payrexx Configuration

 To Configure the webhook URL in Payrexx, Log in your Payrexx account.

1. Go to **settings** -> **API** --> Find **Webhook URL**

2. Insert the URL to your shop and add /payrexx/payment/webhook
 (e.g. If your shop url is `http://www.example.com`, the Webhook URL will be `http://www.example.com/payrexx/payment/webhook`)

### Update

To make use of a new update of the module the following steps need to completed.

1. Upload the module code to the directory app/code/Payrexx/PaymentGateway of your Magento 2 installation

2. Execute the following commands for the update to take affect:
```
$ bin/magento setup:upgrade

$ bin/magento setup:di:compile

$ bin/magento cache:clean
```

## Recent Versions

| Version | Released |
|---|---|
| 1.4.9 | 2026-06-16 |
| 1.4.8 | 2026-04-15 |
| 1.4.7 | 2026-03-23 |
| 1.4.6 | 2026-03-13 |
| 1.4.5 | 2025-12-19 |
| 1.4.4 | 2025-11-17 |
| 1.4.3 | 2025-10-30 |
| 1.4.2 | 2025-10-03 |
| 1.4.1 | 2025-09-16 |
| 1.4.0 | 2025-08-13 |

Showing 10 of 33 versions. Full release history on https://packagento.com/payrexx/payment-gateway.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| payrexx/payrexx | ^2.0.12 |
| php | ^8.0 |

## Quality

Latest release (1.4.9) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Fail | 133 | 4 errors, 129 warnings (ruleset: Magento2) — 58 auto-fixable with phpcbf |
| PHPMD | Warning | 17 | 17 rule violations (UnusedFormalParameter:7, MissingImport:5, IfStatementAssignment:2, CyclomaticComplexity:1, NPathComplexity:1) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 107 | 107 | – | – |
| 2.4.8 | – | 107 | 107 | – |
| 2.4.9 | – | – | 107 | 107 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["payrexx/payment-gateway"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

payrexx is a Magento 2 vendor on Packagento. See https://packagento.com/payrexx.md for their full catalogue.

