English version

Moduł PayU dla Magento 2 w wersji 2.3

Moduł jest wydawany na licencji GPL.

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.4 proszę skorzystać z pluginu dla wersji 2.4

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
   • Przewalutowanie

Cechy

Moduł płatności PayU dodaje do Magento 2 opcję płatności PayU. Moduł współpracuje z Magento 2 w wersji 2.3

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/magento23-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

Główne parametry

Parametry punktu płatności (POS)

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

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

Inne parametry

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.

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.