Jak dodać Przelewy24 do sklepu PrestaShop? Krok po kroku

Dowiesz się, jak przygotować sklep, zainstalować moduł, poprawnie go skonfigurować i przetestować płatności.

Jak dodać Przelewy24 do sklepu PrestaShop? To jedno z najczęstszych pytań sprzedawców, którzy chcą zaoferować klientom szybkie płatności BLIK, szybkie przelewy i karty w jednym miejscu. Dobra wiadomość: integracja jest prosta, jeśli wykonasz ją metodycznie. Poniżej znajdziesz praktyczny przewodnik, który przeprowadzi Cię przez cały proces — od przygotowania środowiska, przez instalację modułu, po testy i rozwiązywanie typowych problemów.

Wymagania i przygotowanie

Zanim zaczniesz, sprawdź wersję sklepu, załóż konto i przygotuj dane dostępowe.

Zanim przejdziesz do instalacji, przygotuj:

• Konto sprzedawcy w Przelewy24 (aktywne i zweryfikowane).
• Dane dostępowe: ID Sprzedawcy (Merchant ID), ID POS oraz Klucz CRC. Często potrzebny jest również klucz do API/REST. Znajdziesz je w panelu Przelewy24.
• Aktualną wersję PrestaShop (zalecane 1.7.x lub 8.x) i aktualne kopie zapasowe.
• Certyfikat SSL i działające HTTPS w sklepie. To kluczowe — Przelewy24 wymaga bezpiecznego połączenia.

Warto też sprawdzić, czy motyw i wtyczki są kompatybilne z Twoją wersją PrestaShop. Aktualizacja modułów przed integracją zmniejsza ryzyko konfliktów.

Rejestracja i konfiguracja w panelu Przelewy24

Uzupełnij dane firmy, aktywuj metody płatności i sprawdź tryb testowy.

• Załóż konto i przejdź proces weryfikacji (dane firmy, dokumenty).
• W panelu aktywuj interesujące metody: BLIK, szybkie przelewy, karty.
• Zanotuj: ID Sprzedawcy, ID POS, Klucz CRC oraz klucze API.
• Jeśli to pierwsza konfiguracja, włącz środowisko testowe (sandbox), by bezpiecznie przeprowadzić próby.

Instalacja oficjalnego modułu Przelewy24 w PrestaShop

Użyj oficjalnego dodatku, by zyskać wsparcie i automatyczne aktualizacje.

Najprościej skorzystać z oficjalnego modułu:

1. Zaloguj się do panelu PrestaShop i przejdź do Moduły > Menedżer modułów.
2. Wyszukaj „Przelewy24” i wybierz oficjalny moduł dostawcy.
3. Kliknij Zainstaluj i poczekaj, aż proces się zakończy.
4. Jeśli instalujesz z pliku .zip (np. z Addons Marketplace), skorzystaj z opcji Prześlij moduł i wskaż plik.

Po instalacji w liście modułów powinna pojawić się opcja Konfiguruj. Jeśli moduł prosi o uprawnienia lub aktualizację, wykonaj je od razu.

Konfiguracja modułu – klucze, waluty i tryb testowy

Wprowadź dane z panelu Przelewy24 i ustaw preferencje płatności.

W sekcji konfiguracji modułu uzupełnij:

• ID Sprzedawcy (Merchant ID)
• ID POS
• Klucz CRC (tzw. „Sól”)
• Klucze API/REST (jeśli moduł wymaga)

Następnie:

• Włącz Tryb testowy, jeśli chcesz wykonać próby bez realnych transakcji.
• Ustaw waluty. Najczęściej domyślna to PLN; dopilnuj, by waluta zamówienia była wspierana przez Przelewy24 i zgodna z ustawieniami konta.
• Zaznacz dostępne metody płatności dla klientów (BLIK, szybkie przelewy, karty).
• Skonfiguruj mapowanie statusów zamówień (np. „Płatność zaakceptowana” po udanej autoryzacji).

W wielu wersjach moduł automatycznie doda adresy powrotu i powiadomień. Zawsze zweryfikuj, czy są poprawne.

Adresy powrotu i powiadomień (webhook)

