imoje (ING) — jak działa: konto

API imoje łączy sklep z płatnościami imoje. Usługa działa obecnie pod nazwą ING Pay¹. Ten poradnik wyjaśnia, jak zintegrować sklep, obsługiwać transakcje i zwroty oraz szukać przyczyn błędów.
Nazwa ING Pay obowiązuje od 1 lipca 2026 roku².

Jak podłączyć imoje przez API lub wtyczkę do WooCommerce, PrestaShop i Shopify?

Sklep połączysz z imoje przez wtyczkę do swojej platformy lub własną integrację z API. Wybór zależy od tego, czy używasz gotowego modułu, czy własnego procesu zamówień.
Oficjalna lista integracji obejmuje trzy platformy: WooCommerce, PrestaShop i Shopify³.

Platforma i sposób obsługi zamówień wyznaczają pierwszy krok konfiguracji. Poniższa tabela pokazuje, od czego zacząć dla każdego rodzaju sklepu.

Dane konfiguracyjne pobierz z panelu płatności i wpisz w pola wskazane przez wybraną integrację. Ich nazwy w sklepie mogą różnić się od tych w panelu płatności.
Oficjalna wtyczka WooCommerce wymaga czterech danych: identyfikatora sprzedawcy, identyfikatora serwisu, klucza serwisu i tokenu autoryzacyjnego⁴.

• Integracja imoje ze Sky-Shop wymaga wpisania identyfikatora klienta jako Klucza A, identyfikatora sklepu jako Klucza B oraz klucza sklepu jako Klucza C.⁵
• Integracja ING Pay (imoje) z Najszybszą wymaga przeniesienia identyfikatora klienta i klucza sklepu z panelu płatności do panelu sklepu.¹

Dane dostępowe przypisz do właściwych pól wtyczki albo własnego połączenia API. Nie zamieniaj miejscami identyfikatorów i kluczy.
Własne połączenie z REST API uwierzytelniasz jedną daną dostępową: tokenem autoryzacyjnym⁶.

Jak skonfigurować dostęp do API imoje i uwierzytelnianie?

Konfigurując dostęp, przypisz dane do właściwego sklepu i chroń dane uwierzytelniające na serwerze. Dokumentacja API określa sposób przekazania ich w żądaniu.
Żądanie REST API wymaga 1 nagłówka uwierzytelniającego: Authorization z tokenem typu Bearer⁶.

• Identyfikator klienta skopiuj z panelu płatności do ustawień integracji. Wskazuje konto klienta korzystającego z usługi.
• Identyfikator sklepu przypisz do sklepu wysyłającego żądania API. Przy obsłudze jego zamówień nie używaj identyfikatora innego sklepu.
• Klucz sklepu zapisz w ustawieniach serwera lub w polu przeznaczonym do tego w integracji. Nie umieszczaj go w kodzie strony widocznym dla kupującego.
• Uwierzytelnianie żądań ustaw według opisu pól i nagłówków w dokumentacji imoje. Identyfikator klienta nie zastępuje klucza sklepu.
• Dostęp do klucza sklepu ogranicz do osób i procesów obsługujących integrację. Gdy zmienisz klucz, zaktualizuj konfigurację serwera wysyłającego żądania.

Poprawna konfiguracja przypisuje identyfikatory do właściwego sklepu i chroni klucz integracji⁷. Ma to znaczenie zarówno dla wtyczki, jak i własnego połączenia.
W żądaniach REST API sprawdź przede wszystkim 1 wymagany nagłówek Authorization z tokenem Bearer⁶.

Jak obsługiwać płatności i powiadomienia o zmianie statusu?

Sklep powinien oznaczyć zamówienie jako opłacone dopiero po potwierdzeniu płatności. Powiadomienie o zmianie statusu informuje sklep o zmianie stanu transakcji. Sam powrót klienta na stronę sklepu nie jest dowodem zapłaty.
Wśród opisanych statusów rozliczenie płatności potwierdza jeden: settled⁸.

Adres notyfikacji wskazuje, dokąd trafia komunikat o płatności. Przed rozpoczęciem realizacji powiąż otrzymany status z właściwym zamówieniem.
Odbiór powiadomienia serwer sklepu powinien potwierdzić kodem HTTP 200 i treścią {’status’:’ok’}⁹.

• Status transakcji porównaj ze statusem zamówienia w sklepie. Jeśli się różnią, płatność wymaga wyjaśnienia.
• Adres notyfikacji w integracji ING Pay (imoje) z Najszybszą uzupełnij w panelu ING Pay; brak adresu jest wskazany jako przyczyna niedziałania bramki.¹
• Otrzymane powiadomienie przypisz do zamówienia, którego dotyczy. Ten sam komunikat nie może być podstawą do oznaczenia innego zamówienia jako opłaconego.

Dlaczego moja płatność imoje oczekuje na potwierdzenie?

Płatność oczekuje na potwierdzenie, jeśli sklep nie ma jeszcze podstaw do oznaczenia zamówienia jako opłaconego. Transakcja mogła nie osiągnąć końcowego statusu. Możliwe też, że sklep nie odebrał powiadomienia lub nie powiązał go z zamówieniem.
Porównaj status płatności w panelu ze statusem zamówienia. Jeśli panel wskazuje zakończoną płatność, sprawdź odbiór powiadomienia; sam powrót klienta ze strony płatności nie wystarczy.
Gdy sklep nie potwierdzi odbioru, dokumentacja przewiduje do 23 ponowień wysyłki w pięciu etapach⁹.

Status zamówienia powinien odpowiadać potwierdzonemu stanowi transakcji. Przejście klienta przez stronę płatności nie przesądza o wyniku.
Dokumentacja opisuje cztery końcowe statusy: settled, rejected, error i cancelled⁸.

