Przejdź do treści

SDK dpay · PHP

Płatności online w PHP z oficjalnym SDK dpay.

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.

  • Oficjalna biblioteka dpay
  • Automatyczne sumy kontrolne
  • Weryfikacja IPN
  • Spójna obsługa błędów

Instalacja

PHP
Composer
composer require dpayglobal/dpay-php-sdk
Wymagania
PHP 7.4+
Ekosystem
Composer

Krótka odpowiedź

Jak dodać płatności online do aplikacji PHP?

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

Płatności PHP w Laravel, Symfony i własnym backendzie.

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.

01

Laravel

Zarejestruj klienta dpay w kontenerze usług i pobieraj dane Punktu Płatności z konfiguracji środowiska.

02

Symfony

Dodaj DPayClient jako usługę i wstrzykuj go do kodu odpowiedzialnego za checkout, zwroty oraz IPN.

03

Własny backend PHP

Pakiet Composer możesz wykorzystać bez frameworka; poza rozszerzeniami PHP nie dodaje zależności runtime.

Warstwa integracyjna

Elementy płatności, których nie musisz budować od zera.

Biblioteka PHP opakowuje powtarzalne elementy cyklu płatności w metody i typy pasujące do ekosystemu języka.

Checksum bez ręcznego składania

Biblioteka generuje sumę kontrolną zgodnie z wymaganiami danego żądania.

Integralność żądania

Cykl płatności

Gotowe metody upraszczają rejestrację płatności i dalszą pracę z transakcją.

Mniej kodu HTTP

Zweryfikowany IPN

SDK pomaga sprawdzić podpis powiadomienia przed zmianą statusu zamówienia.

Bezpieczne webhooks

Błędy pod kontrolą

Wyjątki i kody błędów ułatwiają logowanie, retry i diagnostykę.

Przewidywalna obsługa

Kod startowy

Utwórz klienta dpay w PHP.

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

php
use DPay\DPayClient;

$dpay = new DPayClient([
    'service' => 'service_name',
    'secret_hash' => 'secret_hash',
]);

Przepływ wdrożenia

Od Punktu Płatności do potwierdzonego zamówienia.

Bezpieczny proces wdrożenia pozostaje taki sam niezależnie od technologii.

  1. 01

    Zainstaluj bibliotekę

    Dodaj oficjalny pakiet do backendu i przypnij wersję zgodnie z zasadami projektu.

  2. 02

    Skonfiguruj klienta

    Przekaż nazwę serwisu i Secret Hash wyłącznie z bezpiecznej konfiguracji serwerowej.

  3. 03

    Zarejestruj płatność

    Wyślij kwotę oraz adresy sukcesu, błędu i IPN, a klienta skieruj na otrzymany adres płatności.

  4. 04

    Zweryfikuj IPN

    Po poprawnej weryfikacji powiadomienia zaktualizuj status zamówienia w swojej bazie.

Inne technologie

To samo API w backendzie Twojego zespołu.

Porównaj dostępne biblioteki i wybierz język, który najlepiej pasuje do architektury produktu.

FAQ dla integratora

Zanim napiszesz pierwszą linię.

Jak dodać płatności online w PHP?

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.

Czy SDK generuje sumy kontrolne?

Tak. Opublikowane SDK dpay automatyzują obliczanie checksum zgodnie ze specyfikacją API. Secret Hash nadal musi pozostać bezpieczny po stronie serwera.

Jak SDK obsługuje IPN?

Biblioteka pomaga zweryfikować podpis danych IPN i odczytać powiadomienie. Status zamówienia zmieniaj dopiero po poprawnej weryfikacji.

Jakich danych potrzebuję z Panelu dpay?

Potrzebujesz danych Punktu Płatności, przede wszystkim nazwy serwisu i Secret Hash. Pełne wymagania dla biblioteki znajdują się w jej dokumentacji.

Czy SDK dpay działa z Laravel i Symfony?

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.

Jakie wymagania ma SDK PHP?

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

Wszystkie metody PHP SDK w jednym miejscu.

Sprawdź instalację, pełne przykłady, obsługę IPN, błędy i pozostałe operacje dostępne w bibliotece.