Nieoczekiwane problemy z Przelewy24: Jak je rozwiązać?

Co się dzieje, gdy płatność nie przechodzi?

Klient wprowadza dane, klika „Wyślij”, a system milczy. Brak potwierdzenia, frustracja rośnie. To nie jest jednorazowa awaria – to sygnał, że warstwa pośrednicząca ma kryzys. Czas zerwać tę nieścisłość i przywrócić płynność.

Dlaczego serwer odrzuca transakcję?

Jednym słowem – konfiguracja. Źle ustawione klucze API, niewłaściwy endpoint albo nieaktualny certyfikat SSL. Dodatkowo, nieprzestrzeganie limitów – przelotny „rate‑limit” wywalczy blokadę. W praktyce: wolisz sprawdzić, czy Twoja aplikacja nie przekracza 5 zapytań na sekundę. Jeśli tak, przeskaluj.

Problem z autoryzacją

Tokeny wygasają szybciej niż myślisz. W Twojej logice odświeżanie ma miejsce dopiero po kilku minutach, a wcale nie wtedy, kiedy jest potrzebne. Efekt? 401 – brak dostępu. Rozwiązanie? Automatyczny refresher, który działa przy pierwszym 401 i nie czeka na kolejny request.

Luki w walidacji danych

Nie wszystkie pola są sprawdzane po stronie backendu. Numer konta w formacie „123‑456‑789” omija walidację, ale gateway odrzuca, bo oczekuje 9 cyfr. Dlatego waliduj po obu stronach – front i back. To eliminuje bałagan i niepotrzebne błędy.

Jak rozgryźć komunikaty błędów?

Przelewy24 nie zawsze wysyła “przyjazne” opisy. Czasem dostajesz jedynie kod “1002”. Nie daj się zwieść. Zmapuj kody na własną tabelkę. Przykład: 1002 = „Błąd formatu numeru karty”. Kiedy masz taką mapę, możesz natychmiast podać klientowi konkretną radę.

Co zrobić, gdy problem leży po stronie dostawcy?

Logi mówią: “service down”. To nie jest wina Twojego kodu, to awaria Przelewy24. Miej plan B – alternatywny bramnik, np. PayU, lub prosty wyświetlacz “przepraszamy, spróbuj za 5 minut”. Nie zostawiaj klienta w niepewności.

Wskazówka: monitoruj

Ustaw alerty w New Relic, Zabbix lub własnym skryptcie. Każde 5‑sekundowe opóźnienie przychodzi na Twój koszt reputacji. Reaguj natychmiast, zanim zgłoszenia się pomnożą.

Jedna praktyczna akcja – od razu

Wejdź na przelewy24zaklady.com, otwórz ustawienia API i zweryfikuj klucz i endpoint. Następnie przetestuj transakcję w trybie sandbox. Jeśli przejdzie, odśwież token i sprawdź limity. Gotowe.