Skip to content
master
Switch branches/tags
Go to file
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

README.md

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ść

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
Płatność Twisto jako osobna metoda płatności
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.

payment_methods

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.

payment_methods

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.

widget

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.

retry_payment

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 "dpt" 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 Promowanie płatności ratalnych
1.7 Wydzielenie Twisto jako metody płatności
1.6 Listing produktów
1.6 Karta produktu

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.

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