Przejdź do głównej zawartości

WooCommerce

Oficjalna wtyczka dpay.pl dla WooCommerce. Umożliwia przyjmowanie płatności online w sklepie opartym na WordPress + WooCommerce bez pisania kodu. Obsługuje WooCommerce Blocks.

Wymagania​

  • WordPress 6.0 lub nowszy
  • WooCommerce 8.0 lub nowszy (w tym WooCommerce 10)
  • 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 (BLIK BNPL)

Instalacja​

Metoda 1 - z repozytorium WordPress (zalecana)​

  1. Przejdź do Wtyczki > Dodaj nową w panelu administracyjnym WordPress.
  2. Wyszukaj dpay.pl w wyszukiwarce wtyczek.
  3. Kliknij Zainstaluj, a następnie Włącz.

Metoda 2 - ręczna instalacja z pliku ZIP​

  1. Pobierz najnowszą wersję wtyczki ze strony dpay.pl lub z GitHuba.
  2. Przejdź do Wtyczki > Dodaj nową > Wyślij wtyczkę na serwer.
  3. Wybierz pobrany plik .zip i kliknij Zainstaluj.
  4. Po zakończeniu instalacji kliknij Włącz wtyczkę.

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/?wc-api=dpay_ipn
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 wtyczki w WordPress​

  1. Przejdź do WooCommerce > Ustawienia > Płatności.
  2. Znajdź na liście dpay.pl i kliknij Zarządzaj.
  3. Wypełnij formularz konfiguracyjny:
PoleOpis
Włącz/WyłączZaznacz, aby aktywować bramkę płatności
TytułNazwa metody płatności widoczna dla klienta (np. Płatność online - dpay.pl)
OpisOpis wyświetlany na stronie zamówienia
Nazwa serwisuNazwa serwisu z Panelu dpay.pl
Tajny hashTajny hash z Panelu dpay.pl
Tryb testowyWłącz, aby korzystać ze środowiska sandbox
  1. Kliknij Zapisz zmiany.

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.
  4. Po dokonaniu płatności sprawdź, czy status zamówienia w WooCommerce zmienił się na Opłacone.

Zwroty​

Wtyczka obsługuje zwroty online bezpośrednio z panelu WooCommerce:

  1. Przejdź do zamówienia w WooCommerce > Zamówienia.
  2. Kliknij Zwrot.
  3. Podaj kwotę zwrotu i potwierdź.

Zwrot zostanie automatycznie przesłany do dpay.pl.

Mapowanie statusów​

Status dpay.plStatus WooCommerce
newOczekujące
completedOpłacone
rejectedAnulowane

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 adres IPN jest dostępny publicznie (nie jest blokowany przez firewall).
  • Sprawdź logi WooCommerce: WooCommerce > Status > Logi.

Błąd "Nieprawidłowa suma kontrolna"​

  • Upewnij się, że Tajny hash w ustawieniach wtyczki jest identyczny z hashem w Panelu dpay.pl.
  • Sprawdź, czy nie ma dodatkowych spacji przed lub po wartości hasha.

Przekierowanie nie działa​

  • Upewnij się, że wtyczka jest włączona w WooCommerce > Ustawienia > Płatności.
  • Sprawdź, czy Nazwa serwisu jest poprawna.

Więcej informacji​