Konfiguracja

Po rejestracji i weryfikacji konta musisz utworzyć serwis płatniczy, aby móc przyjmować płatności.

Czym jest serwis płatniczy?

Punkt płatności to logiczna jednostka w panelu dpay.pl reprezentująca Twój sklep lub usługę. Każdy serwis posiada:

• Nazwę serwisu - unikalną nazwę używaną w wywołaniach API (pole service lub name)
• Klucz Hash - klucz prywatny do generowania checksum (SHA-256)
• Włączone kanały płatności - metody płatności dostępne dla klientów

Krok 1: Utworzenie punktu płatności

1. Zaloguj się do panel.dpay.pl.
2. Przejdź do sekcji Punkty Płatności > Serwisy w menu bocznym.
3. Kliknij Dodaj nowy serwis.
4. Wypełnij formularz:

Pole	Opis	Wymagania
Nazwa serwisu	Przyjazna nazwa Twojego serwisu	5-30 znaków
Adres URL serwisu	Adres Twojej witryny	Pełny adres URL
Adres URL regulaminu	Link do regulaminu sklepu/usługi	Pełny adres URL
Adres URL reklamacji	Link do strony reklamacji	Pełny adres URL

5. Wybierz kanały płatności (przełączniki):
   • PaySafeCard
   • BLIK BNPL
   • PayPo
   • Twisto
   • PayPal
   • Karty płatnicze
   • Raty
6. Kliknij Zapisz.

informacja

Nowo utworzony serwis ma status nieaktywny i oczekuje na weryfikację przez zespół dpay. Po zatwierdzeniu status zmieni się na aktywny i będzie można przyjmować płatności.

Krok 2: Pobranie klucza Hash

Klucz Hash to klucz prywatny niezbędny do generowania sum kontrolnych (checksum). Aby go pobrać:

1. Przejdź do Punkty Płatności > Serwisy.
2. Kliknij na wybrany serwis.
3. Zjedź na dół
4. Znajdziesz tam:
   • Nazwa serwisu: np. abc123
   • Klucz Hash (SHA-256): wygenerowany automatycznie

Klucz Hash możesz w dowolnym momencie wygenerować ponownie - pamiętaj, że po regeneracji poprzedni klucz przestaje działać.

Chroń klucz Hash

Nigdy nie udostępniaj klucza Hash publicznie, nie umieszczaj go w kodzie frontendowym ani w repozytorium kodu. Przechowuj go w zmiennych środowiskowych serwera.

Przykładowe zmienne środowiskowe (.env)

DPAY_SERVICE=abc123
DPAY_HASH=9a8b7c6d5e4f3a2b1c0d...

Krok 3: Tryb testowy

W ustawieniach punktu płatności dostępny jest przełącznik trybu testowego:

• Pozwala testować integrację bez obciążania prawdziwych kont
• Transakcje w trybie testowym nie generują rzeczywistych obciążeń
• Przełącz na tryb produkcyjny, gdy integracja będzie gotowa

Krok 4: Konfiguracja IPN retry

Mechanizm ponownych prób dostarczenia IPN (Instant Payment Notification):

• Wykonuje do 10 prób ponownego dostarczenia powiadomienia IPN w przypadku braku odpowiedzi
• Status dostarczenia IPN możesz monitorować w historii transakcji w panelu

Adresy URL callback

Adresy URL (success, fail, IPN) podajesz per transakcja w każdym żądaniu API - nie konfiguruje się ich globalnie na serwisie. Szczegóły znajdziesz w rozdziale Rejestracja transakcji.

Co dalej?

Konfiguracja gotowa! Przejdź do Rejestracja transakcji, aby wykonać swoją pierwszą transakcję przez API.