English version

Moduł PayU dla PrestaShop 1.6 i 1.7

Moduł jest wydawany na licencji GPL.

Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym wsparciem technicznym.

Uwaga: plugin w wersji 2.x wspiera PrestaShop w wersji 1.4 i 1.5, ale nie jest dalej rozwijany.

Spis treści

• Cechy i kompatybilność
• Wymagania
• Instalacja
• Aktualizacja
• Konfiguracja
• Więcej o cechach
  • Wielowalutowość
  • Wyświetlenie metod płatności
  • Płatność kartą
  • Płatność kartą - widżet
  • Ponowienie płatności
  • Promowanie płatności ratalnych i odroczonych

Cechy i kompatybilność

Moduł płatności PayU dodaje do PrestaShop opcję płatności PayU i pozwala na następujące operacje:

Plugin w wersji 3.x wspiera PrestaShop w wersji 1.6 i 1.7

Cecha	PrestaShop 1.6	PrestaShop 1.7
Utworzenie płatności (wraz z rabatami)	✅	✅
Odebranie lub odrzucenie płatności (w przypadku wyłączonego autoodbioru)	✅	✅
Utworzenie zwrotu (pełnego lub częściowego)	✅	✅
Wyświetlenie metod płatności i wybranie metody na stronie podsumowania zamówienia	✅	✅
Płatność kartą jako osobna metoda płatności	✅	✅
Płatność kartą jako widżet na stronie podsumowania zamówienia	✅	✅
Ponowienie płatności przez klienta w przypadku anulowania	✅	✅
Wielowalutowość	✅	✅
Kolejność metod płatności	✅	✅
Promowanie PayU Raty i PayU Płacę Później	✅	✅
Prezentacja kalkulacji ratalnej przy produkcie i listingu	✅	✅
Prezentacja kalkulacji ratalnej na podsumowaniu	✅	✅
Prezentacja kalkulacji ratalnej w koszyku	❌	✅

Więcej informacji o cechach można znaleźć w rozdziale Więcej o cechach

Wszyskie opisy w tej instrukcji odnoszą się do PrestaShop 1.6, w wersji 1.7 należy używać opcji analogicznych.

Wymagania

Ważne: Moduł 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

Do prawidłowego funkcjonowania modułu wymagane są następujące rozszerzenia PHP: cURL i hash.

Instalacja

Opcja 1

przeznaczona dla użytkowników bez dostępu poprzez FTP do instalacji PrestaShop

