PayU Payment Gateway for Magento 2.4
payu/magento24-payment-gateway
Integrates PayU payment gateway with Magento 2. It allows customers to pay via PayU using various methods, including card payments and saved cards.
Build Tests
Code Quality
Tested on Magento 2.4.8-p4
Recent Test History
Each release is tested against the latest Magento version at that time.
Top Contributors
View Leaderboard
Share This Module's Status
README
Loaded from GitHubModuł 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
Spis treści
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
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/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
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
This content is fetched directly from the module's GitHub repository. We are not the authors of this content and take no responsibility for its accuracy, completeness, or any consequences arising from its use.