Paynow (mBank) — jak działa: integracje

Paynow Sandbox to środowisko testowe bramki płatniczej, do którego dostęp uzyskasz po rejestracji w panelu sandbox.¹ Ten poradnik prowadzi przez konfigurację integracji, płatność testową i sprawdzenie wyniku transakcji. Pokazuje też, od czego zacząć diagnozowanie typowych problemów.
Płatność w Paynow Sandbox pobiera 0 zł rzeczywistych środków, bo testy nie są rzeczywistymi transakcjami finansowymi.²

Jak uzyskać dane dostępowe i skonfigurować integrację z Paynow Sandbox?

Integrację z Paynow Sandbox zacznij od pobrania kluczy z panelu środowiska testowego. Następnie wpisz je w ustawieniach sklepu.
Dokładny zakres ustawień zależy od używanej wtyczki lub platformy.³

• Konto testowe Paynow dla BestSeller załóż w środowisku testowym, a w sklepie wybierz odpowiadający mu tryb testowy.⁴
• Klucze Paynow Sandbox pobierz z panelu środowiska testowego, z sekcji Ustawienia > Sklepy i punkty płatności > Dane uwierzytelniające.¹
• Wtyczkę Paynow dla WooCommerce skonfiguruj przy użyciu klucza dostępu do API oraz klucza obliczania podpisu.¹
• Integrację Publigo z Paynow ustaw, wybierając środowisko i wpisując klucz API. Każde środowisko sandbox ma inny adres.⁵
• Adres powrotu i adres powiadomień dla integracji z Publigo ustaw w panelu Paynow.⁵

Dane uwierzytelniające oraz ustawienia sklepu muszą wskazywać to samo środowisko testowe. W przeciwnym razie konfiguracja nie będzie spójna.
Integracja wymaga dwóch odrębnych kluczy: Api-Key i Signature-Key.⁶

Jak wykonać testową płatność w Paynow Sandbox?

Test płatności w Paynow Sandbox zaczyna się od zamówienia w sklepie, prowadzi na stronę płatności i kończy powrotem do sklepu. Przeprowadź go na integracji ustawionej na środowisko testowe.
Test BLIK wymaga sześciocyfrowego kodu; kod 111111 symuluje płatność zakończoną pomyślnie.⁶

• Zamówienie testowe utwórz w sklepie, a potem przejdź do wyboru płatności.
• Paynow wybierz jako sposób opłacenia zamówienia i otwórz stronę płatności.
• Metodę płatności wybierz spośród opcji na stronie testowej. Jeśli chcesz sprawdzić BLIK i jest on dostępny, wybierz właśnie tę metodę.
• Przebieg płatności dokończ według instrukcji na stronie testowej. Na koniec wróć do sklepu.

Test pozwala sprawdzić, czy kupujący przejdzie od zamówienia do strony Paynow, a następnie wróci do sklepu. To jednak tylko część ścieżki płatności.
Podczas tworzenia płatności możesz przekazać jeden adres powrotu kupującego w opcjonalnym polu continueUrl.⁷

Czym jest Paynow Sandbox i do czego służy?

Paynow Sandbox jest testowym środowiskiem integracyjnym Paynow. Służy do sprawdzenia połączenia sklepu z procesem płatności i prześledzenia drogi od zamówienia do powrotu kupującego.
Starsza, nieutrzymywana wersja 1 API opisuje tworzenie płatności testowej pod adresem POST /v1/payments.⁸

Paynow to usługa płatnicza powiązana z mBankiem, a sandbox jest środowiskiem integracyjnym, nie osobną metodą płatności. W teście odróżnij przekierowanie kupującego od powiadomienia o transakcji. Powrót do sklepu nie zastępuje informacji, na podstawie której sklep aktualizuje zamówienie.
Integracja używa dwóch odrębnych kanałów: continueUrl do powrotu kupującego oraz notificationUrl do powiadomień o płatności.⁹

Paynow Sandbox pozwala sprawdzić całą ścieżkę zamówienia, nie tylko wygląd strony płatności. Warto więc obserwować także to, co dzieje się po powrocie kupującego do sklepu.
Dokumentacja API wymienia siedem statusów płatności, które sklep może uwzględnić w testach.¹⁰

Jak sprawdzić wynik transakcji testowej w Paynow Sandbox?

Wynik testu w Paynow Sandbox oceń, zestawiając status płatności ze stanem zamówienia w sklepie. Sam powrót kupującego nie oznacza, że sklep zarejestrował wynik transakcji.
Odebranie powiadomienia sklep potwierdza pustą odpowiedzią HTTP 200 OK lub 202 Accepted.⁶

• Status płatności odczytaj dla transakcji testowej i zapisz jej identyfikator.
• Stan zamówienia porównaj ze statusem tej samej płatności. Oba wpisy muszą odnosić się do jednego zamówienia.
• Powiadomienie o płatności sprawdź, jeśli stan zamówienia nie zgadza się z wynikiem transakcji. Ustal, czy sklep odebrał informację potrzebną do aktualizacji zamówienia.
• Zwrot płatności wykonuj wyłącznie dla transakcji ze statusem CONFIRMED. Suma zwrotów nie może przekroczyć kwoty płatności.¹¹

O wyniku testu świadczy zgodność statusu transakcji ze stanem zamówienia. Samo przekierowanie kupującego nie wystarczy.
Poprawna odpowiedź na żądanie GET sprawdzające status płatności ma kod HTTP 200.¹²

Dlaczego płatność lub integracja w Paynow Sandbox nie działa?

Przy diagnozowaniu problemu w Paynow Sandbox najpierw ustal, czy nie powiodła się płatność, czy zwrot. Zwrot może się nie udać przez kwotę poniżej minimum, niewłaściwy status albo niewystarczające saldo. Dopiero potem porównaj parametry operacji z ograniczeniami Paynow.
Minimalna kwota zwrotu płatności BLIK wynosi 0,01 zł, ponieważ BLIK należy do metod innych niż karta.¹¹

Zwrot oczekujący zmienia status na CANCELLED, jeśli w domyślnym terminie 120 godzin na saldzie nie zbiorą się środki potrzebne do jego realizacji.¹¹
Anulować można tylko zwrot o statusie NEW.¹¹

Tabela zestawia minimalne kwoty zwrotu Paynow według metody płatności. Dla karty minimum wynosi 1 zł, a dla BLIK 0,01 zł.¹¹

Dane w tabeli: 11

Przy diagnozowaniu zwrotu w Paynow sprawdź metodę płatności, kwotę, status oraz saldo. Każdy z tych elementów może mieć znaczenie dla wyniku operacji.
Łączna kwota zwrotów nie może przekroczyć 100% wartości pierwotnej płatności.¹¹

Najczęściej zadawane pytania

Czy Paynow Sandbox jest osobną metodą płatności?

Nie. To środowisko integracyjne Paynow, a nie metoda płatności.

Czy test w Paynow Sandbox pobiera rzeczywiste pieniądze?

Nie. Testowa płatność pobiera 0 zł rzeczywistych środków.

Czy endpoint POST /v1/payments opisuje aktualną wersję API?

Nie. To starsza, nieutrzymywana wersja API.

Czy można anulować zwrot o dowolnym statusie?

Nie. Anulować można tylko zwrot ze statusem NEW.

Co stanie się z oczekującym zwrotem, jeśli na saldzie zabraknie środków?

Jeśli środki nie zbiorą się w domyślnym terminie 120 godzin, status zwrotu zmieni się na CANCELLED.

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