PHPackages payu/magento2-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. payu/magento2-payment-gateway ActiveMagento2-module payu/magento2-payment-gateway ============================= Official PayU integration plugin for Magento 2 1.3.1(5y ago)1726.7k13[4 issues](https://github.com/PayU-EMEA/plugin_magento_2/issues)[1 PRs](https://github.com/PayU-EMEA/plugin_magento_2/pulls)OSL-3.0PHPPHP ~5.5.0|~5.6.0|~7.0.0|~7.1.0|~7.2.0 Since Dec 7Pushed 5y ago12 watchersCompare [ Source](https://github.com/PayU-EMEA/plugin_magento_2)[ Packagist](https://packagist.org/packages/payu/magento2-payment-gateway)[ RSS](/packages/payu-magento2-payment-gateway/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (18)Used By (0) Moduł PayU dla Magento 2 w wersji >2.0.6, 2.1, 2.2 ===================================================== [](#moduł-payu-dla-magento-2-w-wersji-206-21-22) `Moduł jest wydawany na licencji GPL.` **Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym [wsparciem technicznym](https://www.payu.pl/pomoc).** - 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) - Jeżeli używasz Magneto w wersji 2.4 proszę skorzystać z [pluginu dla wersji 2.4](https://github.com/PayU-EMEA/plugin_magento_24) - Jeżeli używasz Magneto w wersji 1.x proszę skorzystać z [pluginu dla wersji 1.x](https://github.com/PayU-EMEA/plugin_magento_160) Spis treści ----------- [](#spis-treści) 1. [Cechy](#cechy) 2. [Wymagania](#wymagania) 3. [Instalacja](#instalacja) 4. [Aktualizacja](#aktualizacja) 5. [Konfiguracja](#konfiguracja) - [Parametry](#parametry) 6. [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 wersjach: >2.0.6, 2.1, 2.2 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/magento2-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_2/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 Aktualizacja ------------ [](#aktualizacja) Aktualizując plugin z wersji starszej niż 1.2.0 należy po aktualizacji pluginu ponownie podać i zapisać konfigurację POS-ów. 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ć **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 37 — LowBetter than 83% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity32 Limited adoption so far Community21 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 86.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 ~84 days Recently: every ~155 days Total 14 Last Release 1981d ago PHP version history (2 changes)1.1.0PHP ~5.5.0|~5.6.0|~7.0.0|~7.1.0 1.2.5PHP ~5.5.0|~5.6.0|~7.0.0|~7.1.0|~7.2.0 ### 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 (62 commits)")[![gabriel-woronowicz-payu-gpo](https://avatars.githubusercontent.com/u/41322012?v=4)](https://github.com/gabriel-woronowicz-payu-gpo "gabriel-woronowicz-payu-gpo (4 commits)")[![bukos](https://avatars.githubusercontent.com/u/48085974?v=4)](https://github.com/bukos "bukos (2 commits)")[![mattkrupnik](https://avatars.githubusercontent.com/u/2877143?v=4)](https://github.com/mattkrupnik "mattkrupnik (1 commits)")[![jemoon](https://avatars.githubusercontent.com/u/3430741?v=4)](https://github.com/jemoon "jemoon (1 commits)")[![fwc-mb](https://avatars.githubusercontent.com/u/59438880?v=4)](https://github.com/fwc-mb "fwc-mb (1 commits)")[![lukasz-grzesiak-payu-gpo](https://avatars.githubusercontent.com/u/14938591?v=4)](https://github.com/lukasz-grzesiak-payu-gpo "lukasz-grzesiak-payu-gpo (1 commits)") --- Tags payment processingpayupayment-modulepayu easy and plus merchantpayu magento 2 modulepayu magento 2 ### Embed Badge ![Health badge](/badges/payu-magento2-payment-gateway/health.svg) ``` [![Health](https://phpackages.com/badges/payu-magento2-payment-gateway/health.svg)](https://phpackages.com/packages/payu-magento2-payment-gateway) ``` ### Alternatives [mollie/magento2 Mollie Payment Module for Magento 2 1121.6M10](/packages/mollie-magento2)[dotdigital/dotdigital-magento2-extension Dotdigital for Magento 2 50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[pagbank/payment-magento PagBank - Payment for Magento and Adobe 2128.3k7](/packages/pagbank-payment-magento)[o2ti/sigep-web-carrier O2TI - Sigep Web Carrier 141.5k](/packages/o2ti-sigep-web-carrier) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)