README

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 Magento w wersji 1.x proszę skorzystać z pluginu dla wersji 1.x
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
Jeżeli używasz Magento 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)
Promowanie płatności kredytowych wykorzystując 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

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ć właściwą sekcję z listy metod PayU w celu konfiguracji parametrów wtyczki.
Po zmanie paramettrów naciśnij przycisk Save config.

Parametry API

Parameter	Opis
Tryb 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)

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 wtyczki "PayU - widget kredytowy"

Parameter	Opis
Wyświetl widget kredytowy przy produktach	Wartość `Tak`\|`Nie`. Wyświetla widget na stronach produktu
Wyświetl widget kredytowy w katalogu produktów	Wartość `Tak`\|`Nie`. Wyświetla widget na stronach z listą produktów (np. kategorie)
Wyświetl widget kredytowy w widgetach katalogu produktu np. bestseller, nowości	Wartość `Tak`\|`Nie`. Wyświetla widget na stronach z widgetami listami produktów (np. bestseller, nowości) Funkcja eksperymentalna
Wyświetl widget kredytowy w koszyku	Wartość `Tak`\|`Nie`. Wyświetla widget na stronie koszyka
Wyświetl widget kredytowy w mini koszyku	Wartość `Tak`\|`Nie`. Wyświetla widget na rozwijanej liście podsumowania koszyka
Wyświetl widget kredytowy w podsumowaniu koszyka	Wartość `Tak`\|`Nie`. Wyświetla widget na stronie podsumowania koszyka z wyborem metod płatności
Wyklucz metody płatności kredytowych z widgetu	Lista oddzielona przecinkami z metodami płatności, które mają zostać pominięte w trakcie prezentacji widgetu. Rekomenduje się pozostawienie pustej listy

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.
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
Pozycja na liście	Pozycja metody płatności na liście metod płatności

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.
Czy uaktywnić zapisywanie kart?	więcej informacji
Czy uaktywnić ponowienie płatności?	więcej informacji
Pozycja na liście	Pozycja 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"

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.
Czy uaktywnić ponowienie płatności?	więcej informacji
Pozycja na liście	Pozycja metody płatności na liście metod płatności

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.

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" pozwalają na elastyczne zarządzanie miejscami wyświetlania widgetu kredytowego.

Przykładowa prezentacja widgetu kredytowego

payu / magento24-payment-gateway

Maintainers

Details