Przejdź do głównej zawartości

PrestaShop

Oficjalny moduł płatności dpay.pl dla PrestaShop 1.7 i 8.x. Umożliwia przyjmowanie płatności online w sklepie PrestaShop. Moduł obsługuje zwroty online, BLIK Level 0, Apple Pay, Google Pay oraz formularz karty inline.

Wymagania​

  • PrestaShop 1.7.6 lub nowszy (w tym PrestaShop 8.x)
  • PHP 7.4 lub nowszy
  • Aktywne konto w Panelu dpay.pl z utworzonym Punktem Płatności

Obsługiwane metody płatności​

  • BLIK (w tym BLIK Level 0 - inline)
  • Przelewy bankowe (pay-by-link)
  • Karty płatnicze (inline)
  • Google Pay i Apple Pay
  • PayPal
  • Paysafecard
  • Raty

Instalacja​

Metoda 1 - z panelu administracyjnego (zalecana)​

  1. Pobierz najnowszą wersję modułu ze strony dpay.pl lub z GitHuba w formacie .zip.
  2. Przejdź do Moduły > Menedżer modułów w panelu administracyjnym PrestaShop.
  3. Kliknij Załaduj moduł i wybierz pobrany plik .zip.
  4. Po zakończeniu instalacji moduł pojawi się na liście jako dPay Payment Gateway.

Metoda 2 - ręczna instalacja​

  1. Pobierz i rozpakuj archiwum modułu.
  2. Skopiuj katalog dpaypayment do folderu modules/ w katalogu głównym PrestaShop.
  3. Przejdź do Moduły > Menedżer modułów.
  4. Wyszukaj dPay Payment Gateway i kliknij Zainstaluj.

Konfiguracja​

Krok 1 - Przygotowanie danych w Panelu dpay.pl​

  1. Zaloguj się do Panelu dpay.pl.
  2. Przejdź do sekcji Punkty Płatności.
  3. Utwórz nowy Punkt Płatności lub wybierz istniejący.
  4. Zanotuj:
    • Nazwa serwisu (service_name) - unikalna nazwa Twojego Punktu Płatności
    • Tajny hash (secret_hash) - klucz używany do podpisywania żądań
  5. W ustawieniach Punktu Płatności ustaw adres IPN na: 
    https://twoj-sklep.pl/module/dpaypayment/callback
Ważne

Tajny hash powinien być traktowany jak hasło. Nigdy nie udostępniaj go publicznie ani nie umieszczaj w kodzie frontendowym.

Krok 2 - Konfiguracja modułu w PrestaShop​

  1. Przejdź do Moduły > Menedżer modułów.
  2. Znajdź dPay Payment Gateway i kliknij Konfiguruj.
  3. Wypełnij formularz konfiguracyjny:
PoleOpis
Service NameNazwa serwisu z Panelu dpay.pl
Hash KeyTajny hash z Panelu dpay.pl
Enable PayPalWłącz płatności PayPal
Enable Credit CardWłącz płatności kartą kredytową
Enable PaysafecardWłącz płatności Paysafecard
Enable InstallmentsWłącz płatności ratalne
Hide Bank ListUkryj listę banków na stronie płatności dpay.pl
BLIK ZeroWłącz wpisywanie kodu BLIK bezpośrednio w checkoucie
Apple PayWłącz płatności Apple Pay
Google PayWłącz płatności Google Pay
Credit card (dPay)Włącz formularz karty inline w checkoucie
  1. Kliknij Zapisz.

Krok 3 - Weryfikacja​

  1. Złóż testowe zamówienie w swoim sklepie.
  2. Wybierz Pay with dPay jako metodę płatności.
  3. Sprawdź, czy następuje poprawne przekierowanie na stronę płatności dpay.pl.
  4. Po dokonaniu płatności sprawdź, czy status zamówienia w PrestaShop zmienił się na Płatność zaakceptowana.

Zwroty​

Moduł obsługuje zwroty online z poziomu panelu PrestaShop:

  1. Przejdź do zamówienia w Zamówienia > Zamówienia.
  2. Kliknij Częściowy zwrot lub Standardowy zwrot.
  3. Podaj kwotę zwrotu i zatwierdź operację.

Zwrot (pełny lub częściowy) zostanie automatycznie przesłany do dpay.pl. Informacja o zwrocie zostanie dodana jako notatka do zamówienia.

Mapowanie statusów​

Status dpay.plStatus PrestaShop
newOczekiwanie na płatność
completedPłatność zaakceptowana
rejectedAnulowane

Rozwiązywanie problemów​

Zamówienia nie zmieniają statusu automatycznie​

  • Sprawdź, czy adres IPN (https://twoj-sklep.pl/module/dpaypayment/callback) jest prawidłowo ustawiony w Panelu dpay.pl.
  • Upewnij się, że endpoint jest dostępny publicznie i nie jest blokowany przez firewall.
  • Sprawdź logi PrestaShop w katalogu var/logs/.

Błąd "Service name and hash key must be configured"​

  • Przejdź do konfiguracji modułu i upewnij się, że pola Service Name i Hash Key są wypełnione.
  • Sprawdź, czy nie ma dodatkowych spacji przed lub po wartościach.

Metoda płatności nie wyświetla się w checkoucie​

  • Upewnij się, że moduł jest aktywny w Moduły > Menedżer modułów.
  • Sprawdź, czy waluta zamówienia to PLN - moduł obsługuje wyłącznie tę walutę.
  • Przejdź do Płatność > Preferencje i sprawdź, czy moduł dpaypayment jest włączony dla odpowiednich walut.

Błąd podczas zwrotu​

  • Sprawdź, czy transakcja dpay.pl istnieje dla tego zamówienia.
  • Sprawdź logi w var/logs/ pod kątem komunikatów z przedrostkiem dPay refund error.

Więcej informacji​