Przejdź do treści
imoje w WooCommerce: jak skonfigurować i przetestować płatności

imoje w WooCommerce: jak skonfigurować i przetestować płatności

Opublikowano: 16 października 2026| Zaktualizowano: 16 października 2026

Płatność może zostać potwierdzona przez operatora, choć zamówienie w sklepie nadal czeka na zapłatę. Pokażemy, jak przejść przez integrację etapami i rozpoznać, w którym miejscu przepływu pojawił się problem. Od 1 lipca 2026 bramka imoje działa pod nazwą ING Pay.

Krótka odpowiedź

Zainstaluj oficjalną wtyczkę ING Pay (imoje), pobierz dane integracyjne dla właściwego sklepu i środowiska, a następnie wykonaj pełną macierz testów w sandboxie. W panelu operatora dane znajdziesz w ścieżce Sklepy > Szczegóły > Dane do integracji.

Wersja 4.16.1 wtyczki była widoczna w katalogu WordPress.org podczas weryfikacji 15 października 2026; przed instalacją sprawdź bieżące wydanie i wymagania.

Usługi KC Mobile

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „imoje w WooCommerce: jak skonfigurować i przetestować płatności”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.

Co przygotować przed integracją imoje z WooCommerce?

Przed zmianą konfiguracji przygotuj dostępy, kopię zapasową i informacje o wersjach sklepu. Potrzebujesz konta administratora WordPress, dostępu do panelu ING Pay, witryny działającej przez HTTPS oraz możliwości odtworzenia bazy i plików. Zanotuj wersje WordPressa, WooCommerce, PHP, motywu i wtyczek, które modyfikują koszyk lub checkout.

Elementy i kontrole przed instalacją płatności ING Pay
ElementKontrola przed instalacjąPo co ją wykonać
Usługa ING PaySklep i wymagane metody płatności są aktywneWtyczka nie włączy metod nieudostępnionych dla danego sklepu
Dane dostępoweOtwiera się panel ING Pay i zakładka z danymi integracjiPozwala pobrać dane przypisane do właściwego sklepu
Wersje oprogramowaniaZapisano wersje WordPress, WooCommerce, PHP i modułuUłatwia sprawdzenie zgodności i późniejszą diagnozę
Kopia zapasowaBackup plików i bazy da się odtworzyćUmożliwia cofnięcie nieudanej zmiany
HTTPS i domenaStrona, checkout i powrót z płatności używają właściwej domeny i HTTPSOgranicza problemy z sesją oraz przekierowaniem

Wykonuj zmiany na środowisku testowym lub w oknie serwisowym, jeśli sklep przyjmuje zamówienia. Klucze i tokeny przechowuj wyłącznie w konfiguracji wtyczki i panelu operatora. Nie umieszczaj ich w publicznym repozytorium, kodzie motywu, zrzutach ekranu ani zgłoszeniu do pomocy technicznej.

Czytasz poradnik „imoje w WooCommerce: jak skonfigurować i przetestować płatności”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny. Omów temat tego poradnika

Jak zainstalować i włączyć właściwą wtyczkę?

Użyj modułu wskazanego przez ING, a nie wtyczki o podobnej nazwie od nieznanego autora. Oficjalna wtyczka ING Pay (imoje) w katalogu WordPress.org obsługuje płatności dla WooCommerce, a jej rejestr zmian pokazuje wydania i poprawki. Wersja 4.16.1 widniała w katalogu w dniu weryfikacji, 15 października 2026; wymagania WordPressa, WooCommerce i PHP sprawdź przy instalacji, bo mogą się zmienić.

W WordPress przejdź do Wtyczki > Dodaj nową, znajdź moduł imoje autorstwa imoje i sprawdź jego szczegóły przed instalacją. Po instalacji kliknij Włącz. Jeśli ING udostępnia nowszą paczkę lub odrębną instrukcję dla sklepu, porównaj jej numer wersji z rejestrem zmian i zachowaj informację o wdrożonym wydaniu.

Następnie otwórz WooCommerce > Ustawienia > Płatności i sprawdź, czy moduł udostępnia wymagane metody oraz czy ustawienia każdej z nich można otworzyć. Oficjalny moduł zawiera kilka kanałów płatności, ale dostępność dla kupujących zależy od konfiguracji sklepu i usługi. W przypadku checkoutu blokowego lub niestandardowego motywu wykonaj próbę na kopii sklepu przed publikacją.

