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
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ą
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
composer require payu/magento24-payment-gateway
- 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/PaymentGatewayswojego 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
- 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.
| 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 |
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 |
| 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 |
| 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 |
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.
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 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.