Krok 1: Przygotowanie konta
Najpierw zaloguj się na swoje konto w Przelewy24 i zweryfikuj, czy masz aktywowany dostęp do API. Bez tego cała operacja to jak jazda autem bez silnika – nie pojedzie. Jeśli czegoś brakuje, od razu zgłoś się do supportu, bo czekanie to strata czasu, a w e‑commerce każda sekunda ma swoją wartość.
Krok 2: Pobranie kluczy API
W panelu przejdź do „Ustawienia → API”, tam znajdziesz dwa niezbędne elementy – Merchant ID i CRC (klucz szyfrujący). Traktuj je jak złoto, nie zapisuj w otwartym pliku tekstowym, a już na pewno nie wrzucaj do repozytorium publicznego. Najlepiej użyj zmiennych środowiskowych; w ten sposób twój kod pozostanie czysty i bezpieczny.
Krok 3: Wtyczka vs własny kod
Jeśli korzystasz z gotowych platform – WooCommerce, PrestaShop, Magento – istnieją dedykowane wtyczki, które „podstawiają” Przelewy24 w kilka kliknięć. Wtyczka? Prosto, szybka, ale ograniczona. Własny kod? Elastyczny, ale wymaga solidnej znajomości PHP/Node/… i odrobiny cierpliwości. Ostatecznie wybór zależy od twojej strategii: Chcesz błyskawicznie uruchomić sklep? Wtyczka. Chcesz pełną kontrolę nad płatnościami i wyglądem? Kod.
Implementacja wtyczki – szybki start
Instalujesz, wklejasz Merchant ID i CRC, włączasz tryb testowy i sprawdzasz, czy przycisk „Zapłać z Przelewy24” pojawia się w koszyku. Nie zapomnij przełączyć na tryb produkcyjny po pozytywnych testach – to kluczowe, inaczej klienci będą płacić w „trybie pilota”.
Własny kod – krok po kroku
Najpierw tworzysz endpoint „/checkout”, który zbiera dane zamówienia, generuje token i wysyła żądanie POST do https://sandbox.przelewy24.pl/api/v1/transactions. Następnie odbierasz odpowiedź, wyciągasz URL płatności i przekierowujesz klienta. Po powrocie z Przelewy24 obsługujesz callback, weryfikujesz status i aktualizujesz zamówienie w bazie. To nie bajka, ale daje pełną kontrolę nad każdym detalem.
Krok 4: Testy i uruchomienie
Nie ma nic gorszego niż “nasz serwer odpalił” i nagle okazało się, że płatność nie przechodzi. Dlatego najpierw testuj w trybie sandbox, używając kart testowych dostarczonych przez Przelewy24. Sprawdź każdy scenariusz: sukces, odrzucenie, anulowanie. Następnie przetestuj webhook, bo bez tego nie dostaniesz potwierdzenia o zakończeniu transakcji.
Ostateczna wskazówka
Gdy wszystko działa, włącz „Live” i zadbaj o monitorowanie logów – to pozwoli wyłapać nieprzewidziane błędy zanim klient się zdenerwuje. I pamiętaj: przelewy24zaklady.com oferuje wsparcie techniczne, więc nie krępuj się zadzwonić, gdy coś nie gra.
