Witamy w dokumentacji dpay.pl
dpay.pl to nowoczesna bramka płatnicza stworzona z myślą o polskich i międzynarodowych instytucjach. Umożliwia szybką integrację z najpopularniejszymi metodami płatności, oferując proste API REST oraz gotowe rozwiązania.
Dlaczego dpay.pl?
- Szybka integracja - minimalna ilość kodu potrzebna do uruchomienia płatności
- Elastyczność - od prostego przekierowania po pełną integrację server-to-server
- Bezpieczeństwo - szyfrowanie RSA, weryfikacja checksum, zgodność z PCI DSS
- Wiele metod płatności - BLIK, przelewy bankowe, karty, Google Pay, Apple Pay, MB WAY, Bizum i więcej
- IPN (Instant Payment Notification) - automatyczne powiadomienia o statusie transakcji w czasie rzeczywistym
- Wsparcie techniczne - dedykowany panel administracyjny na panel.dpay.pl
- Dynamic Currency Conversion - karty zagraniczne mogą zapłacić w walucie własnej karty (zgodne z PSD2 i CBPR2)
Architektura API
Krótkie podsumowanie najważniejszych aspektów technicznych API dpay.pl:
| Element | Wartość |
|---|---|
| Base URL (rejestracja płatności, BLIK) | https://api-payments.dpay.pl/api/v1_0/payments/ |
| Base URL (zwroty, szczegóły transakcji, banki, wypłaty) | https://panel.dpay.pl/api/v1/ |
| Base URL (DCB) | https://secure.dpay.pl/dcb/ |
| Format danych | JSON |
| Content-Type | application/json |
| Kodowanie | UTF-8 |
| Autoryzacja | Checksum SHA-256 (nie Bearer token) - szczegóły |
| Powiadomienia | IPN - webhook HTTP POST na Twój serwer - szczegóły |
Autoryzacja przez checksum
dpay.pl nie używa tokenów Bearer ani kluczy API w nagłówkach. Zamiast tego każde zapytanie zawiera pole checksum - sumę kontrolną SHA-256 wygenerowaną z parametrów zapytania i Twojego Secret Hash. Szczegóły znajdziesz w sekcji Generowanie checksum.
Obsługiwane metody płatności
| Metoda | Typ | Waluty |
|---|---|---|
| BLIK | Kod jednorazowy | PLN |
| BLIK BNPL | Odroczona płatność | PLN |
| Przelewy bankowe (PBL) | Przekierowanie do banku | PLN |
| Karty płatnicze (Visa / Mastercard) | Online / S2S | PLN (płatność w walucie karty możliwa przez DCC) |
| Google Pay | Portfel cyfrowy | PLN |
| Apple Pay | Portfel cyfrowy | PLN |
| MB WAY | Portfel mobilny (Portugalia) | EUR |
| Bizum | Portfel mobilny (Hiszpania) | EUR |
| White-label CZ/SK | Przelewy bankowe (Czechy/Słowacja) | CZK, EUR |
| SMS Premium | SMS o podwyższonym koszcie | PLN |
| Direct Carrier Billing (DCB) | Obciążenie rachunku operatora | PLN |
Od czego zacząć?
Pierwsze kroki
- Rejestracja - załóż i zweryfikuj konto w panelu dpay.pl
- Konfiguracja - utwórz serwis płatniczy i pobierz klucz Hash
Cykl płatności
- Rejestracja transakcji - wykonaj transakcję w kilka minut
- Obsługa IPN - odbieranie i weryfikacja powiadomień o transakcjach
- Zwroty - realizacja zwrotów środków
Whitelabel
- BLIK Level 0 - bezpośrednia integracja kodu BLIK
- Płatności kartowe S2S - pełna integracja kartowa Server-to-Server
- Google Pay - natywna integracja Google Pay
- Apple Pay - integracja Apple Pay
Usługi TSP
- MB WAY - płatności mobilne w Portugalii
- Bizum - płatności mobilne w Hiszpanii
- Pay-by-link (Czechy) - banki czeskie
- Pay-by-link (Słowacja) - banki słowackie
Mikropłatności
- Direct Carrier Billing - obciążenie rachunku operatora
- SMS Premium - SMS o podwyższonym koszcie
Bezpieczeństwo
- Generowanie checksum - jak poprawnie generować sumy kontrolne
- Szyfrowanie danych kart - szyfrowanie RSA/PKCS#1
Przydatne linki
- Panel administracyjny
- Status systemu
- API Base URL (rejestracja płatności, BLIK):
https://api-payments.dpay.pl/api/v1_0/payments/ - API Base URL (zwroty, szczegóły, banki, wypłaty):
https://panel.dpay.pl/api/v1/ - FAQ - najczęściej zadawane pytania