Przejdź do głównej zawartości

OpenCart

Oficjalne rozszerzenie płatności dpay.pl dla OpenCart 4.x. Dostarczone w formacie OCMOD, umożliwia przyjmowanie płatności online w sklepie OpenCart. Obsługuje BLIK Level 0, Apple Pay, Google Pay, formularz karty inline oraz zwroty z poziomu panelu administracyjnego.

Wymagania​

  • OpenCart 4.x
  • PHP 8.0 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ę rozszerzenia ze strony dpay.pl lub z GitHuba w formacie .ocmod.zip.
  2. Przejdź do Extensions > Installer w panelu administracyjnym OpenCart.
  3. Kliknij Upload i wybierz pobrany plik.
  4. Po zakończeniu instalacji przejdź do Extensions > Extensions > Payments.
  5. Znajdź dpay.pl - Payment Gateway i kliknij Install (zielony przycisk +).

Metoda 2 - ręczna instalacja​

  1. Pobierz i rozpakuj archiwum rozszerzenia.
  2. Skopiuj zawartość katalogów admin/, catalog/ i system/ do odpowiednich katalogów w instalacji OpenCart.
  3. Skopiuj plik dpay.ocmod.xml do katalogu głównego OpenCart.
  4. Przejdź do Extensions > Extensions > Payments i zainstaluj dpay.pl - Payment Gateway.

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/index.php?route=extension/dpay/payment/dpay|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 rozszerzenia w OpenCart​

  1. Przejdź do Extensions > Extensions > Payments.
  2. Znajdź dpay.pl - Payment Gateway i kliknij Edit (niebieski przycisk z ołówkiem).
  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
Disable Bank TransfersWyłącz przelewy bankowe i pay-by-link
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
Inline Card FormWłącz formularz karty inline w checkoucie
Order StatusStatus zamówienia po pomyślnej płatności
Failed StatusStatus zamówienia po nieudanej płatności
StatusWłącz/wyłącz rozszerzenie
Geo ZoneOgranicz dostępność do wybranej strefy geograficznej
Sort OrderKolejność wyświetlania metody płatności
  1. Kliknij Save (ikona dyskietki w prawym górnym rogu).

Krok 3 - Weryfikacja​

  1. Złóż testowe zamówienie w swoim sklepie.
  2. Wybierz dpay.pl 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 OpenCart zmienił się zgodnie z ustawieniami.

Zwroty​

Rozszerzenie obsługuje zwroty online z poziomu panelu OpenCart:

  1. Przejdź do zamówienia w Sales > Orders.
  2. W szczegółach zamówienia znajdź sekcję dpay.pl.
  3. Kliknij Zwrot i podaj kwotę (opcjonalnie - puste pole oznacza zwrot pełny).
  4. Zatwierdź operację.

Zwrot (pełny lub częściowy) zostanie automatycznie przesłany do dpay.pl.

Mapowanie statusów​

Status dpay.plStatus OpenCart
newPending
completedComplete (konfigurowalne)
rejectedFailed (konfigurowalne)

Rozwiązywanie problemów​

Zamówienia nie zmieniają statusu automatycznie​

  • Sprawdź, czy adres IPN jest prawidłowo ustawiony w Panelu dpay.pl.
  • Upewnij się, że endpoint jest dostępny publicznie i nie jest blokowany przez firewall lub reguły .htaccess.
  • Sprawdź logi OpenCart w katalogu system/storage/logs/.

Rozszerzenie nie pojawia się na liście płatności​

  • Upewnij się, że plik dpay.ocmod.xml jest prawidłowo zainstalowany.
  • Przejdź do Extensions > Installer i sprawdź, czy rozszerzenie jest na liście zainstalowanych.
  • Wyczyść cache: Dashboard > przycisk z niebieskim kółkiem (odświeżenie modyfikatorów).

Błąd uprawnień​

  • Przejdź do System > Users > User Groups i dodaj uprawnienia dostępu i modyfikacji dla extension/dpay/payment/dpay.

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

  • Sprawdź, czy rozszerzenie jest włączone (pole Status ustawione na Enabled).
  • Upewnij się, że nie ograniczono dostępności do strefy geograficznej, w której nie znajduje się klient.

Więcej informacji​