English version

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

Spis treści

1. Cechy
2. Wymagania
3. Instalacja
4. Konfiguracja
   • Parametry
5. Informacje o cechach
   • Kolejność metod płatności
   • Ponowienie płatności
   • Zapisywanie kart

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

1. Pobierz najnowszą wersję moduł z repozytorium GitHub
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

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