Jak skonfigurować dane i metody płatności?

Wprowadź komplet danych pobranych z jednego środowiska i jednego sklepu. ING wskazuje ścieżkę Sklepy > Szczegóły > Dane do integracji; wtyczka wymienia identyfikator sprzedawcy, identyfikator serwisu, klucz serwisu i token autoryzacyjny. Oficjalny moduł przekazuje adres powiadomień automatycznie, dlatego nie wpisuj adresu callbacku ze starego poradnika bez potwierdzenia w instrukcji dla aktualnego wydania.

Ustawienia integracji imoje WooCommerce i kontrole przed zapisem
UstawienieSkąd pobrać lub jak wybraćKontrola przed zapisem
Identyfikator sprzedawcyPanel ING Pay, dane integracji sklepuZgodność z nazwą sklepu, który konfigurujesz
Identyfikator serwisuPanel ING Pay, szczegóły sklepuNie łącz z kluczem przypisanym do innego sklepu
Klucz serwisuPanel ING Pay, dane integracjiWklej bez spacji i nie udostępniaj osobom postronnym
Token autoryzacyjnyPanel ING Pay, dane integracjiDobierz do środowiska testowego albo produkcyjnego
Tryb środowiskaUstawienia bramki we wtyczcePrzełącz go razem z całym zestawem danych
Waluta i metodyUstawienia WooCommerce i aktywna konfiguracja ING PayWybierz walutę obsługiwaną przez usługę

Zapisz ustawienia, a następnie sprawdź metody w checkout dla kraju, waluty i koszyka używanych przez klientów. ING publikuje instrukcję integracji ING Pay z WooCommerce oraz materiały na stronie integracji bramki. Do prób bez prawdziwych środków zarejestruj dostęp do sandboxa ING Pay. Jeśli konfigurację lub naprawę ma wykonać zespół techniczny, integracja płatności w sklepie obejmuje wdrożenie po stronie WooCommerce.

Jak ustawić statusy zamówień i komunikaty?

Status zamówienia powinien wynikać z potwierdzenia transakcji, nie z samego powrotu klienta na stronę sklepu. W WooCommerce Pending payment oznacza oczekiwanie na płatność, Processing zwykle oznacza opłacone zamówienie oczekujące na realizację, a Failed wskazuje nieudaną próbę. Dokładna zmiana zależy od odpowiedzi operatora, ustawień i wersji integracji.

Dla każdej metody ustal, co sklep ma pokazać przy płatności zakończonej, odrzuconej, anulowanej i porzuconej. Po sukcesie klient powinien dostać właściwe potwierdzenie zamówienia; przy niepowodzeniu komunikat powinien wyjaśnić następny krok, na przykład ponowienie płatności, jeżeli jest dostępne. Wiadomości sprawdzisz w WooCommerce > Ustawienia > E-maile.

Nie komunikuj klientowi, że zamówienie jest opłacone, jeśli stan transakcji nie został potwierdzony. Po jednej próbie danego scenariusza zachowaj numer zamówienia i wynik, zamiast wielokrotnie testować tę samą transakcję na koncie produkcyjnym.

Jak przeprowadzić test płatności przed startem?

Testuj cały przebieg od złożenia zamówienia do informacji o transakcji w obu panelach. Sandbox ING Pay pozwala rejestrować transakcje i zwroty bez użycia prawdziwych środków; dane scenariuszy pobieraj z bieżącej dokumentacji operatora, bo mogą ulec zmianie. Zacznij od dostępu do środowiska sandbox, a instrukcję właściwą dla WooCommerce otwórz na stronie integracji ING.