Zadbaj o poprawne potwierdzanie płatności i aktualizację statusów zamówień.

• Adres powrotu (return URL) kieruje klienta z Przelewy24 z powrotem do Twojego sklepu po płatności.
• Adres powiadomień (status/notification URL, tzw. webhook) służy do automatycznego potwierdzania płatności przez serwery Przelewy24.

Najczęściej moduł uzupełnia je automatycznie. Jeśli konfigurujesz ręcznie w panelu Przelewy24, skopiuj adresy z ustawień modułu w PrestaShop i wklej do panelu operatora. Bez poprawnych powiadomień status zamówienia może nie zmieniać się automatycznie, mimo że transakcja będzie opłacona.

Uwaga techniczna:

• Sklep musi być dostępny publicznie przez HTTPS.
• Jeśli używasz zapory, zezwól na połączenia przychodzące z adresów Przelewy24 (lista w dokumentacji dostawcy).
• Unikaj blokowania ruchu przez reguły WAF/antybot na endpointach powiadomień.

Testy end-to-end w trybie sandbox

Zweryfikuj cały proces: od koszyka po finalny status zamówienia.

Scenariusz testów:

1. Dodaj produkt do koszyka, przejdź do checkoutu i wybierz Przelewy24.
2. W trybie testowym wybierz przykładową metodę płatności oferowaną w sandboxie.
3. Po opłaceniu sprawdź:
   • Czy klient wraca do strony potwierdzenia zamówienia.
   • Czy status zamówienia w PrestaShop zmienia się automatycznie (np. na „Płatność zaakceptowana”).
   • Czy w module pojawia się log transakcji.
4. Sprawdź wysyłkę wiadomości e-mail i fakturę (jeśli generujesz automatycznie).

Jeśli wszystko działa, możesz przełączyć moduł na tryb produkcyjny i wykonać symboliczną transakcję kontrolną niskiej wartości.

Najczęstsze błędy i szybkie rozwiązania

Oszczędź czas na debugowaniu — oto lista typowych potknięć.

• Błąd podpisu/niezgodności CRC:

  • Sprawdź, czy Klucz CRC i ID POS są identyczne jak w panelu Przelewy24 (bez spacji, dodatkowych znaków).
  • Upewnij się, że środowisko (test/produkcja) jest spójne po obu stronach.

• Status zamówienia nie zmienia się po płatności:

  • Zweryfikuj poprawność adresu powiadomień (webhook).
  • Sprawdź, czy serwer nie blokuje ruchu z Przelewy24.
  • Przejrzyj logi modułu — często zawierają dokładny komunikat błędu.

• Niezgodność waluty lub kwoty:

  • Waluta zamówienia musi być wspierana przez Twoje konto w Przelewy24.
  • Uważaj na zaokrąglenia i format kwot; problemem bywa niestandardowy separator dziesiętny w szablonach/overridach.

• Problemy z SSL/HTTPS:

  • Certyfikat musi być ważny, a wymuszanie HTTPS poprawnie skonfigurowane.
  • Sprawdź, czy nie ma mieszanej zawartości (mixed content) na stronie płatności.

• Konflikt z innym modułem checkoutu:

  • Tymczasowo wyłącz niestandardowy checkout/one page, by potwierdzić konflikt.
  • Zaktualizuj moduł checkoutu i Przelewy24 do najnowszych wersji.

Dobre praktyki bezpieczeństwa i zgodności

Zadbaj o bezpieczeństwo danych i ciągłość działania płatności.

• Aktualizuj moduł Przelewy24 i PrestaShop. Nowe wersje często rozwiązują problemy zgodności i bezpieczeństwa.
• Wymuś TLS 1.2+ na serwerze i regularnie odnawiaj certyfikat SSL.
• Włącz logowanie zdarzeń w module, ale ogranicz dostęp do logów (zawierają szczegóły transakcji).
• Ustal procedurę awaryjną: co robisz, gdy płatność zostanie pobrana, ale status w sklepie nie zaktualizuje się? Najczęściej pomaga ręczna weryfikacja w panelu Przelewy24 i ręczna zmiana statusu z dokumentacją w zamówieniu.
• Zgodność z PSD2/3D Secure zapewnia operator; nie wyłączaj weryfikacji 3DS dla kart, jeśli taka opcja istnieje.

