Przejdź do treści

SDK dpay · Python

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

Zintegruj płatności w Pythonie 3.10+ przez klienta synchronicznego lub asynchronicznego. SDK udostępnia typowane obiekty, automatyczne checksum, rejestrację transakcji i weryfikację IPN.

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

Instalacja

Python
pip
pip install dpay-python-sdk

Wariant asynchroniczny

pip install "dpay-python-sdk[async]"
Wymagania
Python 3.10+
Ekosystem
pip

Krótka odpowiedź

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

Zainstaluj dpay-python-sdk przez pip, wybierz klienta synchronicznego albo AsyncDPayClient i przekaż dane Punktu Płatności z bezpiecznej konfiguracji. Po rejestracji transakcji przekieruj użytkownika na adres płatności, a status zamówienia aktualizuj na podstawie zweryfikowanego IPN.

Ekosystem backendu

Płatności Python w Django, FastAPI i Flask.

Ten sam zestaw typowanych obiektów działa z klientem synchronicznym i async. Dzięki temu warstwę płatności można dopasować do modelu wykonywania używanego przez aplikację.

01

Django

Umieść klienta dpay w warstwie usług i wywołuj go z widoku, zadania lub procesu obsługi zamówienia.

02

FastAPI

Użyj AsyncDPayClient z httpx, gdy endpointy aplikacji korzystają z asynchronicznego modelu wykonywania.

03

Flask i własne API

Klient synchroniczny korzysta z biblioteki standardowej i nie wymaga dodatkowych zależności runtime.

Warstwa integracyjna

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

Biblioteka Python 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 Python.

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

python
from dpay import DPayClient

dpay = 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 Pythonie?

Zainstaluj pakiet poleceniem „pip install dpay-python-sdk”, utwórz klienta z nazwą serwisu i Secret Hash, a następnie wywołaj metodę rejestracji płatności zgodnie z dokumentacją Python 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.

Czym różni się klient synchroniczny od AsyncDPayClient?

Oba warianty używają tych samych obiektów żądań i odpowiedzi. AsyncDPayClient udostępnia metody jako korutyny i wymaga instalacji dodatku dpay-python-sdk[async] z biblioteką httpx.

Jaki pakiet Python należy zainstalować?

Zainstaluj pakiet dpay-python-sdk. W kodzie importujesz moduł dpay; nie instaluj niepowiązanego pakietu o nazwie dpay z PyPI.

Pełna dokumentacja

Wszystkie metody Python SDK w jednym miejscu.

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