PHPackages                             kluseg/magento-23-payu-configurable - 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. kluseg/magento-23-payu-configurable

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

kluseg/magento-23-payu-configurable
===================================

Official PayU integration plugin for Magento 2.4

2.4.1(4y ago)0111OSL-3.0PHPPHP &gt;=7.3

Since Feb 3Pushed 4y ago1 watchersCompare

[ Source](https://github.com/KluseG/magento-23-payu-configurable)[ Packagist](https://packagist.org/packages/kluseg/magento-23-payu-configurable)[ RSS](/packages/kluseg-magento-23-payu-configurable/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (2)Used By (0)

[**English version**](README.EN.md)

Moduł PayU dla Magento 2 w wersji 2.4
=====================================

[](#moduł-payu-dla-magento-2-w-wersji-24)

`Moduł jest wydawany na licencji GPL.`

**Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym wsparciem pod adresem: .**

- Jeżeli używasz Magneto w wersji 1.x proszę skorzystać z [pluginu dla wersji 1.x](https://github.com/PayU-EMEA/plugin_magento)
- Jeżeli używasz Magneto w wersji &gt;2.0.6, 2.1, 2.2 proszę skorzystać z [pluginu dla wersji &gt;2.0.6, 2.1, 2.2](https://github.com/PayU-EMEA/plugin_magento_2)
- Jeżeli używasz Magneto w wersji 2.3 proszę skorzystać z [pluginu dla wersji 2.3](https://github.com/PayU-EMEA/plugin_magento_23)

Spis treści
-----------

[](#spis-treści)

1. [Cechy](#cechy)
2. [Wymagania](#wymagania)
3. [Instalacja](#instalacja)
4. [Konfiguracja](#konfiguracja)
    - [Parametry](#parametry)
5. [Informacje o cechach](#informacje-o-cechach)
    - [Kolejność metod płatności](#kolejno%C5%9B%C4%87-metod-p%C5%82atno%C5%9Bci)
    - [Ponowienie płatności](#ponowienie-p%C5%82atno%C5%9Bci)
    - [Zapisywanie kart](#zapisywanie-kart)
    - [Przewalutowanie](#przewalutowanie)

Cechy
-----

[](#cechy)

Moduł płatności PayU dodaje do Magento 2 opcję płatności PayU. Moduł współpracuje z Magento 2 w wersji 2.4

Możliwe są następujące operacje:

- Utworzenie płatności w sytemie PayU
- Automatyczne odbieranie powiadomień i zmianę statusów zamówienia
- Odebranie lub odrzucenie płatności (w przypadku wyłączonego autoodbioru)
- Wyświetlenie metod płatności i wybranie metody na stronie podsumowania zamówienia
- Płatność kartą bezpośrednio na stronie podsumowania zamówienia
- Zapisanie karty i płatność zapisaną kartą
- Ponowienie płatności
- Utworzenie zwrotu online (pełnego lub częściowego)

Moduł dodaje dwie metody płatności:

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

- **Płatność PayU** - wybór metody płatności i przekierowanie do banku lub formatkę kartową
- **Płatność kartą** - wpisanie numeru karty bezpośrednio na stronie sklepu i płatność kartą

Wymagania
---------

[](#wymagania)

**Ważne:** Moduł ta działa tylko z punktem płatności typu `REST API` (Checkout), jeżeli nie posiadasz jeszcze konta w systemie PayU [**zarejestruj się w systemie produkcyjnym**](https://www.payu.pl/oferta-handlowa) lub [**zarejestruj się w systemie sandbox**](https://secure.snd.payu.com/boarding/?pk_campaign=Plugin-Github&pk_kwd=Magento2#/form)

- Wersja PHP zgodna z wymaganiami zainstalowanej wersji Magento 2
- Rozszerzenia PHP: [cURL](http://php.net/manual/en/book.curl.php) i [hash](http://php.net/manual/en/book.hash.php).

Instalacja
----------

[](#instalacja)

#### Przy użyciu Composer

[](#przy-użyciu-composer)

`composer require payu/magento24-payment-gateway`

#### Kopiując pliki na serwer

[](#kopiując-pliki-na-serwer)

1. Pobierz najnowszą wersję moduł z [repozytorium GitHub](https://github.com/PayU-EMEA/plugin_magento_24/releases/latest)
2. Rozpakuj pobrany plik
3. Połącz się z serwerem ftp i skopiuj rozpakowaną zawartość do katalogu `app/code/PayU/PaymentGateway` swojego sklepu Magento 2. Jeżeli nie ma takiego katalogu utwórz go.

Po instalacji przy użyciu Composer lub kopiując pliki z poziomu konsoli uruchom:

- 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

Konfiguracja
------------

[](#konfiguracja)

1. Przejdź do strony administracyjnej swojego sklepu Magento 2 \[http://adres-sklepu/admin\_xxx\].
2. Przejdź do **Stores** &gt; **Configuration**.
3. Na stronie **Configuration** w menu po lewej stronie w sekcji **Sales** wybierz **Payment Methods**.
4. Na liście dostępnych metod płatności należy wybrać **PayU** lub **PayU - Cards** w celu konfiguracji parametrów wtyczki.
5. Po zmanie paramettrów naciśnij przycisk `Save config`.

### Parametry

[](#parametry)

#### Główne parametry

[](#główne-parametry)

ParameterOpisCzy włączyć wtyczkę?Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.Tryb SandboxOkreśla czy płatności będą realizowane na środowisku testowym (sandbox) PayU.Kolejność metod płatnościOkreśla kolejnośc wyświetlanych metod płatności (dostępne tylko dla `Płatność PayU`) [więcej informacji](#kolejno%C5%9B%C4%87-metod-p%C5%82atno%C5%9Bci).#### Parametry punktu płatności (POS)

[](#parametry-punktu-płatności-pos)

ParameterOpisId punktu płatnościIdentyfikator POS-a z systemu PayUDrugi klucz MD5Drugi klucz MD5 z systemu PayUOAuth - client\_idclient\_id dla protokołu OAuth z systemu PayUOAuth - client\_secretclient\_secret for OAuth z systemu PayU#### Parametry punktu płatności (POS) - Tryb testowy (Sandbox)

[](#parametry-punktu-płatności-pos---tryb-testowy-sandbox)

Dostępne gdy parametr `Tryb testowy (Sandbox)` jest ustawiony na `Tak`.

ParameterOpisId punktu płatnościIdentyfikator POS-a z systemu PayUDrugi klucz MD5Drugi klucz MD5 z systemu PayUOAuth - client\_idclient\_id dla protokołu OAuth z systemu PayUOAuth - client\_secretclient\_secret for OAuth z systemu PayU#### Inne parametry

[](#inne-parametry)

ParameterOpisCzy uaktywnić ponowienie płatności?[więcej informacji](#ponowienie-p%C5%82atno%C5%9Bci)Czy uaktywnić zapisywanie kart?Dostępne tylko dla `Płatność kartą` [więcej informacji](#zapisywanie-kart)Czy uaktywnić moduł przewalutowania?Dostępne tylko dla `Płatność kartą` [więcej informacji](#przewalutowanie)Informacje o cechach
--------------------

[](#informacje-o-cechach)

### Kolejność metod płatności

[](#kolejność-metod-płatności)

W celu ustalenia kolejności wyświetlanych ikon matod płatności należy podać symbole metod płatności oddzielając je przecinkiem. [Lista metod płatności](http://developers.payu.com/pl/overview.html#paymethods).

### Ponowienie płatności

[](#ponowienie-płatności)

Aby użyć tej opcji, należy również odpowiednio skonfigurować POSa w PayU i wyłączyć automatycznie odbieranie płatności (domyślnie auto-odbiór jest włączony). W tym celu należy zalogować się do panelu PayU, wejść do zakładki "Płatności elektroniczne", następnie wybrać "Moje sklepy" i punkt płatności na danym sklepie. Opcja "Automatyczny odbiór płatności" znajduje się na samym dole, pod listą metod płatności.

Ponowienie płatności umożliwia zakładanie wielu płatności w PayU do jednego zamówienia w Magento. Wtyczka automatycznie odbierze pierwszą udaną płatność, a pozostałe zostaną anulowane. Ponowienie płatności z punktu widzenia kupującego jest możliwe poprzez listę zamówień w Magento (pojawi się tam link "Zapłać ponownie"). Kupujący automatycznie otrzyma również wiadomość e-mail z takim linkiem. Tym samym kupujący otrzymuje możliwość skutecznego opłacenia zamówienia, nawet jeśli pierwsza płatność była nieudana (np. brak środków na karcie, problemy z logowaniem do banku itp.).

### Zapisywanie kart

[](#zapisywanie-kart)

Zapisywanie kart pozwala zalogowanym użytkownikom zapamiętać kartę na poczet przyszłych płatności. Każda zapisana karta jest "tokenizowana", przy czym Magento w żaden sposób nie przetwarza pełnych danych karty (podawane są one na wlanym widgecie hostowanym przez PayU), ani nie zapisuje w swojej bazie tokenów kartowych (przed użyciem, aktualne tokeny dla danego użytkownika są zawsze pobierane z PayU).

W celu prawidłowego działania usługi konieczna jest dodatkowa konfiguracja w PayU, polegająca na umożliwieniu tworzenia i pobierania tokenów. Dodatkowo, można również ustalić zasady uwierzytelniania płatności zapisaną kartą (domyślnie każda płatność zapisaną karta wymaga podania kodu CVV i uwierzytelnieniu przez 3DS, ale można np. ustalić próg kwoty transakcji dla jakiego nie będzie to konieczne).

Kupujący może zapisać kartę podczas płatności, korzystając z opcji "Użyj i zapisz" na widgecie PayU podczas podawania danych karty. Każda zapisywana karta podlega silnemu uwierzytelnieniu przy pierwszej płatności (CVV i 3DS). Zapisana karta będzie pokazywać się po wybraniu płatności kartą przez PayU za zamówienie i jest widoczna w koncie użytkownika (zakładka "Moje zapisane karty"), gdzie jest również dostępna opcja jej usunięcia.

### Przewalutowanie

[](#przewalutowanie)

Przewalutowanie, inaczej Multi-Currency Pricing (MCP), daje możliwość obciążania kart użytkowników w walucie innej niż waluta rozliczeniowa z PayU. Przykładowo, można obciażyć kartę w EUR, ale otrzymać PLN od PayU. Przewalutowanie opiera się o funkcjonalność Magento, która dla sklepu pozwala dla "store-view" zdefiniować "display currency" różną od "base currency". Ta opcja jest wygodniejsza dla kupującego niż DCC (Dynamic Currency Conversion), gdyż cena w walucie jego karty pokazana jest na poszczególnych produktach i pozwala łatwiej podjąć decyzję o zakupie (w przypadku DCC kwota w walucie znana jest dopiero po rozpoczęciu płatności). W celu uruchomienia tej usługi należy:

- uzyskać parametr mcpPartnerId z PayU (pozwala pobierać tabele kursowe z PayU z odpowiednimi parami walutowymi),
- skonfigurować cykliczne pobieranie tabel kursowych z PayU w Magento. W celu uruchomienia i konfiguracji usługi należy skontaktować się z opiekunem handlowym w PayU.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor2

2 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

Unknown

Total

1

Last Release

1560d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9f7bd905950eddb2340a8e9038e8c43511493728e136fda67873e4849f0d0c7d?d=identicon)[KluseG](/maintainers/KluseG)

---

Top Contributors

[![regdos](https://avatars.githubusercontent.com/u/4245011?v=4)](https://github.com/regdos "regdos (12 commits)")[![KluseG](https://avatars.githubusercontent.com/u/26159164?v=4)](https://github.com/KluseG "KluseG (11 commits)")[![gabriel-woronowicz-payu-gpo](https://avatars.githubusercontent.com/u/41322012?v=4)](https://github.com/gabriel-woronowicz-payu-gpo "gabriel-woronowicz-payu-gpo (8 commits)")[![mattkrupnik](https://avatars.githubusercontent.com/u/2877143?v=4)](https://github.com/mattkrupnik "mattkrupnik (1 commits)")

---

Tags

payment processingpayupayment-modulepayu magento 2.4 modulepayu magento 2.4blik payment

### Embed Badge

![Health badge](/badges/kluseg-magento-23-payu-configurable/health.svg)

```
[![Health](https://phpackages.com/badges/kluseg-magento-23-payu-configurable/health.svg)](https://phpackages.com/packages/kluseg-magento-23-payu-configurable)
```

###  Alternatives

[iyzico/iyzipay-php

iyzipay api php client

3271.1M27](/packages/iyzico-iyzipay-php)[cybersource/rest-client-php

Client SDK for CyberSource REST APIs

39881.3k6](/packages/cybersource-rest-client-php)[omise/omise-php

A PHP library designed specifically to connect with Omise API.

71478.0k6](/packages/omise-omise-php)[sumup/sumup-ecom-php-sdk

SumUp PHP SDK

51277.1k1](/packages/sumup-sumup-ecom-php-sdk)[payu/magento2-payment-gateway

Official PayU integration plugin for Magento 2

1726.7k](/packages/payu-magento2-payment-gateway)[tzsk/payu

PayU India Payment Gateway Integration with Laravel

47108.8k6](/packages/tzsk-payu)

PHPackages © 2026

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