PHPackages                             payu/magento24-payment-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. [Payment Processing](/categories/payments)
4. /
5. payu/magento24-payment-gateway

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

payu/magento24-payment-gateway
==============================

Official PayU integration plugin for Magento 2.4

2.1.0(1mo ago)7436.6k↓36.6%5[5 issues](https://github.com/PayU-EMEA/plugin_magento_24/issues)1apache-2.0PHPPHP &gt;=7.4

Since Aug 20Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/PayU-EMEA/plugin_magento_24)[ Packagist](https://packagist.org/packages/payu/magento24-payment-gateway)[ RSS](/packages/payu-magento24-payment-gateway/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (10)Dependencies (8)Versions (39)Used By (1)

[**Wersja polska**](README.PL.md)

PayU module for Magento 2 version 2.4
=====================================

[](#payu-module-for-magento-2-version-24)

BREAKING CHANGES
----------------

[](#breaking-changes)

**Due to changes described in [CHANGELOG](CHANGELOG.md) after updating plugin from version 1.X to 2.X, you must reconfigure plugin.**

**If you have any questions or if you want to report an error, please contact our support at the address: .**

- If you are using Magento version 1.x, please use a [plugin for version 1.x](https://github.com/PayU-EMEA/plugin_magento)
- If you are using Magento version &gt;2.0.6, 2.1, 2.2, please use a [plugin for version &gt;2.0.6, 2.1, 2.2](https://github.com/PayU-EMEA/plugin_magento_2)
- If you are using Magento version 2.3, please use a [plugin for version 2.3](https://github.com/PayU-EMEA/plugin_magento_23)

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

[](#table-of-contents)

1. [Properties](#properties)
2. [Requirements](#requirements)
3. [Installation](#installation)
4. [Configuration](#configuration)
    - [Parameters](#parameters)
5. [Information about properties](#information-about-properties)
    - [Order of payment methods](#order-of-payment-methods)
    - [Repeat payment](#repeat-payment)
    - [Saving card](#saving-cards)

Properties
----------

[](#properties)

PayU payment module adds a PayU payment option to Magento 2. The module works together with Magento 2 version 2.4

The following operations are possible:

- Creation of payment in the PayU system
- Automatic receipt of notifications and change of order status
- Receipt or rejection of payment (in case of switched off automatic receipt)
- Display of payment method and selection of the method on the order summary page
- Payment by card directly on the order summary page
- Remembering of cards and payment with the remembered card
- Repeat payment
- Creation of online refund (full or partial)
- Promoting credit payments using [credit widget](#credit-widget) on different subpages of the store (e.g. on the product page, in the cart)

The module adds these payment methods:

- **PayU payment** - selection of payment method and redirection a bank or card form
- **Card payment** - entry of the card number directly on the store's website and payment by card
- **PayU - Google Pay** - Google Pay payment directly on checkout (without redirecting the customer outside the store)
- **PayU Installments** - installment payments with a redirect to the PayU installment form.
- **PayU Klarna** - deferred Klarna payments with a redirect to the Klarna form in PayU.
- **PayU PayPo** - deferred PayPo payments with a redirect to the PayPo form in PayU.
- **PayU PragmaPay** - deferred PragmaPay payments with a redirect to the PragmaPay form in PayU.
- **PayU Twisto** - deferred Twisto payments with a redirect to the Twisto form in PayU.
- **PayU Twisto Pay in 3** - deferred Twisto Pay in 3 payments with a redirect to the Twisto Pay in 3 form in PayU

[![methods](readme_images/methods_en.png)](readme_images/methods_en.png)

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

[](#requirements)

**Important:** The module works only with the REST API (Checkout) POS, if you don't have an account in the PayU system yet, [**register yourself in the production system**](https://www.payu.pl/en/commercial-offer) or [**in the sandbox system**](https://secure.snd.payu.com/boarding/?pk_campaign=Plugin-Github&pk_kwd=Magento2#/form)

- PHP compliant with the requirements of the installed version of Magento 2
- PHP extension: [cURL](http://php.net/manual/en/book.curl.php) and [hash](http://php.net/manual/en/book.hash.php).

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

[](#installation)

#### Using Composer

[](#using-composer)

`composer require payu/magento24-payment-gateway`

After installation from the console's level, run:

- php bin/magento module:enable PayU\_PaymentGateway
- php bin/magento setup:upgrade
- php bin/magento setup:di:compile
- php bin/magento setup:static-content:deploy

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

[](#configuration)

1. Go to the administration page of your Magento 2 store \[http://adres-sklepu/admin\_xxx\].
2. Go to **Stores** &gt; **Configuration**.
3. On the **Configuration** page in the menu on the left-hand side, in the section **Sales** choose **Payment Methods**.
4. On the list of available payment methods choose one of the **PayU** methods to configure the plugin's parameters.
5. After changing the parameters click `Save config`.

### API Parameters

[](#api-parameters)

ParameterDescriptionTest mode (Sandbox)`Yes` - transactions are processed by the PayU Sandbox system.
 `No` - transactions are processed by the PayU production system.#### Point of sale (POS) parameters

[](#point-of-sale-pos-parameters)

ParameterDescripctionPOS IdDPOS ID from PayU systemSecond MD5 keySecond MD5 key from PayU systemOAuth - client\_idclient\_id for OAuth protocol from PayU systemOAuth - client\_secretclient\_secret for OAuth from PayU system#### POS parameters - Test mode (Sandbox)

[](#pos-parameters---test-mode-sandbox)

Available when the parameter `Test Mode (Sandbox)` is set for `Yes`.

ParameterDescriptionPOS IDPOS ID from PayU systemSecond MD5 keySecond MD5 key from PayU systemOAuth - client\_idclient\_id for OAuth protocol from PayU systemOAuth - client\_secretclient\_secret for OAuth from PayU system### "PayU Credit widget" plugin parameters

[](#payu-credit-widget-plugin-parameters)

ParameterDescriptionEnable widget for product viewValue `Yes`|`No`. Displays the widget on product pages.Enable widget for catalog viewValue `Yes`|`No`. Displays the widget on pages with product lists (e.g., categories).Enable widget for catalog widgets eg. hot, newValue `Yes`|`No`. Displays the widget on pages with product list widgets (e.g., bestseller, new).
**Experimental feature**Enable widget for checkoutValue `Yes`|`No`. Displays the widget on the cart page.Enable widget for minicartValue `Yes`|`No`. Displays the widget in the cart summary dropdown.Enable widget for cart summaryValue `Yes`|`No`. Displays the widget on the cart summary page with the payment method selection.Excluded payTypesComma-separated list of [payment methods](https://developers.payu.com/europe/docs/get-started/integration-overview/references/#installments-and-pay-later) to omit during widget display.
 **It is recommended to leave this list empty**### "PayU Payment" parameters

[](#payu-payment-parameters)

ParameterDescriptionActivate the plugin?Determines whether the payment method will be available in the store on the list of payments.Order of payment methodsDetermines the order of the payment methods being displayed [more information](#order-of-payment-methods).Activate repeat payment?[more information](#repeat-payment)Sort OrderPosition of the payment method in the list of payment methods.### "PayU - Cards" parameters

[](#payu---cards-parameters)

ParameterDescriptionActivate the plugin?Determines whether the payment method will be available in the store on the list of payments.Activate repeat payment?[more information](#repeat-payment)Activate remembering of cards?[more information](#saving-cards)Sort OrderPosition of the payment method in the list of payment methods.### "PayU - Google Pay" parameters

[](#payu---google-pay-parameters)

ParameterDescriptionActivate the plugin?Determines whether the payment method will be available in the store on the list of payments.Activate repeat payment?[more information](#repeat-payment)Sort OrderPosition of the payment method in the list of payment methods.Google Pay Merchant IDMerchant identifier in Google. You need to verify your shop in Google, following the [instructions](https://developers.google.com/pay/api/web/guides/test-and-deploy/publish-your-integration#create-your-profile).Google Merchant NameMerchant name displayed in Google Pay (should match your Google Pay profile).### "PayU - Installments", "PayU - Klarna", "PayU - PayPo", "PayU - PragmaPay", "PayU - Twisto", "PayU - Twisto Pay in 3" payment parameters

[](#payu---installments-payu---klarna-payu---paypo-payu---pragmapay-payu---twisto-payu---twisto-pay-in-3-payment-parameters)

ParameterDescriptionActivate the plugin?Determines whether the payment method will be available in the store on the list of payments.Activate repeat payment?[more information](#repeat-payment)Sort OrderPosition of the payment method in the list of payment methods.Information about properties
----------------------------

[](#information-about-properties)

### Order of payment methods

[](#order-of-payment-methods)

To determine the order of display of payment method icons indicate the payment method symbols, separating them with a comma. [List of payment methods](http://developers.payu.com/pl/overview.html#paymethods).

### Repeat payment

[](#repeat-payment)

To use this option the POS should be properly configured in PayU and automatic receipt of payments should be disabled (auto-receipt is on by default). To do that log in to the PayU panel, go to the tab "Electronic payments", then click "My stores" and POS in the given store. The "Automatic payment receipt" option can be found at the bottom under the list of payment methods.

Repeat payment makes it possible to activate multiple payments in PayU to a single order in Magento. The plugin will automatically take receipt of the first successful payment while the other ones will be cancelled. Repeat payment from the buyer's point of view is also possible through the list of orders in Magento (a link "Pay again" will appear there). The buyer will also automatically receive an e-mail with such link. Thus, the buyer is able to successfully pay for his order even if the first payment was unsuccessful (for instance, no funds on the card, problems logging in to the bank, etc.).

### Saving cards

[](#saving-cards)

Saving card allows logged in users to remember the card for future payments. Each such remembered card is "tokenized", however, Magento does not process the card's full details in any way (they are entered using an embedded widget hosted by PayU) and does not save card tokens in its database (before use, current tokens for the given user are always downloaded from PayU).

To ensure proper functioning of the service additional configuration in PayU, consisting in creating and receiving tokens, is required. Additionally, the principles of authenticating payments with the remembered card can also be determined (by default every payment with a saved card requires providing a CVV code and being authenticated by 3DS but, for instance, an amount limit up to which this will not be necessary can be defined).

The buyer may save the card while making a payment, using the option "Use and save" on PayU widget while entering the card's details. Each card being remembered is subject to strong authentication during first payment (CVV and 3DS). A saved card will appear after choosing to pay with a card through PayU for the order and is visible in the user's account (tab "My saved cards"), where an option to delete it is also available.

### Credit widget

[](#credit-widget)

To inform customers about credit payment options for a specific product, we recommend placing the credit widget next to products in product lists, in the description (details) of the selected product, in the cart, and at checkout (before payment). The configuration parameters described in the section ["PayU Credit widget" plugin parameters](#payu-credit-widget-plugin-parameters) allow flexible management of where the credit widget is displayed.

Example presentation of the credit widget

[![widget](readme_images/widget_en.png)](readme_images/widget_en.png)

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance79

Regular maintenance activity

Popularity43

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 81% 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 ~98 days

Total

23

Last Release

34d ago

Major Versions

1.0.12 → 2.0.02024-01-17

PHP version history (2 changes)1.0.0PHP &gt;=7.3

2.0.2PHP &gt;=7.4

### Community

Maintainers

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

---

Top Contributors

[![regdos](https://avatars.githubusercontent.com/u/4245011?v=4)](https://github.com/regdos "regdos (68 commits)")[![tomasz-regdos-payu-gpo](https://avatars.githubusercontent.com/u/216694454?v=4)](https://github.com/tomasz-regdos-payu-gpo "tomasz-regdos-payu-gpo (5 commits)")[![tomasz-ancukiewicz-payu-gpo](https://avatars.githubusercontent.com/u/55091406?v=4)](https://github.com/tomasz-ancukiewicz-payu-gpo "tomasz-ancukiewicz-payu-gpo (3 commits)")[![gabriel-woronowicz-payu-gpo](https://avatars.githubusercontent.com/u/41322012?v=4)](https://github.com/gabriel-woronowicz-payu-gpo "gabriel-woronowicz-payu-gpo (3 commits)")[![hostep](https://avatars.githubusercontent.com/u/85479?v=4)](https://github.com/hostep "hostep (2 commits)")[![Tomasz-Silpion](https://avatars.githubusercontent.com/u/5328659?v=4)](https://github.com/Tomasz-Silpion "Tomasz-Silpion (1 commits)")[![jemoon](https://avatars.githubusercontent.com/u/3430741?v=4)](https://github.com/jemoon "jemoon (1 commits)")[![dudzio12](https://avatars.githubusercontent.com/u/6281733?v=4)](https://github.com/dudzio12 "dudzio12 (1 commits)")

---

Tags

payment processingpayupayment-modulepayu magento 2.4 modulepayu magento 2.4blik payment

### Embed Badge

![Health badge](/badges/payu-magento24-payment-gateway/health.svg)

```
[![Health](https://phpackages.com/badges/payu-magento24-payment-gateway/health.svg)](https://phpackages.com/packages/payu-magento24-payment-gateway)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1142.0M17](/packages/mollie-magento2)[buckaroo/magento2

Buckaroo Magento 2 extension

32426.0k8](/packages/buckaroo-magento2)[paynl/magento2-plugin

Pay. Payment methods for Magento 2

30336.1k6](/packages/paynl-magento2-plugin)[afterpay-global/module-afterpay

Magento 2 Afterpay Payment Module

26329.8k2](/packages/afterpay-global-module-afterpay)[amzn/amazon-pay-magento-2-module

Official Magento2 Plugin to integrate with Amazon Pay

108542.3k1](/packages/amzn-amazon-pay-magento-2-module)[pagbank/payment-magento

PagBank - Payment for Magento and Adobe

2132.4k7](/packages/pagbank-payment-magento)

PHPackages © 2026

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