Scenariusze testów płatności WooCommerce i kryteria zaliczenia
ScenariuszDziałanieKryterium zaliczenia
Udana płatnośćZłóż zamówienie testowe i dokończ transakcję metodą wskazaną przez INGTransakcja jest widoczna w sandboxie, a zamówienie ma właściwy status
AnulowaniePrzerwij płatność zgodnie z dostępnym scenariuszem testowymZamówienie nie jest oznaczone jako opłacone
Odrzucenie lub błądUruchom scenariusz błędu przewidziany przez operatoraSklep pokazuje stan nieudany lub oczekujący zgodny z odpowiedzią
Powrót do sklepuWróć ze strony płatności po zakończeniu próbyKlient trafia do właściwego zamówienia, a komunikat odpowiada jego stanowi
PonowieniePonów płatność dla zamówienia nieopłaconegoNie powstaje drugie zamówienie ani podwójne obciążenie
Brak potwierdzeniaPrzerwij sesję po rozpoczęciu transakcjiSam powrót do sklepu nie zmienia zamówienia na opłacone

Zapisz numer zamówienia, metodę, czas i rezultat każdej próby. Wykonaj scenariusze na komputerze i telefonie, jeśli motyw, checkout lub optymalizacja skryptów różnią się między urządzeniami. Test w sandboxie potwierdza przepływ techniczny, ale nie zastępuje kontroli poprawności danych produkcyjnych.

Lista pokazuje scenariusze do sprawdzenia w sandboxie oraz wynik, który potwierdza poprawny przebieg płatności.

Jak uruchomić płatności na produkcji bez pominięcia kontroli?

Na produkcję przejdź dopiero po poprawnym teście i zamień cały zestaw danych sandbox na dane produkcyjne. Wyłącz tryb testowy, potwierdź aktywność metod, walutę, domenę HTTPS i konfigurację powiadomień zgodną z instrukcją aktualnej wersji. Sprawdź też, czy checkout pokazuje klientowi tylko metody dostępne dla jego kraju i waluty.

Zamówienie kontrolne wykonaj jako kontrolowane zamówienie firmowe, według uzgodnionej procedury sklepu. Przed transakcją sprawdź z operatorem ewentualny koszt transakcji oraz zwrotu, a po niej potwierdź stan w panelu ING Pay i WooCommerce. Uzgodnij z księgowością sposób ujęcia zamówienia, a zwrot wykonaj zgodnie z procedurą firmy i zasadami operatora.

Jeżeli test produkcyjny nie przebiegnie zgodnie z planem, wstrzymaj kolejne próby i najpierw ustal stan transakcji w panelu operatora. Nie proś klienta o ponowną płatność, dopóki sklep i operator nie pokażą, czy pierwsza próba została rozliczona.

Co sprawdzić, gdy płatność nie zmienia statusu zamówienia?

Gdy operator pokazuje zakończoną płatność, a zamówienie nadal ma status Pending payment, nie ponawiaj transakcji przed uzgodnieniem jej stanu. Porównaj numer zamówienia i identyfikator transakcji w WooCommerce z wpisem operatora, a potem sprawdź logi techniczne.

Objawy błędów płatności WooCommerce, możliwe przyczyny i kontrole
ObjawMożliwa przyczynaKontrola
Powrót do sklepu, status Pending paymentPłatność przerwana albo powiadomienie serwerowe nie dotarłoPorównaj status tej transakcji w panelu ING Pay
Operator potwierdza sukces, zamówienie ma stary statusBłąd powiadomienia lub obsługi odpowiedzi przez sklepSprawdź notatki zamówienia i logi WooCommerce
Błąd autoryzacji lub powrót na stronę głównąNieprawidłowy token, klucz albo pomieszane środowiskaPorównaj komplet danych z danymi integracyjnymi sklepu
Metoda nie pokazuje się w checkoutBrak wybranej waluty, metoda nieaktywna lub niezgodny checkoutOtwórz konfigurację metody i sprawdź walutę oraz checkout
Awaria po aktualizacjiZmiana zgodności modułu, WooCommerce, PHP lub rozszerzeniaOdtwórz problem na stagingu i izoluj zmianę

W WooCommerce otwórz WooCommerce > Status > Logi i wybierz log wtyczki, jeśli jest dostępny. Włącz logowanie tylko na czas diagnozy i usuń sekrety z fragmentu przekazywanego dalej. Do ING przygotuj numer zamówienia, identyfikator transakcji, datę i godzinę, status widoczny w obu systemach oraz wersję wtyczki. Nie przekazuj tokenów, kluczy, danych karty ani zbędnych danych osobowych.

Schemat prowadzi od porównania danych w ING Pay i WooCommerce do kontroli logów oraz przygotowania zgłoszenia.

