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.0.6(2mo ago)6395.7k—9.4%5[15 issues](https://github.com/PayU-EMEA/plugin_magento_24/issues)[4 PRs](https://github.com/PayU-EMEA/plugin_magento_24/pulls)1apache-2.0PHPPHP >=7.4 Since Aug 20Pushed 2mo 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 1mo ago READMEChangelog (10)Dependencies (2)Versions (24)Used By (1) [**English version**](README.EN.md) Moduł PayU dla Magento 2 w wersji 2.4 ===================================== [](#moduł-payu-dla-magento-2-w-wersji-24) UWAGA ----- [](#uwaga) **W związku ze zmianami opisanymy w [CHANGELOG](CHANGELOG.md) po aktualizacji wtyczki z wersji 1.X na 2.X należy wykonać ponowną konfigurację wtyczki.** **Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym wsparciem pod adresem: .** - Jeżeli używasz Magento w wersji 1.x proszę skorzystać z [pluginu dla wersji 1.x](https://github.com/PayU-EMEA/plugin_magento) - Jeżeli używasz Magento w wersji >2.0.6, 2.1, 2.2 proszę skorzystać z [pluginu dla wersji >2.0.6, 2.1, 2.2](https://github.com/PayU-EMEA/plugin_magento_2) - Jeżeli używasz Magento 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) 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) - Promowanie płatności kredytowych wykorzystując [widget kredytowy](#widget-kredytowy) w różnych podstronach sklepu (np. na stronie produktu, w koszyku) Moduł dodaje następujące metody płatności: - **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ą - **PayU Raty** - płatności ratalne z przekierowaniem do formatki ratalnej PayU - **PayU Klarna** - odroczone płatności Klarna z przekierowaniem do formatki Klarna w PayU - **PayU PayPo** - odroczone płatności PayPo z przekierowaniem do formatki PayPo w PayU - **PayU PragmaPay** - odroczone płatności PragmaPay z przekierowaniem do formatki PragmaPay w PayU - **PayU Twisto** - odroczone płatności Twisto z przekierowaniem do formatki Twisto w PayU - **PayU Twisto podziel na 3** - odroczone płatności Twisto podziel na 3 z przekierowaniem do formatki Twisto podziel na 3 w PayU [![methods](readme_images/methods_pl.png)](readme_images/methods_pl.png) 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** > **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ć właściwą sekcję z listy metod **PayU** w celu konfiguracji parametrów wtyczki. 5. Po zmanie paramettrów naciśnij przycisk `Save config`. ### Parametry API [](#parametry-api) ParameterOpisTryb testowy (Sandbox)`Tak` - transakcje będą procesowane przez system Sandbox PayU. `Nie` - transakcje będą procesowane przez system produkcyjny PayU.#### 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### Parametry wtyczki "PayU - widget kredytowy" [](#parametry-wtyczki-payu---widget-kredytowy) ParameterOpisWyświetl widget kredytowy przy produktachWartość `Tak`|`Nie`. Wyświetla widget na stronach produktuWyświetl widget kredytowy w katalogu produktówWartość `Tak`|`Nie`. Wyświetla widget na stronach z listą produktów (np. kategorie)Wyświetl widget kredytowy w widgetach katalogu produktu np. bestseller, nowościWartość `Tak`|`Nie`. Wyświetla widget na stronach z widgetami listami produktów (np. bestseller, nowości) **Funkcja eksperymentalna**Wyświetl widget kredytowy w koszykuWartość `Tak`|`Nie`. Wyświetla widget na stronie koszykaWyświetl widget kredytowy w mini koszykuWartość `Tak`|`Nie`. Wyświetla widget na rozwijanej liście podsumowania koszykaWyświetl widget kredytowy w podsumowaniu koszykaWartość `Tak`|`Nie`. Wyświetla widget na stronie podsumowania koszyka z wyborem metod płatnościWyklucz metody płatności kredytowych z widgetuLista oddzielona przecinkami z [metodami płatności](https://developers.payu.com/europe/pl/docs/get-started/integration-overview/references/#installments-and-pay-later), które mają zostać pominięte w trakcie prezentacji widgetu. **Rekomenduje się pozostawienie pustej listy**### Parametry płatności [](#parametry-płatności) ParameterOpisCzy włączyć wtyczkę?Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.Kolejność metod płatnościOkreśla kolejnośc wyświetlanych metod płatności [więcej informacji](#kolejno%C5%9B%C4%87-metod-p%C5%82atno%C5%9Bci).Czy uaktywnić ponowienie płatności?[więcej informacji](#ponowienie-p%C5%82atno%C5%9Bci)Pozycja na liściePozycja metody płatności na liście metod płatności### Parametry płatności "PayU - Karty" [](#parametry-płatności-payu---karty) ParameterOpisCzy włączyć wtyczkę?Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.Czy uaktywnić zapisywanie kart?[więcej informacji](#zapisywanie-kart)Czy uaktywnić ponowienie płatności?[więcej informacji](#ponowienie-p%C5%82atno%C5%9Bci)Pozycja na liściePozycja metody płatności na liście metod płatności### Parametry płatności "PayU - Raty", "PayU - Klarna", "PayU - PayPo", "PayU - PragmaPay", "PayU - Twisto", "PayU - Twisto podziel na 3" [](#parametry-płatności-payu---raty--payu---klarna-payu---paypo-payu---pragmapay-payu---twisto-payu---twisto-podziel-na-3) ParameterOpisCzy włączyć wtyczkę?Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.Czy uaktywnić ponowienie płatności?[więcej informacji](#ponowienie-p%C5%82atno%C5%9Bci)Pozycja na liściePozycja metody płatności na liście metod płatnościInformacje 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. ### Widget kredytowy [](#widget-kredytowy) W celu poinformowania klienta o możliwościach płatności kredytowej dla konkretnego produktu, zalecamy umieszczenie widgetu kredytowego przy produktach w listach produktów, opisie (szczegółach) wybranego produktu, koszyku i przy finalizacji zamówienia (przed płatnością). Parametry konfiguracji opisane w sekcji [Parametry wtyczki "PayU - widget kredytowy"](#parametry-wtyczki-payu-widget-kredytowy) pozwalają na elastyczne zarządzanie miejscami wyświetlania widgetu kredytowego. Przykładowa prezentacja widgetu kredytowego [![widget](readme_images/widget_pl.png)](readme_images/widget_pl.png) ### Health Score 51 — FairBetter than 96% of packages Maintenance64 Regular maintenance activity Popularity42 Moderate usage in the ecosystem Community20 Small or concentrated contributor base Maturity64 Established project with proven stability Bus Factor1 Top contributor holds 85.5% 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 ~106 days Recently: every ~166 days Total 20 Last Release 82d ago Major Versions 1.0.12 → 2.0.02024-01-17 PHP version history (2 changes)1.0.0PHP >=7.3 2.0.2PHP >=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 (53 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 (2 commits)")[![dudzio12](https://avatars.githubusercontent.com/u/6281733?v=4)](https://github.com/dudzio12 "dudzio12 (1 commits)")[![jemoon](https://avatars.githubusercontent.com/u/3430741?v=4)](https://github.com/jemoon "jemoon (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 [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)