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.8(1w ago)7426.9k↓38.7%5[4 issues](https://github.com/PayU-EMEA/plugin_magento_24/issues)[1 PRs](https://github.com/PayU-EMEA/plugin_magento_24/pulls)1apache-2.0PHPPHP >=7.4 Since Aug 20Pushed 3d 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 3d ago READMEChangelog (10)Dependencies (4)Versions (32)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` Po instalacji 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 58 — FairBetter than 98% of packages Maintenance87 Actively maintained with recent releases Popularity43 Moderate usage in the ecosystem Community21 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 83.1% 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 ~101 days Recently: every ~155 days Total 22 Last Release 11d 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 (64 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)")[![hostep](https://avatars.githubusercontent.com/u/85479?v=4)](https://github.com/hostep "hostep (2 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)")[![Tomasz-Silpion](https://avatars.githubusercontent.com/u/5328659?v=4)](https://github.com/Tomasz-Silpion "Tomasz-Silpion (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 [cybersource/rest-client-php Client SDK for CyberSource REST APIs 40952.8k6](/packages/cybersource-rest-client-php)[paynl/magento2-plugin Pay. Payment methods for Magento 2 31329.9k6](/packages/paynl-magento2-plugin)[buckaroo/magento2 Buckaroo Magento 2 extension 32420.3k8](/packages/buckaroo-magento2)[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)