Moduł SimPay umożliwia realizację płatności online w sklepach opartych o PrestaShop 8/9.
Integracja jest w pełni osadzona w ścieżce zakupowej, a dodatkowo zapewnia podgląd i obsługę płatności z poziomu panelu zamówienia w Back Office.
- Cechy
- Wymagania
- Instalacja
- Aktualizacja
- Konfiguracja
- Back Office – transakcje, zwroty i logi
- Logi i diagnostyka
- Znane problemy
- Wsparcie
Moduł dodaje do PrestaShop obsługę płatności SimPay oraz umożliwia m.in.:
- płatności osadzone w ścieżce zamówienia (checkout),
- prezentację dostępnych metod płatności w sklepie,
- możliwość włączania i wyłączania metod płatności oraz ustawiania ich kolejności,
- konfigurację dwóch niezależnych list metod: w ramach głównej płatności SimPay oraz jako osobne metody płatności,
- automatyczne ukrywanie metod niedostępnych dla aktualnej kwoty koszyka (limity
min/maxkanału), - tryb testowy i produkcyjny,
- system logów i narzędzi diagnostycznych,
- podgląd statusu wszystkich transakcji powiązanych z zamówieniem w panelu administracyjnym (Back Office),
- trzy sposoby ponawiania płatności: w szczegółach zamówienia w panelu klienta, poprzez link w mailu potwierdzającym zamówienie oraz poprzez link w mailu o wygaśnięciu płatności (jeśli opcja jest włączona),
- mechanizm sprawdzania dostępności aktualizacji modułu (powiadomienie w Back Office + link do pobrania),
- płatność BLIK 0 – klient pozostaje na stronie koszyka sklepu i wpisuje 6-cyfrowy kod BLIK wygenerowany w aplikacji mobilnej banku.
- obsługę multisklepu (multi-store) – konfiguracja modułu jest niezależna dla każdego sklepu, a ustawienia metod płatności są zapisywane osobno.
- możliwość wykonywania zwrotów pełnych i częściowych bezpośrednio z poziomu szczegółów zamówienia w Back Office.
- Minimalna wersja PrestaShop: 8.0
- PHP: zgodne z wymaganiami Twojej wersji PrestaShop
- Włączona możliwość instalacji modułów (BO)
- Dostęp do panelu SimPay w celu pobrania danych integracyjnych
⚠️ Uwaga dotycząca bezpieczeństwa
Moduł SimPay nie wspiera wersji PrestaShop niższych niż 8.0.Starsze wersje PrestaShop (1.6 / 1.7) zawierają liczne znane luki bezpieczeństwa,
niezałatane podatności oraz mechanizmy umożliwiające obejście zabezpieczeń
(m.in. backdoory, podatne endpointy i przestarzałe zależności).Z uwagi na charakter modułu (obsługa płatności i danych transakcyjnych),
świadomie ograniczamy wsparcie wyłącznie do PrestaShop 8.x i nowszych,
aby zapewnić odpowiedni poziom bezpieczeństwa, stabilności i zgodności z aktualnymi standardami.
- Pobierz najnowszą paczkę modułu
simpay_prestashop_X.Y.Z.zipz sekcji Releases. - Zaloguj się do panelu administracyjnego PrestaShop:
http(s)://twoja-domena.pl/nazwa_katalogu_admina - Przejdź do: Moduły → Menedżer modułów (lub Moduły i usługi).
- Kliknij Dodaj nowy moduł i wskaż plik
.zip. - Kliknij Prześlij moduł / Załaduj moduł.
- Po instalacji kliknij Konfiguruj.
- Pobierz paczkę
.zipz sekcji Releases. - Rozpakuj archiwum.
- Skopiuj katalog modułu do:
modules/simpay/ - W panelu PrestaShop przejdź do Menedżera modułów i zainstaluj moduł.
- Zaktualizuj moduł tak samo jak w sekcji Instalacja (wgrywasz nową paczkę
.zip). - W panelu przejdź do: Parametry zaawansowane → Wydajność i kliknij Wyczyść pamięć podręczną.
- Jeśli moduł informuje o aktualizacji w BO – możesz przejść linkiem do pobrania najnowszej wersji.
Moduł sprawdza dostępność aktualizacji z cache (np. 1h). Jeśli endpoint aktualizacji jest niedostępny, powiadomienie nie będzie wyświetlane.
W konfiguracji modułu uzupełnij dane otrzymane z panelu SimPay:
- Hasło API (Bearer Token)
- ID usługi
- Klucz sygnatury IPN
W panelu SimPay dodaj adres do komunikacji IPN:
https://twoja-domena.pl/module/simpay/notify
Upewnij się, że sklep działa po HTTPS oraz że adres URL jest publicznie dostępny (bez basic auth).
Jeśli środowisko DEV jest zabezpieczone, użyj tunelu (np. Cloudflare Tunnel / ngrok) lub whitelisty IP, jeśli jest wspierana.
Moduł umożliwia pełną kontrolę nad metodami płatności wyświetlanymi klientowi w procesie zakupowym.
W konfiguracji możesz:
- włączyć lub wyłączyć wyświetlanie metod w ramach głównej opcji SimPay,
- włączyć lub wyłączyć wyświetlanie wybranych metod jako osobne opcje płatności,
- wybierać, które metody mają być widoczne w każdej z tych sekcji,
- ustalać kolejność metod płatności metodą „przeciągnij i upuść” (drag & drop),
- odświeżyć listę kanałów płatności pobieraną z panelu SimPay.
Konfiguracja odbywa się w dwóch niezależnych blokach:
- Metody płatności w ramach głównej opcji SimPay
- Metody płatności wyświetlane jako osobne opcje
W każdym bloku dostępne są dwie listy:
- Wszystkie metody płatności – lista metod dostępnych w SimPay,
- Wybrane metody – metody, które będą widoczne dla klientów w sklepie.
Listy są widoczne dopiero po włączeniu odpowiedniego przełącznika dla danego bloku.
Jeśli dana metoda płatności nie jest dostępna na liście, należy dodać ją i aktywować w panelu SimPay w sekcji Kanały płatności.
W sekcji osobnych metod kanał transfer jest celowo wykluczony i nie może być dodany jako odrębna metoda.
Dodatkowo, metody płatności są automatycznie filtrowane w checkout na podstawie wartości koszyka (z dostawą) i limitów kanału amounts.min / amounts.max.
Dodatkowo moduł pozwala na:
- wyświetlanie BLIK w formie widżetu,
- włączanie lub wyłączanie ponawiania płatności.
Moduł obsługuje dwa tryby pracy:
- Tryb testowy – umożliwia sprawdzenie poprawności integracji bez realizowania rzeczywistych transakcji,
- Tryb produkcyjny – płatności są realizowane w środowisku produkcyjnym SimPay.
Zmiana trybu nie wymaga ponownej instalacji modułu.
Jeżeli funkcja ponawiania płatności jest włączona, moduł umożliwia tworzenie wielu prób płatności dla jednego zamówienia.
Ponowienie płatności może zostać zainicjowane:
- z poziomu szczegółów zamówienia w panelu klienta,
- poprzez link zawarty w mailu potwierdzającym zamówienie,
- poprzez link w mailu o wygaśnięciu płatności (jeśli opcja jest włączona).
Każda próba płatności jest zapisywana jako osobna transakcja, a jej przebieg i status są widoczne zarówno w zakładce Płatności, jak i w Logach.
W widoku szczegółów zamówienia moduł dodaje sekcję Płatności SimPay, która umożliwia pełny wgląd w przebieg procesu płatności bez opuszczania panelu administracyjnego PrestaShop.
Sekcja została podzielona na dwie zakładki: Płatności oraz Logi.
Zakładka Płatności prezentuje wszystkie próby płatności powiązane z danym zamówieniem.
Dla każdej płatności wyświetlane są m.in.:
- data i godzina utworzenia transakcji,
- metoda płatności (np. BLIK),
- ID transakcji w SimPay,
- aktualny status transakcji (np.
transaction_expired), - informacja, czy dana próba płatności jest aktywna.
Uwaga: w danym momencie aktywna może być tylko jedna transakcja – zawsze jest to ostatnia (najbardziej aktualna) próba płatności.
Poprzednie oraz opłacone już transakcje są automatycznie oznaczane jako nieaktywne.
Dzięki temu możliwe jest szybkie sprawdzenie:
- ile prób płatności zostało wykonanych,
- która transakcja jest aktualna,
- czy płatność została zakończona, wygasła lub nie powiodła się.
Zakładka Zwroty wyświetla listę aktualnych zwrotów i umożliwia realizację zwrotów bezpośrednio z poziomu szczegółów zamówienia w Back Office.
Zwrot można utworzyć:
- jako zwrot pełny (całość opłaconej kwoty),
- jako zwrot częściowy (dowolna kwota nieprzekraczająca dostępnego salda do zwrotu).
Po utworzeniu zwrotu:
- operacja jest wysyłana do API SimPay,
- zwrot zostaje zapisany w systemie,
- jego status jest widoczny w tej samej zakładce w liście zwrotów.
Zwrot może zostać wykonany wyłącznie wtedy, gdy:
- istnieje opłacona transakcja powiązana z zamówieniem,
- suma wszystkich dotychczasowych zwrotów nie przekracza wartości zamówienia,
- transakcja znajduje się w stanie umożliwiającym wykonanie zwrotu po stronie SimPay.
Jeśli którykolwiek z warunków nie jest spełniony, moduł uniemożliwi utworzenie zwrotu.
Zakładka Logi zawiera szczegółową historię zdarzeń związanych z obsługą płatności SimPay dla danego zamówienia.
Wyświetlane informacje obejmują m.in.:
- datę i godzinę zdarzenia,
- poziom logu (np.
info,resp), - opis zdarzenia (np. rozpoczęcie płatności, ponowienie płatności, zmiana statusu),
- kontekst techniczny zdarzenia (ID zamówienia, ID transakcji, statusy, typ zdarzenia).
Logi obejmują cały przebieg procesu, w tym:
- rozpoczęcie płatności,
- ponowienie płatności przez klienta,
- odebrane powiadomienia IPN / webhook,
- zmiany statusów transakcji,
- decyzje modułu (np. oznaczenie próby jako nieaktywnej),
- aktualizację statusu zamówienia w PrestaShop.
Zakładka ta jest szczególnie pomocna przy diagnostyce problemów oraz weryfikacji poprawności komunikacji z API SimPay.
- Moduły One Page Checkout (OPC) mogą modyfikować checkout i wpływać na wyświetlanie metod płatności.
W razie problemów przetestuj na domyślnym checkout PrestaShop lub skontaktuj się z dostawcą OPC. - Jeśli sklep ma basic auth na środowisku testowym – webhooki mogą nie dochodzić.
Masz pytania lub chcesz zgłosić błąd?
- Utwórz zgłoszenie w zakładce Issues w tym repozytorium (zalecane).
- Dołącz:
- wersję PrestaShop,
- wersję PHP,
- wersję modułu,
- fragment logów (bez danych wrażliwych),
- kroki odtworzenia problemu.