Ruby on Rails
Skonfiguruj klienta w bezpiecznym środowisku i wywołuj go z obiektu serwisowego odpowiedzialnego za checkout.
SDK dpay · Ruby
Płatności online w Ruby z oficjalnym SDK dpay.
Dodaj płatności do aplikacji Ruby 3.1+ przez gotowy gem dpay. SDK nie ma zależności runtime, zawiera sygnatury RBS i automatyzuje checksum, rejestrację transakcji, typowane odpowiedzi oraz IPN.
- Oficjalna biblioteka dpay
- Automatyczne sumy kontrolne
- Weryfikacja IPN
- Spójna obsługa błędów
Instalacja
Rubygem install dpay- Wymagania
- Ruby 3.1+
- Ekosystem
- RubyGems
Krótka odpowiedź
Jak dodać płatności online do aplikacji Ruby?
Zainstaluj gem dpay, utwórz DPay::Client z danymi Punktu Płatności i zarejestruj transakcję po stronie backendu. Następnie przekieruj kupującego na otrzymany adres płatności, a status zamówienia zmień dopiero po poprawnej weryfikacji IPN.
Ekosystem backendu
Płatności Ruby w Rails, Sinatra i Hanami.
SDK korzysta wyłącznie z biblioteki standardowej Ruby i zawiera sygnatury RBS. Klienta możesz umieścić w obiekcie serwisowym lub inicjalizatorze, bez uzależniania logiki płatności od frameworka.
Sinatra i Hanami
Współdziel DPay::Client w warstwie aplikacji, a endpoint IPN oddziel od przekierowania użytkownika.
RBS i Steep
Dołączone sygnatury RBS wspierają podpowiedzi edytora oraz statyczną weryfikację typów przez Steep.
Warstwa integracyjna
Elementy płatności, których nie musisz budować od zera.
Biblioteka Ruby 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 Ruby.
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
require "dpay"
dpay = DPay::Client.new(
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.
- 01
Zainstaluj bibliotekę
Dodaj oficjalny pakiet do backendu i przypnij wersję zgodnie z zasadami projektu.
- 02
Skonfiguruj klienta
Przekaż nazwę serwisu i Secret Hash wyłącznie z bezpiecznej konfiguracji serwerowej.
- 03
Zarejestruj płatność
Wyślij kwotę oraz adresy sukcesu, błędu i IPN, a klienta skieruj na otrzymany adres płatności.
- 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 Ruby?
Zainstaluj pakiet poleceniem „gem install dpay”, utwórz klienta z nazwą serwisu i Secret Hash, a następnie wywołaj metodę rejestracji płatności zgodnie z dokumentacją Ruby 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 Ruby on Rails?
Tak. SDK jest niezależnym gemem Ruby, dlatego możesz użyć go w Rails jako klienta w obiekcie serwisowym lub własnej warstwie integracyjnej.
Czy gem dpay zawiera typy RBS?
Tak. Pakiet zawiera sygnatury RBS w katalogu sig, które można wykorzystać z narzędziem Steep i podpowiedziami typów w edytorze.
Pełna dokumentacja
Wszystkie metody Ruby SDK w jednym miejscu.
Sprawdź instalację, pełne przykłady, obsługę IPN, błędy i pozostałe operacje dostępne w bibliotece.