PHPackages                             mahocommerce/module-przelewy24 - 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. [Payment Processing](/categories/payments)
4. /
5. mahocommerce/module-przelewy24

ActiveMaho-module[Payment Processing](/categories/payments)

mahocommerce/module-przelewy24
==============================

Przelewy24 payment gateway integration for Maho

v2.4.0(1w ago)1121↑252.9%1OSL-3.0PHPPHP >=8.3CI passing

Since Apr 10Pushed 1w ago2 watchersCompare

[ Source](https://github.com/MahoCommerce/module-przelewy24)[ Packagist](https://packagist.org/packages/mahocommerce/module-przelewy24)[ Fund](https://www.buymeacoffee.com/fballiano)[ Fund](https://paypal.me/fabrizioballiano)[ RSS](/packages/mahocommerce-module-przelewy24/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (9)Dependencies (7)Versions (14)Used By (0)

Maho Przelewy24
===============

[](#maho-przelewy24)

[![Maho Commerce](https://camo.githubusercontent.com/b6b18863bd9be2e126f1d0153283cb2c819a84aaf70031e8b7587a9faedeebcb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d61686f5f436f6d6d657263652d6d6f64756c652d6f72616e6765)](https://camo.githubusercontent.com/b6b18863bd9be2e126f1d0153283cb2c819a84aaf70031e8b7587a9faedeebcb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d61686f5f436f6d6d657263652d6d6f64756c652d6f72616e6765)[![License](https://camo.githubusercontent.com/bf8fb4e29810a9fc189ac77817d64e700c8cdad65219aec8af767d3413542703/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c7565)](https://camo.githubusercontent.com/bf8fb4e29810a9fc189ac77817d64e700c8cdad65219aec8af767d3413542703/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4f534c2d2d332e302d626c7565)[![PHP](https://camo.githubusercontent.com/304040cd133992ef00119f16bf25c890678ce0c5b9898eb2b53349394e39707e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d383839324246)](https://camo.githubusercontent.com/304040cd133992ef00119f16bf25c890678ce0c5b9898eb2b53349394e39707e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e332d383839324246)[![PHPStan Level](https://camo.githubusercontent.com/ff3c7f8c8667ce643f47e74532748f673482a5f95d7d4269f925f2eebbe5117e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e)](https://camo.githubusercontent.com/ff3c7f8c8667ce643f47e74532748f673482a5f95d7d4269f925f2eebbe5117e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e)

**Przelewy24** payment gateway integration for [Maho Commerce](https://mahocommerce.com).

Accept payments through [Przelewy24](https://www.przelewy24.pl), one of Poland's most popular payment gateways.

> **Note:** This module currently supports the **gateway redirect** flow only — the customer is redirected to Przelewy24's hosted payment page to choose their payment method. Direct card payments, BLIK, Google Pay, and Apple Pay are planned for future releases.

Features
--------

[](#features)

- **Gateway redirect** — Customer selects their preferred payment method on Przelewy24's hosted payment page
- **Full order lifecycle** — Capture and refund (partial and full) from the Maho admin
- **Webhook support** — Real-time payment and refund notifications with SHA384 signature verification
- **Cron safety net** — Automatic polling of pending payments every 5 minutes in case webhooks fail
- **Sandbox mode** — Test integration with Przelewy24's sandbox environment
- **Country restrictions** — Allow payments from all or specific countries

Requirements
------------

[](#requirements)

- PHP >= 8.3
- Maho Commerce
- A [Przelewy24](https://www.przelewy24.pl) merchant account

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

[](#installation)

```
composer require mahocommerce/module-przelewy24
```

Clear the cache after installation:

```
php maho cache:flush
```

Configuration
-------------

[](#configuration)

Navigate to **System > Configuration > Payment Methods** in the Maho admin panel.

### General Settings (Przelewy24 - General Settings)

[](#general-settings-przelewy24---general-settings)

SettingDescriptionDefault**Sandbox Mode**Use Przelewy24 sandbox for testingYes**Merchant ID**Your Przelewy24 merchant account ID—**POS ID**Point of Sale ID (usually same as Merchant ID)—**CRC Key**Used for request signing and webhook verification—**API Key**Used for HTTP Basic Authentication with the API—### Payment Method (Przelewy24 - Gateway Payment)

[](#payment-method-przelewy24---gateway-payment)

SettingDescriptionDefault**Enabled**Activate the payment methodNo**Title**Payment method name shown at checkoutPrzelewy24**Applicable Countries**All countries or specific countries onlyAll**Sort Order**Display position among payment methods100How It Works
------------

[](#how-it-works)

1. **Order placement** — Customer selects Przelewy24 at checkout, order is created in `pending_payment` state
2. **Registration** — A transaction is registered with Przelewy24's API, returning a payment token
3. **Redirect** — Customer is redirected to Przelewy24's hosted payment page to complete payment
4. **Webhook** — Przelewy24 sends a signed notification to your store confirming payment
5. **Verification** — The module verifies the transaction with Przelewy24's API and captures the payment
6. **Invoice** — An invoice is automatically created and the order moves to `processing`

If the webhook fails to arrive, a cron job polls Przelewy24 every 5 minutes for pending orders (up to 24 hours old).

Webhooks
--------

[](#webhooks)

Configure the following webhook URL in your Przelewy24 merchant panel:

```
https://your-store.com/przelewy24/webhook/transaction

```

For refund notifications:

```
https://your-store.com/przelewy24/webhook/refund

```

Supported Currencies
--------------------

[](#supported-currencies)

All currencies supported by your Przelewy24 merchant account. Amounts are converted to grosze (1/100) for API communication.

Roadmap
-------

[](#roadmap)

- BLIK (inline 6-digit code entry at checkout)
- Direct card payments (Przelewy24 iframe)
- Google Pay
- Apple Pay

License
-------

[](#license)

This module is licensed under the [Open Software License v3.0](LICENSE.txt).

Links
-----

[](#links)

- [Maho Commerce](https://mahocommerce.com)
- [Przelewy24](https://www.przelewy24.pl)
- [Przelewy24 API Documentation](https://developers.przelewy24.pl)

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance98

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% 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

Every ~6 days

Recently: every ~0 days

Total

9

Last Release

10d ago

Major Versions

1.0.0 → v2.0.02026-05-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/262e16fb4a6bbef60ac0fd0172f5586e2c24effcc80a2138e662fb0316083c4c?d=identicon)[fballiano](/maintainers/fballiano)

---

Top Contributors

[![fballiano](https://avatars.githubusercontent.com/u/909743?v=4)](https://github.com/fballiano "fballiano (20 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![tmewes](https://avatars.githubusercontent.com/u/12640514?v=4)](https://github.com/tmewes "tmewes (2 commits)")[![maho-organization-controller[bot]](https://avatars.githubusercontent.com/u/176492716?v=4)](https://github.com/maho-organization-controller[bot] "maho-organization-controller[bot] (1 commits)")

---

Tags

mahomaho-modulepaymentpayment-integrationpayment-methodprzelewy24

###  Code Quality

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mahocommerce-module-przelewy24/health.svg)

```
[![Health](https://phpackages.com/badges/mahocommerce-module-przelewy24/health.svg)](https://phpackages.com/packages/mahocommerce-module-przelewy24)
```

###  Alternatives

[omnipay/coinbase

Coinbase driver for the Omnipay payment processing library

18570.2k1](/packages/omnipay-coinbase)[yenepay/php-sdk

YenePay SDK for PHP

112.7k](/packages/yenepay-php-sdk)

PHPackages © 2026

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