PHPackages                             schrammel-codes/magento2-epc-qr-code - 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. schrammel-codes/magento2-epc-qr-code

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

schrammel-codes/magento2-epc-qr-code
====================================

This modules enables merchants to provide an EPC QR code for banktransfer payments to customers

2.1.0(7mo ago)83.1k↓31%3[1 PRs](https://github.com/schrammel-codes/magento2-epc-qr-code/pulls)MITPHPPHP ^8.1

Since Apr 3Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/schrammel-codes/magento2-epc-qr-code)[ Packagist](https://packagist.org/packages/schrammel-codes/magento2-epc-qr-code)[ RSS](/packages/schrammel-codes-magento2-epc-qr-code/feed)WikiDiscussions develop-2.x Synced 2d ago

READMEChangelog (6)Dependencies (3)Versions (9)Used By (0)

SchrammelCodes\_EpcQrCode
=========================

[](#schrammelcodes_epcqrcode)

Enables merchants to provide an EPC QR code for banktransfer payments to customers.

 [![Supported Magento Versions](https://camo.githubusercontent.com/2113b3a30955562f026a2b7dda3a09fee30d0c49aacbfce67193c5dc7b434617/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6167656e746f2d322e342d627269676874677265656e2e7376673f6c6f676f3d6d6167656e746f266c6f6e6743616368653d74727565267374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/2113b3a30955562f026a2b7dda3a09fee30d0c49aacbfce67193c5dc7b434617/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6167656e746f2d322e342d627269676874677265656e2e7376673f6c6f676f3d6d6167656e746f266c6f6e6743616368653d74727565267374796c653d666c61742d737175617265) [![Latest Stable Version](https://camo.githubusercontent.com/371de4ff343709fd2645efceee7f3a00a7bac1d129298cab4d027c4d6aba473a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73636872616d6d656c2d636f6465732f6d6167656e746f322d6570632d71722d636f64652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/schrammel-codes/magento2-epc-qr-code) [![Composer Downloads](https://camo.githubusercontent.com/88da6e2a8dc2b6bac08792919e46501628b13a0bdbbe0388531dee8ba0722589/68747470733a2f2f706f7365722e707567782e6f72672f73636872616d6d656c2d636f6465732f6d6167656e746f322d6570632d71722d636f64652f646f776e6c6f616473)](https://packagist.org/packages/schrammel-codes/magento2-epc-qr-code) [![Maintained - Yes](https://camo.githubusercontent.com/04aba48520e6322ebc6c41b7995626a88ce408bd46ec4eb15ae474936b345276/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61696e7461696e65642533462d7965732d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/schrammel-codes/magento2-epc-qr-code/graphs/commit-activity) [![License - MIT](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT)

Table of contents
-----------------

[](#table-of-contents)

- [📝 Summary](#summary)
- [ℹ️ Background](#background)
- [👨🏼‍🔧 Installation](#installation)
- [🛠️ Configuration](#configuration)
- [🗓️ Usage](#usage)
- [⛙ Contribution](#contribution)
- [⬆️ Upgrade](#upgrade)
- [⚖️ License](#license)

📝 Summary
---------

[](#-summary)

To ease payments for customers, merchants can provide an EPC QR code for banktransfer payments.
This module adds new configurations to the `Banktransfer` payment method, which generates an EPC QR code for the customer to scan with their banking app.

ℹ️ Background
-------------

[](#ℹ️-background)

[EPC QR codes (PDF)](https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf)are a standardized way to provide payment information to customers. The generated QR code contains all the information needed to make a banktransfer payment, such as the beneficiary, IBAN, the transaction amount and the reference.
The customers simply can scan the QR code with their banking app to initiate the payment.

👨🏼‍🔧 Installation
-----------------

[](#‍-installation)

```
composer require schrammel-codes/magento2-epc-qr-code
bin/magento module:enable SchrammelCodes_EpcQrCode
bin/magento setup:upgrade

```

🛠️ Configuration
----------------

[](#️-configuration)

This module adds additional configurations to the `Banktransfer` payment method in `Stores > Configuration > Sales > Payment Methods > Bank Transfer Payment`.

[![Configuration options](./docs/configuration.png "Configuration options")](./docs/configuration.png)

`Render QR code as Base64 encoded value` has to be used with caution. It is recommended to use this option only, if it's that your customers don't get a QR code rendered in Gmail clients, as the most widely used email client [not supporting `base64` encoded images](https://www.caniemail.com/features/image-base64/) as image source.

> When using colors for your QR code, make sure it is easy to scan. Some color combinations might make it hard to impossible for the banking apps to process the QR code.

🗓️ Usage
--------

[](#️-usage)

As soon as the module is enabled and configured with correct information, the QR code will be rendered below the banktransfer payment instructions in every place they are rendered.

[![Payment instructions with QR code](./docs/payment_instructions.png "Payment instructions with QR code")](./docs/payment_instructions.png)

> Please observe, that the above shown QR code is an example and does not contain a valid IBAN which results in an error scanning this code with a banking app. With correct configuration, the QR code will work as intended.

Further, the module offers a view model `\SchrammelCodes\EpcQrCode\ViewModel\QrCode` with following methods that can be used to render the QR code image tag in the frontend:

- `renderQrCodeImageTagFromOrderIncrementId(string $orderIncrementId): ?string`
- `renderQrCodeImageTagFromOrder(\Magento\Sales\Api\Data\OrderInterface $order): ?string`

If the prerequisites to render the QR code are not met, the methods will return `null`.

⬆️ Upgrade
----------

[](#️--upgrade)

### Migration path from `1.x` to `2.1` onwards

[](#migration-path-from-1x-to-21-onwards)

As `2.0.0` introduced a breaking change by introducing a hash check on public EPC QR code URLs to avoid order probing, `2.1.0` introduces an upgrade timestamp flag, automatically bypassing the has validation on orders that got placed prior to that date but keeping the check mandatory on newer orders.

If you've been on version 1.x before already, make sure to directly upgrade to a version &gt;= 2.1.0 to ensure your customers don't see broken QR code images in their older order confirmation emails.

⛙ Contribution
--------------

[](#-contribution)

Contributions are welcome! If you have any suggestions, feature requests or issues, please [create a new issue](https://github.com/schrammel-codes/magento2-epc-qr-code/issues)or [submit a pull request](https://github.com/schrammel-codes/magento2-epc-qr-code/pulls).

⚖️ License
----------

[](#️-license)

[MIT](https://opensource.org/licenses/MIT) Copyright (c) 2024-2025 Dipl.-Ing. Andreas Schrammel, BSc.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance65

Regular maintenance activity

Popularity29

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.2% 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 ~122 days

Recently: every ~58 days

Total

6

Last Release

212d ago

Major Versions

1.1.2 → 2.0.02025-11-28

### Community

Maintainers

![](https://www.gravatar.com/avatar/e54f6b54d30204518e69b61769d11fee324a30a0e48446d300e92ab4628bb0e9?d=identicon)[aschrammel](/maintainers/aschrammel)

---

Top Contributors

[![aschrammel](https://avatars.githubusercontent.com/u/1203434?v=4)](https://github.com/aschrammel "aschrammel (20 commits)")[![rommelfreddy](https://avatars.githubusercontent.com/u/15031079?v=4)](https://github.com/rommelfreddy "rommelfreddy (1 commits)")

### Embed Badge

![Health badge](/badges/schrammel-codes-magento2-epc-qr-code/health.svg)

```
[![Health](https://phpackages.com/badges/schrammel-codes-magento2-epc-qr-code/health.svg)](https://phpackages.com/packages/schrammel-codes-magento2-epc-qr-code)
```

###  Alternatives

[adyen/module-payment

Official Magento2 Plugin to connect to Payment Service Provider Adyen.

1673.2M10](/packages/adyen-module-payment)[checkoutcom/magento2

Checkout.com Payment Gateway for Magento 2

34276.3k1](/packages/checkoutcom-magento2)[buckaroo/magento2

Buckaroo Magento 2 extension

32420.3k8](/packages/buckaroo-magento2)[payone-gmbh/magento-2

PAYONE payment gateway for all German online and offline payment methods including PayPal, all major Credit Cards.

29447.5k2](/packages/payone-gmbh-magento-2)[mollie/magento2-hyva-checkout

Hyvä Themes Checkout module for Mollie Payments

11240.0k](/packages/mollie-magento2-hyva-checkout)[vipps/module-payment

Vipps MobilePay Payment Module for Magento 2

1098.4k](/packages/vipps-module-payment)

PHPackages © 2026

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