Przejdź do głównej zawartości

Magento 2

Oficjalny moduł płatności dpay.pl dla Magento 2. Umożliwia przyjmowanie płatności online w sklepie Magento bez konieczności pisania kodu. Moduł obsługuje automatyczne generowanie faktur, zwroty online oraz powiadomienia IPN.

Wymagania​

  • Magento 2.4.x lub nowszy
  • 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 - Composer (zalecana)​

  1. W katalogu głównym Magento wykonaj: 
    composer require dpay/magento2-payment
  2. Włącz moduł i zaktualizuj bazę danych: 
    bin/magento module:enable DPay_Payment
    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento cache:flush

Metoda 2 - ręczna instalacja​

  1. Pobierz najnowszą wersję modułu ze strony dpay.pl lub z GitHuba.
  2. Rozpakuj archiwum do katalogu app/code/DPay/Payment/.
  3. Włącz moduł i zaktualizuj bazę danych: 
    bin/magento module:enable DPay_Payment
    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento cache:flush

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/callback/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 modułu w Magento​

  1. Przejdź do Stores > Configuration > Sales > Payment Methods.
  2. Znajdź sekcję dPay - Payment Gateway i rozwiń ją.
  3. Wypełnij formularz konfiguracyjny:
PoleOpis
EnabledZaznacz Yes, aby aktywować bramkę płatności
TitleNazwa metody płatności widoczna dla klienta (domyślnie dPay)
Service NameNazwa serwisu z Panelu dpay.pl
Secret Hash KeyTajny hash z Panelu dpay.pl (przechowywany w formie zaszyfrowanej)
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 PayByLink + TransferWyłą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
Credit card (dPay)Włącz formularz karty inline w checkoucie
New Order StatusStatus nowego zamówienia (domyślnie Pending)
Payment from Applicable CountriesOgranicz dostępność do wybranych krajów
Sort OrderKolejność wyświetlania metody płatności
  1. Kliknij Save Config.
  2. Wyczyść cache: System > Cache Management > Flush Magento Cache.

Krok 3 - Weryfikacja​

  1. Złóż testowe zamówienie w swoim sklepie.
  2. Wybierz 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 zmienił się na Processing, a faktura została automatycznie wygenerowana.

Zwroty​

Moduł obsługuje zwroty online bezpośrednio z panelu Magento:

  1. Przejdź do zamówienia w Sales > Orders.
  2. Otwórz fakturę powiązaną z zamówieniem.
  3. Kliknij Credit Memo i podaj kwotę zwrotu.
  4. Zatwierdź operację.

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

Mapowanie statusów​

Status dpay.plStatus Magento
newPending
completedProcessing (faktura generowana automatycznie)
rejectedCanceled

Rozwiązywanie problemów​

Zamówienia nie zmieniają statusu automatycznie​

  • Sprawdź, czy adres IPN (https://twoj-sklep.pl/dpay/callback/ipn) jest prawidłowo ustawiony w Panelu dpay.pl.
  • Upewnij się, że endpoint IPN jest dostępny publicznie i nie jest blokowany przez firewall lub WAF.
  • Sprawdź logi Magento: var/log/system.log i var/log/exception.log.

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

  • Upewnij się, że Secret Hash Key w konfiguracji modułu jest identyczny z hashem w Panelu dpay.pl.
  • Sprawdź, czy nie ma dodatkowych spacji przed lub po wartości hasha.

Moduł nie pojawia się w konfiguracji​

  • Upewnij się, że moduł jest włączony: bin/magento module:status DPay_Payment.
  • Wykonaj ponownie bin/magento setup:di:compile i bin/magento cache:flush.

Przekierowanie na stronę płatności nie działa​

  • Sprawdź, czy Service Name jest poprawnie wpisany.
  • Upewnij się, że waluta sklepu to PLN - moduł obsługuje wyłącznie tę walutę.

Więcej informacji​