payu/magento2-payment-gateway

Official PayU integration plugin for Magento 2

Moduł PayU dla Magento 2 w wersji >2.0.6, 2.1, 2.2

Moduł jest wydawany na licencji GPL., _(*1)

Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym wsparciem technicznym., _(*2)

• Jeżeli używasz Magneto w wersji 2.3 proszę skorzystać z pluginu dla wersji 2.3
• Jeżeli używasz Magneto w wersji 2.4 proszę skorzystać z pluginu dla wersji 2.4
• Jeżeli używasz Magneto w wersji 1.x proszę skorzystać z pluginu dla wersji 1.x

Spis treści

1. Cechy
2. Wymagania
3. Instalacja
4. Aktualizacja
5. Konfiguracja
   • Parametry
6. 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 wersjach: >2.0.6, 2.1, 2.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), _(*4)

Moduł dodaje dwie metody płatności:, _(*5)

* 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ą, _(*6)

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][ext5], _(*7)

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

Instalacja

Przy użyciu Composer

composer require payu/magento2-payment-gateway, _(*8)

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, _(*9)

Aktualizacja

Aktualizując plugin z wersji starszej niż 1.2.0 należy po aktualizacji pluginu ponownie podać i zapisać konfigurację POS-ów., _(*10)

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., _(*11)

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., _(*12)

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., _(*13)

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.)., _(*14)

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)., _(*15)

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)., _(*16)

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., _(*17)

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., _(*18)

, _(*19)