Czym jest API imoje i jaką pełni rolę w płatności?

API łączy składanie zamówienia z obsługą płatności. Nie jest metodą płatności wybieraną przez klienta przy kasie.
Do tworzenia transakcji dokumentacja wskazuje REST API w wersji v1¹⁰.

Metody płatności określają, jak klient zapłaci; API służy natomiast do komunikacji między systemami. Klient może korzystać z szybkich przelewów, kart, Google Pay, Apple Pay, Visa Mobile czy płatności odroczonych.
Oficjalna lista ING Pay obejmuje 13 kategorii płatności: dziewięć dla konsumentów i cztery dodatkowe dla firm¹¹.

Prowizja od transakcji zależy od warunków usługi ING Pay, nie od samego użycia API. Tabela zestawia stawki z okresami ich obowiązywania i warunkiem zawarcia umowy.
Promocja przewiduje prowizję 0% przez trzy miesiące od podpisania umowy w jej okresie obowiązywania, jeśli spełniono wymogi regulaminu¹².

Dane w tabeli: 1,12,13

Właściwą stawkę ustalisz na podstawie zawartej umowy i okresu, w którym obsługujesz transakcję. Warunki promocyjne i późniejsze różnią się.
Dla szybkich przelewów różnica między stawką promocyjną 0% a późniejszą 1,4% wynosi 1,4 punktu procentowego¹³.

Jak przetestować integrację przed uruchomieniem płatności?

Integrację przetestuj na zamówieniu, porównując wynik płatności ze statusem zapisanym w sklepie. Sprawdzisz w ten sposób przejście klienta do płatności i rozpoznanie jej wyniku.
Dla płatności kodem BLIK środowisko testowe udostępnia trzy wyniki: rozliczenie, odrzucenie i błąd dostawcy¹⁴.

• Zamówienie testowe złóż po zapisaniu konfiguracji. Instrukcja integracji ING Pay (imoje) z Najszybszą przewiduje ten krok po skonfigurowaniu płatności.¹
• Przejście do płatności sprawdź z koszyka. Ustal, czy wybór metody otwiera proces płatności dla złożonego zamówienia.
• Wynik transakcji porównaj ze statusem zamówienia w sklepie. Oznacz zamówienie jako opłacone tylko wtedy, gdy potwierdza to stan płatności.
• Nieukończoną płatność sprawdź na osobnym zamówieniu. Upewnij się, że sklep nie uznaje powrotu klienta ze strony płatności za potwierdzenie zapłaty.

Na koniec porównaj przebieg płatności z zapisem przy zamówieniu. Oba wyniki powinny dotyczyć tej samej transakcji.
Uwzględnij wszystkie trzy dostępne wyniki testu BLIK: rozliczenie, odrzucenie i błąd dostawcy¹⁴.

Jak samodzielnie sprawdzić status transakcji przez API imoje?

Status sprawdzisz, wysyłając uwierzytelnione zapytanie o płatność powiązaną z zamówieniem. Następnie odczytaj stan transakcji z odpowiedzi. Skorzystaj ze sposobu wyszukiwania opisanego w dokumentacji API imoje; numer zamówienia nie musi być identyfikatorem płatności.
Dla REST API przygotuj 1 nagłówek Authorization z tokenem Bearer⁶.

• Identyfikator transakcji odczytaj z danych zapisanych przez sklep podczas inicjowania płatności. Powiąż go z zamówieniem, które sprawdzasz.
• Zapytanie do API imoje przygotuj według dokumentacji danej operacji. Wymagany identyfikator i dane uwierzytelniające przekaż po stronie serwera.
• Odpowiedź API odczytaj, zanim zmienisz status zamówienia. Odróżnij wynik zapytania od statusu transakcji, której ono dotyczy.
• Status zamówienia zestaw ze statusem zwróconym dla tej samej transakcji. Rozbieżność zapisz do wyjaśnienia, zamiast automatycznie oznaczać zamówienie jako opłacone.

Kontrola przez API wymaga powiązania odpowiedzi o transakcji z właściwym zamówieniem. Bez tego sam odczyt statusu nie rozstrzyga, które zamówienie można zaktualizować.
Dokumentacja wyróżnia cztery końcowe statusy: settled, rejected, error i cancelled⁸.

Jak rozpoznać i usunąć typowe błędy integracji z API imoje?

Przy błędzie integracji ustal, gdzie płatność się zatrzymuje: przy wysyłaniu żądania, otwieraniu strony płatności czy aktualizacji zamówienia. Zapisz komunikat błędu i identyfikator zamówienia. Te dane pomogą prześledzić problem.
Podczas sprawdzania powiadomień zweryfikuj odpowiedź sklepu: wymagane są kod HTTP 200 i treść {’status’:’ok’}⁹.

• Odrzucone żądanie API imoje przeanalizuj w logach serwera. Porównaj wysłane pola i uwierzytelnienie z opisem operacji w dokumentacji.
• Nieprawidłowe przejście do płatności odtwórz od koszyka po stronę płatniczą. Ustal, czy błąd pojawia się przed wysłaniem żądania, czy po otrzymaniu odpowiedzi.
• Niezmieniony status zamówienia porównaj z wynikiem transakcji w systemie płatności. Jeśli się różnią, sprawdź odbiór i przetwarzanie komunikatu o płatności.
• Błędne przypisanie płatności prześledź za pomocą identyfikatorów zapisanych przy zamówieniu. Popraw powiązanie w kodzie integracji przed ponowną obsługą komunikatu¹⁵.

Naprawę zacznij od ustalenia miejsca błędu w logach. Następnie popraw żądanie albo obsługę odpowiedzi. Ręczna zmiana statusu zamówienia nie naprawia integracji¹⁶.

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