Moduł PayU dla Magento 2 w wersji 2.4

UWAGA

W związku ze zmianami opisanymy w CHANGELOG 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: tech@payu.pl.

Jeżeli używasz Magneto w wersji 1.x proszę skorzystać z pluginu dla wersji 1.x
Jeżeli używasz Magneto w wersji >2.0.6, 2.1, 2.2 proszę skorzystać z pluginu dla wersji >2.0.6, 2.1, 2.2
Jeżeli używasz Magneto w wersji 2.3 proszę skorzystać z pluginu dla wersji 2.3

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:

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

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 lub zarejestruj się w systemie sandbox

Wersja PHP zgodna z wymaganiami zainstalowanej wersji Magento 2
Rozszerzenia PHP: cURL i hash.

Instalacja

Przy użyciu Composer

composer require payu/magento24-payment-gateway

Kopiując pliki na serwer

Pobierz najnowszą wersję moduł z repozytorium GitHub
Rozpakuj pobrany plik
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

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

Parametry API

Parametry punktu płatności (POS)

Parameter	Opis
Id punktu płatności	Identyfikator POS-a z systemu PayU
Drugi klucz MD5	Drugi klucz MD5 z systemu PayU
OAuth - client_id	client_id dla protokołu OAuth z systemu PayU
OAuth - client_secret	client_secret for OAuth z systemu PayU

Parametry punktu płatności (POS) - Tryb testowy (Sandbox)

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

Parameter	Opis
Id punktu płatności	Identyfikator POS-a z systemu PayU
Drugi klucz MD5	Drugi klucz MD5 z systemu PayU
OAuth - client_id	client_id dla protokołu OAuth z systemu PayU
OAuth - client_secret	client_secret for OAuth z systemu PayU

Parametry płatności

Parameter	Opis
Czy włączyć wtyczkę?	Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.
Tryb Sandbox	Określa czy płatności będą realizowane na środowisku testowym (sandbox) PayU.
Kolejność metod płatności	Określa kolejnośc wyświetlanych metod płatności więcej informacji.
Czy uaktywnić ponowienie płatności?	więcej informacji

Parametry płatności "PayU - Karty"

Parameter	Opis
Czy włączyć wtyczkę?	Określa czy metoda płatności będzie dostępna w sklepie na liście płatności.
Tryb Sandbox	Określa czy płatności będą realizowane na środowisku testowym (sandbox) PayU.
Czy uaktywnić ponowienie płatności?	więcej informacji
Czy uaktywnić zapisywanie kart?	więcej informacji

Informacje o cechach

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.

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 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.

PayU-EMEA/plugin_magento_24