Optymalizacja doświadczenia klienta

Pokaż właściwe metody płatności we właściwym momencie i języku.

• Włącz BLIK i umieść go wysoko na liście metod — to najpopularniejsza forma płatności w Polsce.
• Dodaj rozpoznawalne ikony metod płatności (BLIK, karty, banki), by zwiększyć konwersję.
• Uporządkuj kolejność metod i ukryj te, których nie obsługujesz.
• Zadbaj o tłumaczenia komunikatów w module (Ustawienia > Tłumaczenia), by uniknąć mieszanki języków w checkoutcie.
• Jeśli korzystasz z szybkiego checkoutu (one-page), sprawdź kompatybilność modułu i unikaj nadmiaru pól.

Konfiguracja dla wielu sklepów (Multistore)

Każdy sklep może mieć własne klucze i ustawienia płatności.

• Włącz tryb Multi-Store w PrestaShop, jeśli go używasz.
• Dla każdego sklepu z osobna ustaw ID Sprzedawcy, ID POS i Klucz CRC.
• Przetestuj płatności oddzielnie w każdej witrynie, szczególnie adresy powiadomień.

Przejście z testów na produkcję

Przełącz tryb, zweryfikuj klucze i zrób transakcję kontrolną.

• Wyłącz tryb testowy w module i w panelu Przelewy24.
• Podmień klucze na produkcyjne (nie wszystkie środowiska używają tych samych danych!).
• Wykonaj niewielką transakcję kontrolną i sprawdź księgowanie oraz status zamówienia.
• Nie używaj danych z sandboxa w środowisku produkcyjnym — to częste źródło błędów.

Rozszerzone tipy dla administratorów PrestaShop

Kilka praktycznych usprawnień dla stabilności i wygody.

• Włącz cache i kompilację szablonów w trybie produkcyjnym, ale podczas konfiguracji i testów korzystaj z trybu deweloperskiego.
• Unikaj nadpisywania (override) klas i kontrolerów płatności bez potrzeby — to częste źródło konfliktów.
• Stwórz osobny profil uprawnień dla osób obsługujących płatności, ograniczając dostęp do wrażliwych ustawień.
• Dokumentuj zmiany w konfiguracji modułu i zapisuj daty aktualizacji — ułatwi to szybkie przywrócenie sprawności po błędzie.

FAQ: krótkie odpowiedzi na często zadawane pytania

Szybkie rozwiązania najpopularniejszych wątpliwości.

• Czy mogę używać Przelewy24 w wielu walutach?

  • Tak, ale waluta zamówienia musi być wspierana przez Twoje konto. Najprościej zacząć od PLN.

• Czy muszę mieć SSL?

  • Tak, HTTPS jest wymagany. Bez niego integracja nie przejdzie weryfikacji i webhooki mogą nie działać.

• Co z PSD2 i 3D Secure?

  • Obsługę zapewnia operator. Pamiętaj o aktualnym module i nie wyłączaj zabezpieczeń dla kart.

• Czy integracja działa z One Page Checkout?

  • Tak, o ile moduły są ze sobą kompatybilne. Testuj na kopii i aktualizuj wtyczki.

• Jak szybko otrzymam środki?

  • Zależy od ustawień rozliczeń w Przelewy24. Sprawdź harmonogram wypłat w panelu operatora.

Podsumowanie: najważniejsze kroki do sukcesu

Zbierz dane dostępowe, zainstaluj oficjalny moduł, skonfiguruj klucze, przetestuj i monitoruj.

Integracja płatności nie musi być stresująca. Kluczem jest dobra lista kontrolna: aktywne konto w Przelewy24, poprawne klucze (ID Sprzedawcy, ID POS, Klucz CRC), właściwe adresy powiadomień, testy w sandboxie i dopracowany checkout. Gdy zadbasz o te elementy, Twoi klienci zapłacą szybko i bezproblemowo, a Ty zyskasz stabilny kanał płatności, który realnie poprawia konwersję i doświadczenie zakupowe.