Przejdź do treści

SDK dpay · Node.js

Płatności online w Node.js i TypeScript z gotowym SDK dpay.

Zainstaluj oficjalny pakiet przez npm i dodaj płatności do backendu Node.js 20+. Biblioteka ma komplet typów TypeScript, obsługuje ESM i CommonJS, nie ma zależności runtime oraz automatyzuje checksum i IPN.

Otwórz dokumentację SDKZapytaj o integrację
  • Oficjalna biblioteka dpay
  • Automatyczne sumy kontrolne
  • Weryfikacja IPN
  • Spójna obsługa błędów

Instalacja

Node.js
npm
npm install @dpayglobal/dpay-node-sdk
Wymagania
Node.js 20+
Ekosystem
npm

Krótka odpowiedź

Jak dodać płatności online w Node.js i TypeScript?

Zainstaluj @dpayglobal/dpay-node-sdk przez npm, utwórz DPayClient z danymi Punktu Płatności i wywołaj asynchroniczną rejestrację transakcji. Użytkownika przekieruj na zwrócony adres, a status płatności zapisuj dopiero po poprawnej weryfikacji powiadomienia IPN.

Ekosystem backendu

Płatności Node.js w NestJS, Express i Fastify.

SDK jest napisane w TypeScript, zawiera deklaracje typów i działa zarówno jako ESM, jak i CommonJS. Jedną instancję klienta możesz współdzielić w warstwie serwisowej backendu.

01

NestJS

Zarejestruj DPayClient jako provider i wstrzykuj go do serwisu checkoutu, zwrotów oraz obsługi IPN.

02

Express i Fastify

Utwórz klienta podczas startu aplikacji i udostępnij go handlerom odpowiedzialnym za cykl płatności.

03

TypeScript lub JavaScript

Pakiet zawiera typy TypeScript, a jednocześnie obsługuje import ESM oraz require w CommonJS.

Warstwa integracyjna

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

Biblioteka Node.js 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 Node.js.

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

typescript
import {DPayClient} from "@dpayglobal/dpay-node-sdk";

const dpay = new DPayClient({
    service: "service_name",
    secretHash: "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.

Płatności PHP – SDK
SDK PHP
Płatności Python – SDK
SDK Python
Płatności Java – SDK
SDK Java
Płatności Go (Golang) – SDK
SDK Go
Płatności Ruby – SDK
SDK Ruby

FAQ dla integratora

Zanim napiszesz pierwszą linię.

Jak dodać płatności online w Node.js?

Zainstaluj pakiet poleceniem „npm install @dpayglobal/dpay-node-sdk”, utwórz klienta z nazwą serwisu i Secret Hash, a następnie wywołaj metodę rejestracji płatności zgodnie z dokumentacją Node.js 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 działa w JavaScript i TypeScript?

Tak. Biblioteka jest napisana w TypeScript i zawiera pełne deklaracje typów, ale może być używana również w aplikacjach JavaScript.

Czy pakiet obsługuje ESM i CommonJS?

Tak. SDK jest dystrybuowane w obu formatach. Wszystkie metody wykonujące żądania są asynchroniczne i zwracają Promise.

Pełna dokumentacja

Wszystkie metody Node.js SDK w jednym miejscu.

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

Przejdź do dokumentacji SDKKod źródłowy na GitHubie