Spring Boot
Udostępnij DPayClient jako singleton bean i pobieraj service oraz Secret Hash z bezpiecznej konfiguracji aplikacji.
SDK dpay · Java
Dodaj płatności Java przez Maven lub Gradle. Oficjalne SDK dla Java 11+ nie ma zależności runtime, automatyzuje checksum i IPN, a bezpieczny wątkowo klient możesz współdzielić w całej aplikacji backendowej.
Instalacja
Javaimplementation 'pl.dpay:dpay-java-sdk:0.1.0'Krótka odpowiedź
Dodaj bibliotekę dpay do projektu przez Maven lub Gradle, utwórz klienta po stronie backendu i przekaż dane Punktu Płatności z bezpiecznej konfiguracji. Następnie zarejestruj transakcję, przekieruj kupującego na adres zwrócony przez dpay i aktualizuj status zamówienia dopiero po poprawnej weryfikacji IPN.
Ekosystem backendu
DPayClient jest niemutowalny i bezpieczny wątkowo. Możesz utworzyć jedną instancję klienta w kontenerze aplikacji i współdzielić ją między żądaniami bez dodawania zewnętrznego transportu HTTP.
Udostępnij DPayClient jako singleton bean i pobieraj service oraz Secret Hash z bezpiecznej konfiguracji aplikacji.
Wstrzyknij klienta do serwisu checkoutu i oddziel komunikację z API dpay od logiki zamówienia.
Współdziel bezpiecznego wątkowo klienta; transport korzysta z java.net.http, bez dodatkowych zależności runtime.
Warstwa integracyjna
Biblioteka Java opakowuje powtarzalne elementy cyklu płatności w metody i typy pasujące do ekosystemu języka.
Biblioteka generuje sumę kontrolną zgodnie z wymaganiami danego żądania.
Integralność żądania
Gotowe metody upraszczają rejestrację płatności i dalszą pracę z transakcją.
Mniej kodu HTTP
SDK pomaga sprawdzić podpis powiadomienia przed zmianą statusu zamówienia.
Bezpieczne webhooks
Wyjątki i kody błędów ułatwiają logowanie, retry i diagnostykę.
Przewidywalna obsługa
Kod startowy
Dane usługi pobierz z ustawień Punktu Płatności. Secret Hash przechowuj w zmiennych środowiskowych lub menedżerze sekretów — nigdy w repozytorium ani kodzie frontendu.
Secret Hash → server only
import pl.dpay.sdk.DPayClient;
DPayClient dpay = new DPayClient("service_name", "secret_hash");Przepływ wdrożenia
Bezpieczny proces wdrożenia pozostaje taki sam niezależnie od technologii.
Dodaj oficjalny pakiet do backendu i przypnij wersję zgodnie z zasadami projektu.
Przekaż nazwę serwisu i Secret Hash wyłącznie z bezpiecznej konfiguracji serwerowej.
Wyślij kwotę oraz adresy sukcesu, błędu i IPN, a klienta skieruj na otrzymany adres płatności.
Po poprawnej weryfikacji powiadomienia zaktualizuj status zamówienia w swojej bazie.
Inne technologie
Porównaj dostępne biblioteki i wybierz język, który najlepiej pasuje do architektury produktu.
FAQ dla integratora
Zainstaluj pakiet poleceniem „implementation 'pl.dpay:dpay-java-sdk:0.1.0'”, utwórz klienta z nazwą serwisu i Secret Hash, a następnie wywołaj metodę rejestracji płatności zgodnie z dokumentacją Java SDK.
Tak. Opublikowane SDK dpay automatyzują obliczanie checksum zgodnie ze specyfikacją API. Secret Hash nadal musi pozostać bezpieczny po stronie serwera.
Biblioteka pomaga zweryfikować podpis danych IPN i odczytać powiadomienie. Status zamówienia zmieniaj dopiero po poprawnej weryfikacji.
Potrzebujesz danych Punktu Płatności, przede wszystkim nazwy serwisu i Secret Hash. Pełne wymagania dla biblioteki znajdują się w jej dokumentacji.
Tak. SDK jest niezależną biblioteką backendową. DPayClient możesz zarejestrować jako singleton bean w Spring Boot albo usługę w Jakarta EE i wstrzykiwać do warstwy płatności.
Nie. SDK dpay dla Java jest przeznaczone dla aplikacji backendowych działających na Java 11 lub nowszej. Android nie jest wspieranym środowiskiem tej biblioteki.
Pełna dokumentacja
Sprawdź instalację, pełne przykłady, obsługę IPN, błędy i pozostałe operacje dostępne w bibliotece.