Przejdź do głównej zawartości

Blesta

Oficjalny moduł bramki płatności dpay.pl dla systemu billingowego Blesta. Umożliwia przyjmowanie płatności online za faktury i usługi. Obsługuje BLIK Level 0 (inline), karty płatnicze, PayPal, Paysafecard, raty oraz zwroty online.

Wymagania​

  • Blesta 4.x lub 5.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
  • PayPal
  • Paysafecard
  • Raty

Obsługiwana waluta: PLN.

Instalacja​

  1. Pobierz pliki modułu ze strony dpay.pl lub z GitHuba.
  2. Skopiuj cały katalog dpay/ do katalogu bramek płatności Blesta: 
    components/gateways/nonmerchant/dpay/
    Struktura katalogu powinna wyglądać następująco:
    • dpay/dpay.php - główny plik modułu
    • dpay/config.json - konfiguracja modułu
    • dpay/language/ - pliki tłumaczeń (pl_pl, en_us)
    • dpay/lib/dpay-sdk/ - biblioteka SDK dpay.pl
    • dpay/views/ - widoki ustawień i logo
  3. Zaloguj się do panelu administracyjnego Blesta.
  4. Przejdź do Settings > Payment Gateways > Available.
  5. Znajdź dpay.pl payments na liście i kliknij Install.

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://twoja-blesta.pl/callback/gw/<company_id>/dpay/<client_id>
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​

  1. Przejdź do Settings > Payment Gateways > Installed w panelu Blesta.
  2. Kliknij Manage przy module dpay.pl payments.
  3. Wypełnij formularz konfiguracyjny:
PoleOpis
Nazwa punktu płatności (service)Nazwa serwisu z Panelu dpay.pl
Klucz HASH (hash)Tajny hash z Panelu dpay.pl (przechowywany szyfrowany)
Włącz PayPalWłącz/wyłącz płatności PayPal
Włącz karty płatniczeWłącz/wyłącz płatności kartą
Włącz PaysafecardWłącz/wyłącz płatności Paysafecard
Włącz ratyWłącz/wyłącz płatności ratalne
Wyłącz przelewy/BLIK/PayByLinkUkryj listę banków na stronie płatności
Włącz BLIK ZeroWłącz płatności BLIK Level 0 (inline, bez przekierowania)
Włącz Apple PayWłącz płatności Apple Pay
Włącz Google PayWłącz płatności Google Pay
Włącz kartę inlineWłącz płatności kartą inline
  1. Kliknij Update Settings.

Krok 3 - Weryfikacja​

  1. Przejdź do konta klienta lub utwórz testową fakturę w walucie PLN.
  2. Wybierz dpay.pl jako metodę płatności.
  3. Sprawdź, czy następuje poprawne przekierowanie na stronę płatności (lub wyświetlenie pola BLIK, jeśli BLIK Zero jest włączony).
  4. Po dokonaniu płatności sprawdź, czy faktura w Blesta zmieniła status na opłaconą.

Zwroty​

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

  1. Przejdź do transakcji klienta w Clients > [Klient] > Transactions.
  2. Wybierz transakcję i kliknij opcję Refund.
  3. Podaj kwotę zwrotu i potwierdź.

Zwrot zostanie automatycznie przesłany do dpay.pl przez API. Obsługiwane są zarówno zwroty pełne (bez podania kwoty), jak i częściowe.

Mapowanie statusów​

Status dpay.plStatus Blesta
Nowa transakcjaPending
completed (IPN)Approved
refundedRefunded
Błąd podpisuOdrzucone (BAD SIGNATURE)

Rozwiązywanie problemów​

Faktury nie zmieniają statusu po płatności​

  • Sprawdź, czy adres IPN jest prawidłowo ustawiony w Panelu dpay.pl.
  • Upewnij się, że URL callbacku Blesta jest dostępny publicznie i nie jest blokowany przez firewall.
  • Sprawdź logi bramki płatności w panelu Blesta: Tools > Logs > Gateway Logs.

Błąd waluty​

  • Moduł obsługuje wyłącznie walutę PLN. Upewnij się, że waluta faktury jest ustawiona na PLN. Przy innej walucie wyświetli się komunikat o braku obsługi.

Błąd "Nazwa punktu płatności nie może być pusta"​

  • Upewnij się, że pole service w konfiguracji modułu jest uzupełnione prawidłową nazwą Punktu Płatności z Panelu dpay.pl.

Płatność BLIK nie działa​

  • Sprawdź, czy opcja BLIK Zero jest zaznaczona w ustawieniach modułu.
  • Upewnij się, że klient wpisuje poprawny 6-cyfrowy kod BLIK.
  • Kod BLIK jest ważny przez krótki czas - klient powinien przeprowadzić płatność niezwłocznie po wygenerowaniu kodu w aplikacji bankowej.

Więcej informacji​