Jak dbać o integrację po aktualizacji WooCommerce?

Po aktualizacji WordPressa, WooCommerce, PHP, modułu płatności lub checkoutu sprawdź rejestr zmian i wymagania wtyczki, a następnie wykonaj test na stagingu. Wystarczy powtórzyć krytyczne scenariusze: sukces, anulowanie i ponowienie, a potem sprawdzić wynik w sklepie. Numer wydania modułu i data próby pozwolą szybciej powiązać awarię z konkretną zmianą.

Perspektywa KC Mobile: problemy po aktualizacji mogą powstawać poza samym formularzem płatności, na przykład przez cache, optymalizację JavaScript lub zmianę checkoutu przez motyw. Dlatego przy zgłoszeniu rozdzielamy obserwację klienta, stan transakcji w ING Pay i stan zamówienia w WooCommerce. Strona podziękowania sama nie potwierdza, że płatność została rozliczona.

Przy okazji zmian sklepu warto zachować historię konfiguracji i wyników testów. Praktyczne ustawienia platformy opisujemy w poradniku WooCommerce w WordPressie, a automatyzacje procesów w materiale o automatyzacjach WooCommerce.

Więcej poradników w tym temacie

Wspomniane narzędzia

WooCommerceWordPressING Pay (imoje)sandbox ING Pay

Najczęściej zadawane pytania

Jak zainstalować imoje w WooCommerce?
Zainstaluj oficjalną wtyczkę imoje autorstwa imoje z katalogu WordPress.org albo paczkę wskazaną w aktualnych materiałach ING. Włącz ją w WordPress, a następnie skonfiguruj dane sklepu w WooCommerce > Ustawienia > Płatności. Nazwa bramki zmieniła się na ING Pay 1 lipca 2026.
Jak przetestować płatności imoje przed uruchomieniem sklepu?
Utwórz dostęp do sandboxa ING Pay i użyj scenariuszy testowych z aktualnej dokumentacji operatora. Sprawdź sukces, anulowanie, błąd, powrót do sklepu, ponowienie i przerwaną próbę. Sandbox pozwala zobaczyć transakcje i zwroty bez angażowania własnych środków.
Dlaczego zamówienie WooCommerce nie zmienia statusu po płatności imoje?
Najpierw ustal, czy operator potwierdza transakcję, i nie proś klienta o kolejną próbę przed tą kontrolą. Porównaj identyfikator transakcji i numer zamówienia, sprawdź notatki zamówienia oraz log wtyczki. Przyczyną może być niedostarczone powiadomienie, błędne dane środowiska albo konflikt checkoutu.
Czy integracja ING Pay działa z każdą wersją WooCommerce?
Nie zakładaj zgodności z każdą wersją. Sprawdź wymagania aktualnego wydania wtyczki i przetestuj sklep na stagingu po aktualizacji. Szczególnej kontroli wymaga checkout blokowy i niestandardowe rozszerzenia.
Jak przełączyć imoje ze środowiska testowego na produkcyjne?
Po zaliczeniu testów wyłącz tryb sandbox i wprowadź komplet danych produkcyjnych przypisanych do właściwego sklepu. Zweryfikuj HTTPS, walutę, aktywne metody i konfigurację powiadomień według aktualnej instrukcji ING. Na koniec wykonaj kontrolowane zamówienie firmowe i sprawdź ewentualne koszty transakcji oraz zwrotu z operatorem.
#imoje#ING Pay#WooCommerce#WordPress#płatności online#integracja płatności#sandbox#status zamówienia
Zdjęcie autora: Krzysztof Czapnik
O autorze

Krzysztof Czapnik

Founder & Technical Lead, KC Mobile

Projektuję i rozwijam strony WordPress, sklepy WooCommerce oraz aplikacje internetowe. Łączę projektowanie z programowaniem, integracjami i technicznym SEO. Projekty KC Mobile prowadzę osobiście.

Potrzebujesz pomocy z tym tematem? Napisz - odpowiem osobiście w 24h.

Potrzebujesz pomocy w tym temacie?

Czytasz poradnik „imoje w WooCommerce: jak skonfigurować i przetestować płatności”. Napisz, co chcesz zrobić i na jakim etapie jesteś. Ustalimy, czy możemy pomóc i jaki zakres prac będzie potrzebny.