WHMCS
Oficjalny moduł bramki płatności dpay.pl dla WHMCS. Umożliwia przyjmowanie płatności online za faktury i usługi w systemie WHMCS. Obsługuje BLIK Level 0 (inline), karty płatnicze, PayPal, Paysafecard, raty oraz zwroty online.
Wymagania
- WHMCS 7.x lub 8.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 (inline)
- Google Pay i Apple Pay
- PayPal
- Paysafecard
- Raty (BLIK BNPL)
Instalacja
- Pobierz pliki modułu ze strony dpay.pl lub z GitHuba.
- Skopiuj pliki do katalogu WHMCS, zachowując strukturę katalogów:
modules/gateways/dpay_payments.php- główny plik modułumodules/gateways/callback/dpay_payments.php- obsługa IPN i płatnościmodules/gateways/dpay_payments/lib/dpay-sdk/- biblioteka SDK dpay.pl
- Zaloguj się do panelu administracyjnego WHMCS.
- Przejdź do Setup > Payments > Payment Gateways.
- Na zakładce All Payment Gateways znajdź Płatności dpay.pl i kliknij Activate.
Konfiguracja
Krok 1 - Przygotowanie danych w Panelu dpay.pl
- Zaloguj się do Panelu dpay.pl.
- Przejdź do sekcji Punkty Płatności.
- Utwórz nowy Punkt Płatności lub wybierz istniejący.
- Zanotuj:
- Nazwa serwisu (
service_name) - unikalna nazwa Twojego Punktu Płatności - Tajny hash (
secret_hash) - klucz używany do podpisywania żądań
- Nazwa serwisu (
- W ustawieniach Punktu Płatności ustaw adres IPN na:
https://twoj-whmcs.pl/modules/gateways/callback/dpay_payments.php
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
- Przejdź do Setup > Payments > Payment Gateways w panelu WHMCS.
- Kliknij zakładkę Manage Existing Gateways i wybierz Płatności dpay.pl.
- Wypełnij formularz konfiguracyjny:
| Pole | Opis |
|---|---|
| Nazwa punktu płatności | Nazwa serwisu z Panelu dpay.pl |
| Klucz HASH | Tajny hash z Panelu dpay.pl |
| Paypal | Włącz/wyłącz płatności PayPal |
| Karty płatnicze | Włącz/wyłącz płatności kartą |
| Paysafecard | Włącz/wyłącz płatności Paysafecard |
| Raty | Włącz/wyłącz płatności ratalne |
| Brak banków | Wyłącz przyjmowanie wpłat przelewem, BLIKiem i pay-by-link |
| BLIK Zero | Włącz płatności BLIK Level 0 (inline, bez przekierowania) |
| Apple Pay | Włącz płatności Apple Pay |
| Google Pay | Włącz płatności Google Pay |
| Karta inline | Włącz płatności kartą inline |
- Kliknij Save Changes.
Krok 3 - Weryfikacja
- Przejdź do konta klienta lub utwórz testową fakturę.
- Wybierz Płatności dpay.pl jako metodę płatności.
- Sprawdź, czy następuje poprawne przekierowanie na stronę płatności (lub wyświetlenie pola BLIK, jeśli włączony).
- Po dokonaniu płatności sprawdź, czy faktura w WHMCS zmieniła status na Paid.
Zwroty
Moduł obsługuje zwroty online bezpośrednio z panelu WHMCS:
- Przejdź do faktury w Billing > Invoices.
- Kliknij na transakcję i wybierz opcję Refund.
- Podaj kwotę zwrotu i potwierdź.
Zwrot zostanie automatycznie przesłany do dpay.pl. Obsługiwane są zarówno zwroty pełne, jak i częściowe.
Mapowanie statusów
| Status dpay.pl | Status WHMCS |
|---|---|
| Nowa transakcja | Unpaid |
completed (IPN) | Paid |
| Błąd płatności | Unpaid (z logiem błędu) |
Rozwiązywanie problemów
Faktury nie zmieniają statusu na Paid
- Sprawdź, czy adres IPN (
/modules/gateways/callback/dpay_payments.php) jest prawidłowo ustawiony w Panelu dpay.pl. - Upewnij się, że plik callback jest dostępny publicznie i nie jest blokowany przez firewall.
- Sprawdź logi WHMCS: Utilities > Logs > Gateway Log.
Błąd "Module Not Activated"
- Upewnij się, że moduł jest aktywowany w Setup > Payments > Payment Gateways.
Błąd waluty
- Moduł obsługuje wyłącznie walutę PLN. Upewnij się, że waluta faktury jest ustawiona na PLN.
Błąd w logach - "ERROR"
- Sprawdź logi Gateway Log w WHMCS, aby poznać szczegóły błędu.
- Upewnij się, że Klucz HASH jest prawidłowy i zgodny z wartością w Panelu dpay.pl.