Przejdź do głównej zawartości

Shopware 6

Oficjalna wtyczka płatności dpay.pl dla Shopware 6. Umożliwia przyjmowanie płatności online w sklepie Shopware. Plugin rejestruje dwie metody płatności - standardową dpay.pl oraz BLIK - i obsługuje konfigurację per kanał sprzedaży.

Wymagania​

  • Shopware 6.5 lub 6.6
  • PHP 8.1 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, rejestrowany jako osobna metoda płatności)
  • Przelewy bankowe (pay-by-link)
  • Karty płatnicze (inline)
  • Google Pay i Apple Pay
  • PayPal
  • Paysafecard
  • Raty

Instalacja​

Metoda 1 - Composer (zalecana)​

  1. W katalogu głównym Shopware wykonaj: 
    composer require dpay/shopware-payment
  2. Odśwież listę wtyczek i zainstaluj: 
    bin/console plugin:refresh
    bin/console plugin:install --activate DPayShopwarePayment
    bin/console cache:clear

Metoda 2 - ręczna instalacja​

  1. Pobierz najnowszą wersję wtyczki ze strony dpay.pl lub z GitHuba.
  2. Rozpakuj archiwum do katalogu custom/plugins/DPayShopwarePayment/.
  3. Odśwież listę wtyczek i zainstaluj: 
    bin/console plugin:refresh
    bin/console plugin:install --activate DPayShopwarePayment
    bin/console cache:clear

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/dpay/webhook
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 Shopware​

  1. Przejdź do Rozszerzenia > Moje rozszerzenia w panelu administracyjnym.
  2. Znajdź dPay.pl Wtyczka płatności i kliknij Konfiguruj.
  3. Wypełnij formularz konfiguracyjny:
PoleOpis
Nazwa punktu płatnościNazwa serwisu z Panelu dpay.pl
Klucz HASHTajny hash z Panelu dpay.pl
Włącz PayPalWłącz płatności PayPal
Włącz kartę kredytowąWłącz płatności kartą kredytową
Włącz PaysafecardWłącz płatności Paysafecard
Włącz ratyWłącz płatności ratalne
Wyłącz przelewy bankoweWyłącz przelewy bankowe i pay-by-link
Włącz BLIK Zero (kod inline)Włącz wpisywanie kodu BLIK bezpośrednio w checkoucie
Włącz Apple PayWłącz płatności Apple Pay
Włącz Google PayWłącz płatności Google Pay
Włącz formularz karty inlineWłącz formularz karty płatniczej inline w checkoucie
  1. Kliknij Zapisz.
  2. Przejdź do Ustawienia > Sklep > Metody płatności i aktywuj metody dPay.pl oraz dPay.pl BLIK dla wybranych kanałów sprzedaży.

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 Shopware zmienił się na Opłacone.

Zwroty​

Zwroty realizowane są przez dpay.pl po złożeniu dyspozycji zwrotu w panelu Shopware. Aby wykonać zwrot:

  1. Przejdź do zamówienia w Zamówienia > Przegląd.
  2. Zmień status płatności na Zwrócone lub Częściowo zwrócone.
  3. Zwrot zostanie automatycznie przesłany do dpay.pl.

Mapowanie statusów​

Status dpay.plStatus Shopware
newOczekujące (Open)
completedOpłacone (Paid)
rejectedAnulowane (Cancelled)

Rozwiązywanie problemów​

Zamówienia nie zmieniają statusu automatycznie​

  • Sprawdź, czy adres IPN (https://twoj-sklep.pl/dpay/webhook) jest prawidłowo ustawiony w Panelu dpay.pl.
  • Upewnij się, że endpoint webhook jest dostępny publicznie.
  • Sprawdź logi Shopware: var/log/ - szukaj wpisów z przedrostkiem [dPay].

Metody płatności nie wyświetlają się w checkoucie​

  • Przejdź do Ustawienia > Sklep > Metody płatności i sprawdź, czy metody dpay.pl są aktywne.
  • Upewnij się, że metody płatności są przypisane do odpowiedniego kanału sprzedaży.
  • Sprawdź, czy waluta kanału to PLN.

Błąd konfiguracji​

  • Upewnij się, że pola Nazwa punktu płatności i Klucz HASH są prawidłowo wypełnione.
  • Po zmianie konfiguracji wyczyść cache: bin/console cache:clear.

Plugin nie instaluje się​

  • Sprawdź, czy wersja Shopware to 6.5 lub 6.6.
  • Upewnij się, że PHP jest w wersji 8.1 lub nowszej.
  • Wykonaj bin/console plugin:refresh przed instalacją.

Więcej informacji​