Parametry techniczne Przelewy24 API
5 sposobów automatyzacji z Przelewy24 API
Poniżej znajdziesz konkretne zastosowania Przelewy24 API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Integracja bramki płatniczej z własną platformą lub CRM
POST /api/v1/transaction/register tworzy sesję płatności z kwotą, opisem i URL powrotnym. Klient jest przekierowywany na stronę Przelewy24 i wybiera metodę. Po płatności P24 wysyła webhook (IPN notification) na Twój endpoint z statusem i danymi transakcji — automatyzacja weryfikuje podpis i aktualizuje status zamówienia w bazie.
POST /api/v1/transaction/registerPOST /api/v1/transaction/verifyGET /api/v1/transaction/{sessionId}Automatyczna weryfikacja i potwierdzenie płatności (IPN)
Każda udana płatność generuje webhook IPN od P24. Make lub własny serwer odbiera notyfikację, weryfikuje podpis SHA384 (orderId + sessionId + amount + merchantId + salt), wywołuje POST /api/v1/transaction/verify i w przypadku sukcesu — wyzwala dalsze akcje: wystawia fakturę, wysyła dostęp do produktu, aktualizuje CRM.
POST /api/v1/transaction/verifyGET /api/v1/transaction/{sessionId}/statusAutomatyczne zwroty i refundy
Gdy klient zgłasza zwrot w helpdesku (Freshdesk, Intercom), agent klika "Refund" w panelu obsługi. Automatyzacja (Make) wywołuje POST /api/v1/refund z orderId i kwotą. P24 zwraca pieniądze na konto kupującego, Make aktualizuje status zgłoszenia i wysyła potwierdzenie e-mail — bez manualnego logowania do panelu P24.
POST /api/v1/refundGET /api/v1/refund/{refundId}Raportowanie transakcji i rozliczenia dzienne w Google Sheets
Codziennie o 23:00 skrypt pobiera listę transakcji (GET /api/v1/transactions?dateFrom=&dateTo=), agreguje po statusie (success/pending/failed), kwocie i metodzie płatności i zapisuje do Google Sheets. Księgowość dostaje gotowe zestawienie bez eksportów CSV z panelu.
GET /api/v1/transactionsGET /api/v1/reports/settlementsŁączenie płatności P24 z fakturownią — automatyczna faktura po wpłacie
Webhook IPN od P24 → Make → POST /invoices.json w Fakturowni: w ciągu sekund od wpłaty klient dostaje fakturę na e-mail. Dane kupującego (imię, e-mail, ewentualnie NIP) są przekazywane w polu description lub custom params podczas rejestracji transakcji.
POST /api/v1/transaction/registerPOST /api/v1/transaction/verifyKluczowe endpointy Przelewy24 API
Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez Merchant ID + API Key (Basic Auth lub podpis SHA384).
/api/v1/transaction/register
Zarejestruj transakcję — zwraca token do przekierowania klienta
/api/v1/transaction/verify
Zweryfikuj i potwierdź płatność (wymagane po IPN)
/api/v1/transaction/{sessionId}
Sprawdź status transakcji
/api/v1/refund
Wykonaj zwrot środków
/api/v1/transactions
Lista transakcji z filtrowaniem po dacie i statusie
/api/v1/payment-methods
Dostępne metody płatności (BLIK, przelewy, karty...)
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla Przelewy24 API dokumentację techniczną znajdziesz na https://developers.przelewy24.pl.
Przykładowy przepływ: Przepływ: Formularz zamówienia → P24 → IPN → Faktura → Dostęp do produktu
- Klient wypełnia formularz zamówienia na stronie (imię, e-mail, NIP, produkt)
- Backend rejestruje transakcję: POST /api/v1/transaction/register z kwotą i opisem
- Klient jest przekierowywany na P24 i płaci BLIK-iem lub kartą
- P24 wysyła IPN (webhook) na endpoint Make z orderId, sessionId, amount
- Make weryfikuje podpis SHA384 i wywołuje POST /api/v1/transaction/verify
- Po sukcesie Make tworzy fakturę w Fakturowni (POST /invoices.json)
- Make wysyła klientowi e-mail z fakturą i linkiem dostępowym do produktu/usługi
- Make aktualizuje CRM (HubSpot) — deal przechodzi do etapu "Opłacony"
Jak JustAutomate wdraża integracje Przelewy24
W projektach JustAutomate integracja Przelewy24 API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.
W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą Przelewy24 z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.
Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.
Jeśli chcesz zintegrować Przelewy24 ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o Przelewy24 API
Jak skonfigurować IPN (webhook) w Przelewy24?
W panelu P24 (Moje konto → Dane do integracji) wpisz URL swojego endpointu IPN. P24 wyśle POST z parametrami transakcji po każdej płatności. Weryfikuj podpis: SHA384(merchantId+orderId+sessionId+amount+currency+crc) gdzie CRC to tajny klucz z panelu. Odpowiedz HTTP 200 żeby P24 wiedziało że notyfikacja dotarła.
Jaka jest różnica między P24 sandbox a produkcją?
Sandbox: sandbox.przelewy24.pl (osobne Merchant ID, brak rzeczywistych płatności). Produkcja: secure.przelewy24.pl. Endpoint API: /api/v1/ jest identyczny, różni się tylko bazowy URL. W sandboxie dostępne są testowe BLIK-i i karty z dokumentacji P24.
Czy P24 obsługuje płatności cykliczne (subskrypcje)?
Tak — P24 ma moduł płatności cyklicznych (P24Token). Pierwsza transakcja tokenizuje kartę klienta, kolejne obciążenia (POST /api/v1/transaction/register z parametrem recurring) nie wymagają ponownego przekierowania. Dla subskrypcji SaaS to kluczowa funkcja.
Jak obsłużyć różne waluty w P24?
Przelewy24 obsługuje PLN (podstawowa), EUR, USD, GBP i inne. Walutę podajesz w polu currency przy rejestracji transakcji. Konwersja jest po stronie P24 — kupujący widzi cenę w swojej walucie. Raportowanie możliwe z podziałem na walutę.
Czy mogę integrować P24 przez Make bez programowania?
Make ma natywny moduł Przelewy24 — możesz rejestrować transakcje i odbierać webhooki bez kodu. Dla scenariuszy wymagających weryfikacji podpisu IPN lub złożonej logiki (zwroty warunkowe, wieloetapowe potwierdzenia) potrzebny jest własny serwer lub moduł HTTP w Make z funkcją SHA384.
Potrzebujesz integracji Przelewy24
w swoich procesach?
Budujemy integracje Przelewy24 API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.