1. Pobierz moduł z repozytorium GitHub jako plik zip
2. Rozpakuj pobrany plik
3. Utwórz archiwum zip z katalogu payu
4. Przejdź do strony administracyjnej swojego sklepu PrestaShop [http://adres-sklepu/adminxxx].
5. Przejdź do Moduły » Moduły i usługi
6. Naciśnij przycisk Dodaj nowy moduł i wybierz plik z archiwum modułu (utworzonej w punkcie 3)
7. Naciśnij przycisk Prześlij moduł

Opcja 2

przeznaczona dla użytkowników z dostępem poprzez FTP do instalacji PrestaShop

1. Pobierz moduł z repozytorium GitHub jako plik zip
2. Rozpakuj pobrany plik
3. Połącz się z serwerem ftp i skopiuj katalog payu z rozpakowanego pliku do katalogu modules swojego sklepu PrestaShop

Aktualizacja

1. Zaktualizuj plik modułu zgodnie z punktem Instalacja
2. Przejdź do Moduły » Moduły i usługi - zostanie przeprowadzona automatyczna aktualizacja modułu jeżeli jest wymagana
3. Przejdź do Parametry zaawansowane » Wydajność i naciśnij przycisk Wyczyść pamięć podręczną

Konfiguracja

1. Przejdź do strony administracyjnej swojego sklepu PrestaShop [http://adres-sklepu/adminxxx].
2. Przejdź do Moduły » Moduły i usługi
3. Wyszukaj PayU i naciśnij Konfiguruj

Sposób integracji

Parameter	Opis
Wyświetlaj metody płatności na stronie podsumowania zamówienia w PrestaShop	Tak - metody płatności zostaną wyświetlone na stronie podsumowania zamówienia w PrestaShop Nie - po złożeniu zamówienia w PrestaShop nastąpi automatyczne przekierowanie do PayU
Płatność kartą jako osobna metoda płatności	Określa czy płatność kartą będzie dostępna jako osobna metoda więcej informacji
Płatność kartą w widżecie	Określa czy płatność kartą będzie dostępna jako widżet więcej informacji
Kolejność metod płatności	Określa kolejność wyświetlanych metod płatności więcej informacji
Tryb testowy (Sandbox)	Tak - transakcje będą procesowane przez system Sandbox PayU Nie - transakcje będą procesowane przez system produkcyjny PayU

Parametry POS-ów

Dla każdej waluty dodanej w PrestaShop należy dodać parametry (osobno dla środowiska produkcyjnego i sandbox):

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

Statusy płatności

Mapowanie statusów płatności w PayU na statusy w skepie PrestaShop

Nazwa	Status w PayU	Domyślny status w Presta
Rozpoczęta	NEW i PENDING	Płatność PayU rozpoczęta
Oczekuje na odbiór	WAITING_FOR_CONFIRMATION i REJECTED	Płatność PayU oczekuje na odbiór
Zakończona	COMPLETED	Płatność zaakceptowana
Anulowana	CANCELED	Płatność PayU anulowana

W przypadku włączenia opcji Kontrola zmiany statusów dla statusów "Zakończona" i "Anulowana" możliwe jest przejście tylko ze statusów "Rozpoczęta" i "Oczekuje na odbiór"

Więcej o cechach

Kolejność metod płatności

Ma zastosowanie tylko przy ustawionej opcji Wyświetlaj metody płatności na stronie podsumowania zamówienia w PrestaShop na Tak

W celu ustalenia kolejności wyświetlanych ikon metod płatności należy podać symbole metod płatności oddzielając je przecinkiem. Lista metod płatności.

Wielowalutowość

POS w systemie PayU ma jedną walutę. Jeżeli chcemy akceptować płatność w sklepie PrestaShop w wielu walutach niezbędne jest dodanie konfiguracji POSa dla każdej waluty z osobna.

Wyświetlenie metod płatności

Przy ustawionej opcji Wyświetlaj metody płatności na stronie podsumowania zamówienia w PrestaShop na Tak po wybraniu płatności przez PayU wyświetli się strona z ikonami banków bezpośrednio w sklepie PrestaShop. Ikony banków, które są wyświetlane pobierane są z konfiguracji POS-a w PayU w zależności od wybranej waluty.

Płatność kartą

Przy ustawionej opcji Płatność kartą jako osobna metoda płatności na liście metod płatności w procesie zakupowym Prestashop wyświetli się jako osobna metoda o nazwie Zapłać kartą.

Jeżeli Wyświetlaj metody płatności na stronie podsumowania zamówienia w PrestaShop jest ustawione na Tak to metoda Zapłać kartą będzie wyświetlana jeżeli na POS-ie jest dostępna płatnośc kartą. W przeciwnym wypadku metoda Zapłać kartą kartą będzie wyświetlana zawsze ale jeżeli na POS-ie brak jest metody płatnoś kartą to wtedy płatność się nie powiedzie.

Widżet do płatności kartą

WAŻNE - do prawidłowego działania niezbędne jest włączenie tokenizacji w konfiguracji POS-a. W tym celu należy się skontaktować z naszym wsparciem technicznym.

Przy ustawionej opcji Płatność kartą jako osobna metoda płatności oraz Płatność kartą jako widżet na stronie podsumowania zamówienia na Tak po wybraniu płatności Zapłać kartą zamiast przekierowania do PayU pojawi się widżet do wprowadzenia danych karty.

Ponowienie płatności

W przypadku nieudanej płatności w PayU możliwe jest ponowienie takiej płatności samodzielnie przez kupującego.

Żeby kupujący mógł ponowić płatność muszą być spełnione następujące warunki:

• status ostatniej płatności z PayU musi mieć status CANCELED
• status zamówienia w PrestaShop musi być zgodny ze statusem wybranym w konfiguracji wtyczki Statusy płatności » Anulowana

Kupującemu w Szczegółach zamówienia wyświetlany jest przycisk Ponów płatność z PayU.

W panelu administracyjnym w szczegółach zamówienia wyświetlane są wszystkie utworzone płatności w PayU wraz ze statusami.

Promowanie płatności ratalnych i odroczonych

Od wersji 3.0.10 plugin udostępnia opcję promowania płatności ratalnych i odroczonych. Funkcjonalność jest domyślnie włączona. Można ją dezaktywować poprzez przełącznik "Promuj płatności ratalne" w panelu admińskim. Wsparcie dla konkretnych funkcjonalności przedstawione zostało w tabeli Cechy i Kompatybilność.

Prezentacja kalkulacji zależna jest od dostępności bramek "ai" oraz "dp" na danym punkcie płatności i sprawdzana jest automatycznie przez plugin. Jeśli na punkcie płatności nie zostały aktywowane Raty PayU kalkulacja nie zostanie zaprezentowana pomimo włączonej opcji w pluginie.

Prezentacja kalkulacji w zależności od wersji PrestaShop

Wersja PrestaShop	Kategoria	Prezentacja
1.7	Listing produktów
1.7	Karta produktu
1.7	Koszyk
1.7	Wybór metody płatności PayU Raty
1.7	Wybór metody płatności PayU Płacę później
1.6	Listing produktów
1.6	Karta produktu
1.6	Wybór metody płatności

Prezentacja kalkulacji po kliknięciu w link "Rata już od:"

Plugin do kalkulacji kredytu używa najnowszej wersji elementu "miniratka" wchodzącego w skład pakietu PayU Raty - dobre praktyki, który znajduje się w oficjalnej dokumentacji technicznej.

Do prezentacji okna informacyjnego o PayU Płacę Później wykorzystywany jest Widget Płacę Później.

Widget z kalkulacją ratalną wygląda następująco: