Paynow (mBank) — jak płacić: integracje i funkcje

Paynow Sandbox to środowisko testowe, w którym po założeniu konta można sprawdzać płatności Paynow.¹
Zobaczysz tu, jak płatność wygląda oczami kupującego i na co mały sklep powinien zwrócić uwagę przy integracji. Chodzi przede wszystkim o statusy zamówień i obsługę zwrotów. Sklep musi przy tym rozróżniać dwa środowiska Paynow: testowe Sandbox i produkcyjne².

Czym jest Paynow Sandbox dla kupującego i małego sklepu?

Mały sklep może prześledzić zamówienie w środowisku testowym, zanim uruchomi płatności produkcyjne. Najpierw łączy integrację z kontem testowym, potem sprawdza status zamówienia.
Kupujący widzi przebieg checkoutu, czyli finalizacji zakupu; sklep kontroluje ustawienia i powiadomienia. Dokumentacja API opisuje siedem statusów płatności, które warto uwzględnić podczas takich prób³.

Dostęp do Paynow Sandbox: skąd wziąć dane i gdzie je wpisać?

Klucze uwierzytelniające do Paynow Sandbox są w panelu środowiska testowego, w sekcji „Ustawienia → Sklepy i punkty płatności → Dane uwierzytelniające”.⁴
W integracji sklepu BestSeller z Paynow klucz dostępu do API trafia do pola „Klucz API”, a klucz obliczania podpisu do pola „Secret”.¹ Dzięki tym danym sklep łączy się z operatorem; kupujący nie podaje ich przy płatności. Konfiguracja środowiska testowego wymaga dwóch osobnych kluczy: klucza API i klucza obliczania podpisu⁴.

Płatność próbna oczami kupującego: jak przejść przez zamówienie?

W Paynow Sandbox można przejść od koszyka do wyniku próbnego zamówienia. Widać wtedy również, jaki komunikat sklep wyświetla po płatności.
Dokumentacja integracji zaleca sprawdzenie dwóch ścieżek płatności: pozytywnej i negatywnej².

• Środowisko Paynow w integracji Publigo trzeba wybrać przed próbą zakupu, ponieważ środowiska sandbox mają różne adresy.⁵
• Tryb testowy w sklepie BestSeller musi odpowiadać środowisku, w którym utworzono konto Paynow.¹
• Zamówienie próbne pozwala przejść przez checkout i porównać komunikat dla kupującego ze statusem w panelu sklepu.

Wtyczka Paynow dla OpenCart obsługuje konfigurację środowiska testowego w OpenCart od wersji 3.0.⁴
Próba obejmuje całą ścieżkę zamówienia, nie tylko ekran płatności. Plik composer.json tej wtyczki wskazuje PHP 5.4 jako minimalną wymaganą wersję⁶.

Powiadomienia Paynow: jak je ustawić i odczytać status płatności w sklepie?

Powiadomienia Paynow przekazują sklepowi informacje o płatności. Sam powrót kupującego na stronę sklepu nie zastępuje odczytu statusu zamówienia.
W panelu Paynow dla integracji z Publigo należy ustawić adres powrotu oraz adres powiadomień.⁵ Pierwszy prowadzi kupującego ze strony płatności do sklepu, drugi pozwala sklepowi odebrać informację. Przed uznaniem zamówienia za opłacone trzeba odczytać jego status. Integracja z Publigo wymaga dwóch oddzielnych adresów URL: adresu powrotu i adresu powiadomień⁷.

Nieudany test: co sprawdzić w ustawieniach płatności i sklepu?

Nieudana próba w Paynow Sandbox to sygnał, by sprawdzić środowisko, klucze i wymagania wtyczki. Wtyczka Paynow dla WooCommerce przewiduje komunikat o niepoprawnym formacie klucza dostępu do API sandboxa.⁸ Wtyczka Pay by paynow.pl z ustawieniami środowiska testowego wymaga co najmniej PHP 7.2.⁸ Komunikat o kluczu dotyczy danych integracji, a wymóg PHP – środowiska działania wtyczki. Wymagania wtyczki Paynow dla WooCommerce wskazują co najmniej wersję PHP 7.2⁹.

Kontrola tych ustawień pomaga ustalić, czy problem leży w konfiguracji sklepu. Pozwala też oddzielić go od tego, co kupujący widzi podczas składania zamówienia. To dwa różne etapy tej samej próby.

Paynow Sandbox a prawdziwa płatność: różnice ważne dla kupującego

Paynow Sandbox służy do próbnego przejścia przez płatność, a środowisko produkcyjne Paynow – do obsługi rzeczywistego zakupu. Ekran finalizacji może wyglądać podobnie, ale skutek finansowy jest inny.
Sklep powinien odróżnić zamówienie próbne od zamówienia klienta, które trzeba zrealizować. W sandboxie od kupującego pobierane jest 0 zł; płatność produkcyjna oznacza rzeczywistą transakcję finansową¹⁰.

Tabela zestawia cel płatności próbnej i rzeczywistej. Pokazuje też skutek dla kupującego oraz sposób obsługi zamówienia. Te różnice decydują o tym, czy sklep może rozpocząć realizację zakupu.

Skutek finansowy ma znaczenie dla realizacji zamówienia: wynik próby nie dowodzi, że klient zapłacił za towar.
Sprzedawca powinien kierować się statusem prawdziwego zamówienia w środowisku produkcyjnym. Spośród opisanych statusów API tylko jeden, CONFIRMED, oznacza potwierdzone opłacenie zamówienia³.

Środowisko testowe pozwala sprawdzić ścieżkę zakupu. Nie służy jednak do przyjmowania zapłaty od klienta. Do obsługi i realizacji prawdziwego zakupu potrzebna jest płatność produkcyjna.

Moduł pay-now/paynow-magento2: miejsce Magento 2 w integracji Paynow

pay-now/paynow-magento2 to moduł integracji Paynow dla sklepów działających na Magento 2, nie osobna metoda płatności dla kupującego. Nazwa wskazuje platformę sklepową, ale nie mówi, czy sklep używa sandboxa, czy przyjmuje rzeczywiste płatności.
Mała firma dobiera integrację do platformy swojego sklepu. Kupującego interesują zaś przebieg płatności i status zamówienia. Moduł Magento nie zastąpi integracji dla innej platformy. Dokumentacja modułu pay-now/paynow-magento2 wskazuje Magento 2.0 jako minimalną wymaganą wersję platformy¹¹.

Najczęściej zadawane pytania

Czy negatywny wynik próby zawsze oznacza błąd integracji?

Nie. Dokumentacja zaleca sprawdzenie zarówno pozytywnej, jak i negatywnej ścieżki płatności.

Czy każdy z siedmiu statusów Paynow oznacza potwierdzone opłacenie?

Nie. Spośród opisanych statusów API tylko CONFIRMED oznacza potwierdzone opłacenie zamówienia.

Czy wymaganie PHP 7.2 dotyczy każdej integracji Paynow?

Nie. Dotyczy wtyczki Pay by paynow.pl dla WooCommerce; plik composer.json wtyczki OpenCart wskazuje PHP 5.4 jako minimum.

Czy informacja o OpenCart 3.0 oznacza minimalną wersję PHP?

Nie. OpenCart 3.0 to minimalna wersja platformy obsługującej konfigurację testową, a PHP 5.4 wskazano osobno jako minimum w composer.json.

Ceny i warunki sprawdzone u źródeł: październik 2026.