Laravel
Zarejestruj klienta dpay w kontenerze usług i pobieraj dane Punktu Płatności z konfiguracji środowiska.
SDK dpay · PHP
Dodaj płatności do backendu PHP 7.4+ przez Composer. Oficjalne SDK bez zależności runtime automatyzuje sumy kontrolne, rejestrację transakcji, typowane odpowiedzi oraz weryfikację IPN.
Instalacja
PHPcomposer require dpayglobal/dpay-php-sdkKrótka odpowiedź
Zainstaluj pakiet dpay przez Composer, utwórz DPayClient z danymi Punktu Płatności i zarejestruj transakcję po stronie serwera. Kupującego przekieruj na adres zwrócony przez dpay, a zamówienie oznacz jako opłacone dopiero po poprawnej weryfikacji powiadomienia IPN.
Ekosystem backendu
SDK jest zwykłą biblioteką PHP, dlatego możesz umieścić klienta dpay w warstwie usług istniejącej aplikacji. Dane integracyjne pozostają w konfiguracji serwerowej, niezależnie od używanego frameworka.
Zarejestruj klienta dpay w kontenerze usług i pobieraj dane Punktu Płatności z konfiguracji środowiska.
Dodaj DPayClient jako usługę i wstrzykuj go do kodu odpowiedzialnego za checkout, zwroty oraz IPN.
Pakiet Composer możesz wykorzystać bez frameworka; poza rozszerzeniami PHP nie dodaje zależności runtime.
Warstwa integracyjna
Biblioteka PHP 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
use DPay\DPayClient;
$dpay = new DPayClient([
'service' => 'service_name',
'secret_hash' => '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 „composer require dpayglobal/dpay-php-sdk”, utwórz klienta z nazwą serwisu i Secret Hash, a następnie wywołaj metodę rejestracji płatności zgodnie z dokumentacją PHP 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ą PHP, więc możesz zarejestrować klienta dpay jako usługę w Laravel, Symfony albo własnej architekturze. dpay nie wymaga dedykowanej wtyczki do frameworka.
SDK wymaga PHP 7.4 lub nowszego, Composera oraz rozszerzeń curl, json i openssl. Biblioteka nie ma innych zależności runtime.
Pełna dokumentacja
Sprawdź instalację, pełne przykłady, obsługę IPN, błędy i pozostałe operacje dostępne w bibliotece.