Przelewy24 to bramka płatnicza obsługująca BLIK, szybkie przelewy, karty i Google Pay. Do konfiguracji potrzebujesz aktywnego konta w Przelewy24 i czterech wartości z ich panelu.
Wymagane dane z panelu P24
Zaloguj się do panelu Przelewy24, wejdź w Moje konto → Moje dane → Ustawienia → Dane API i konfiguracja.
| Pole w erphome.pl | Co to jest |
|---|---|
| Merchant ID | Numer ID sprzedawcy, znajdziesz go też w mailu „Ważne informacje" wysłanym po rejestracji konta; to jednocześnie login do panelu P24 |
| POS ID | Numer punktu sprzedaży, przy jednym sklepie zwykle taki sam jak Merchant ID |
| API Key | Klucz API z sekcji Dane API i konfiguracja, używany do weryfikacji transakcji i webhooków |
| CRC | Klucz do podpisywania transakcji, w tej samej sekcji |
Przed użyciem klucza API musisz wpisać statyczny adres IP serwera erphome.pl w polu „Adres IP" w sekcji Moje konto → Moje dane → Ustawienia → Dane API i konfiguracja, a następnie kliknąć „Zachowaj" na dole strony.
Konfiguracja w erphome.pl
Przejdź do Ustawienia → Płatności w panelu właściciela i wybierz Przelewy24 jako bramkę.
Uzupełnij pola Merchant ID, POS ID, API Key i CRC, następnie kliknij „💾 Zapisz ustawienia płatności".
Weryfikacja danych przy zapisie
Przed zapisaniem erphome.pl łączy się z API Przelewy24 i sprawdza podane dane dostępowe. Jeśli są błędne, zobaczysz komunikat „Przelewy24: … Nie zapisano, popraw dane i spróbuj ponownie." Ustawienia nie zostaną zapisane do czasu poprawienia danych. Dzięki temu literówka w kluczu nie zablokuje płatności gości po cichu.
Weryfikacja używa środowiska zgodnego z checkboxem „Tryb sandbox (testowy)", przy zaznaczonym sandboxie wpisuj dane z panelu sandbox, przy odznaczonym dane produkcyjne.
Tryb sandbox (testowy)
Sandbox to środowisko testowe P24, transakcje są symulowane, pieniądze nie są pobierane.
Jak założyć sandbox:
- Zaloguj się do swojego konta na panel.przelewy24.pl
- Przejdź do zakładki „Moje Dane"
- Wybierz opcję „konto w Sandbox", aby je utworzyć
- Dane do logowania do panelu sandbox otrzymasz w osobnej wiadomości mailowej
Po otrzymaniu maila zaloguj się do panelu sandbox i pobierz z niego dane (Merchant ID, POS ID, API Key, CRC), są inne niż produkcyjne.
W erphome.pl wpisz dane z panelu sandbox i zaznacz checkbox „Tryb sandbox (testowy)".
Sandbox ma osobne ID, CRC i klucze niż produkcja. Nie mieszaj danych między środowiskami.
Przejście z sandbox na produkcję
Gdy testy zakończone:
- W erphome.pl odznacz checkbox „Tryb sandbox (testowy)"
- Zmień dane na produkcyjne (z panel.przelewy24.pl)
- Zapisz ustawienia: to wszystko, powiadomień w panelu P24 nie musisz przestawiać (patrz niżej)
Webhook: nie musisz nic ustawiać
W Przelewy24 nie konfigurujesz ręcznie adresu powiadomień (IPN). erphome.pl przekazuje ten adres do P24 razem z każdą pojedynczą transakcją, więc bramka wywołuje webhook automatycznie, niezależnie od ustawień w Punkty sprzedaży → Powiadomienia. Rezerwacja potwierdza się sama po zaksięgowaniu wpłaty, bez dodatkowej konfiguracji po Twojej stronie.
To odróżnia Przelewy24 od PayU, gdzie adres powiadomień wpisuje się ręcznie w panelu bramki.
Weryfikacja konfiguracji
Po zapisaniu ustawień złóż rezerwację testową na swojej stronie (w trybie sandbox możesz użyć dowolnej karty testowej).
Jeśli status rezerwacji zmieni się na Potwierdzona, konfiguracja działa.
Jeśli rezerwacja zostaje ze statusem Oczekuje na płatność, najczęstszą przyczyną jest błędny API Key lub CRC, albo brak adresu IP serwera erphome.pl w sekcji Dane API i konfiguracja. Popraw dane w Ustawienia → Płatności i sprawdź wpis IP w panelu P24.
Najczęstsze pytania
Dlaczego gość zapłacił, a rezerwacja wciąż „Oczekuje na płatność"?
W Przelewy24 adresu powiadomień nie ustawiasz ręcznie, erphome.pl wysyła go z każdą transakcją, więc webhook działa automatycznie. Jeśli mimo to status się nie zmienia, sprawdź poprawność API Key i CRC w Ustawienia → Płatności oraz to, czy adres IP serwera erphome.pl figuruje w sekcji Dane API i konfiguracja w panelu P24 (bez niego P24 odrzuca weryfikację transakcji).
Dlaczego przy zapisie danych P24 pojawia się błąd i ustawienia się nie zapisują?
erphome.pl weryfikuje dane przez API Przelewy24 jeszcze przed zapisem. Literówka w kluczu API lub CRC blokuje zapis z komunikatem „Nie zapisano, popraw dane". Sprawdź też, czy checkbox sandbox pasuje do środowiska, z którego pochodzą wpisane dane.
Czym różni się tryb sandbox od produkcji?
Sandbox to środowisko testowe P24, transakcje są symulowane, pieniądze nie są pobierane. Ma osobne Merchant ID, POS ID, API Key i CRC. Nie mieszaj danych między środowiskami; przy przejściu na produkcję odznacz sandbox i wpisz dane produkcyjne. Adresu powiadomień nie przestawiasz, erphome.pl przekazuje go do P24 automatycznie z każdą transakcją.
Powiązane artykuły: Jak działają płatności online · Konfiguracja PayU · Konfiguracja Stripe · Jak działa proces rezerwacji · Płatności w rezerwacji