imoje (ING) — jak płacić: integracje i konto

imoje API łączy sklep z bramką imoje, która od 1 lipca 2026 r. działa pod nazwą ING Pay.¹ Dokumentacja integracji opisuje RESTful API i FRONT API.¹ W artykule wyjaśniamy przebieg płatności, znaczenie statusów transakcji oraz obsługę zwrotów.

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

Sklep używa imoje API, by powiązać zamówienie z płatnością obsługiwaną przez ING Pay. Kupujący wybiera metodę podczas finalizacji zakupu, a sklep otrzymuje dane potrzebne do obsługi zamówienia. Dokumentacja API wyróżnia osiem rodzajów metod płatności; to konfiguracja sklepu decyduje, które z nich zobaczy klient.²

Panel administracyjny ING Pay jest narzędziem sprzedawcy, nie kupującego. Sprzedawca pobiera z niego identyfikator klienta i sklepu, klucz sklepu oraz token autoryzacyjny.³ Klient nie potrzebuje tych danych, żeby zapłacić za zamówienie.

Jakie płatności i operacje może obsłużyć sklep przez API?

imoje API pozwala rozpocząć płatność i przypisać transakcję do zamówienia. Klient wybiera metodę, ale sklep musi odróżnić złożenie zamówienia od potwierdzonej zapłaty. Jeśli integracja nie przekazuje parametru validTo, płatność wygasa według ustawień sklepu. Gdy sklep nie określił terminu, następuje to po 15 miesiącach.⁴

Klucze i uwierzytelnianie: co musi przygotować sprzedawca?

Sprzedawca pobiera 4 dane integracyjne: identyfikator klienta, identyfikator sklepu, klucz sklepu i token autoryzacyjny. Znajduje je w panelu ING Pay pod ścieżką „Sklepy” → „Szczegóły” → „Dane do integracji”.³ Klucz i token służą do konfiguracji sklepu; kupujący nie wpisuje ich podczas płatności.

Błąd żądania lub nieudana płatność – od czego zacząć sprawdzanie?

Sprzedawca powinien zacząć od porównania danych integracji z danymi sklepu w panelu. Nieprawidłowy token lub klucz może skierować klienta płacącego BLIKIEM na stronę główną sklepu WooCommerce.⁵ Takie przekierowanie nie oznacza, że klient zapłacił. Serwer potwierdza odbiór notyfikacji odpowiedzią HTTP 200 OK z treścią {„status”:”ok”}; powrót kupującego do sklepu jej nie zastępuje.⁶

Jak sprawdzić przebieg płatności przed uruchomieniem jej w sklepie?

ING Pay udostępnia środowisko testowe sandbox, w którym można sprawdzić bramkę bez użycia środków płatniczych.¹ API działa w środowisku testowym w wersji v1 oraz produkcyjnym w wersji v1.⁷ Próba przed uruchomieniem płatności pozwala porównać to, co widzi klient, ze stanem zamówienia w sklepie.

• Sprzedawca konfiguruje połączenie sklepu ze środowiskiem testowym.
• Sprzedawca składa próbne zamówienie jako kupujący i obserwuje ekran płatności.
• Sprzedawca porównuje wynik próby ze statusem zamówienia zapisanym w sklepie.

Test w sandboxie pokazuje ścieżkę klienta, zanim sklep udostępni płatności kupującym. W przypadku kodu BLIK dokumentacja opisuje trzy możliwe wyniki: realizację, odrzucenie i błąd dostawcy.⁸ Każdy z nich warto odnieść do statusu zamówienia.

FRONT i REST: dwie drogi integracji z imoje API

imoje API oddziela czynności kupującego od komunikacji serwera sklepu z bramką. Klient może zapłacić bez dostępu do ustawień technicznych. Dokumentacja rozróżnia dwa interfejsy, przedstawione w tabeli.⁹

FRONT API: jaką rolę pełni w procesie płatności?

FRONT API dotyczy tej części płatności, z którą styka się kupujący. Klient widzi wybraną metodę i przechodzi autoryzację, ale nie korzysta z kluczy integracyjnych sklepu. Sam ekran płatności nie informuje jeszcze o realizacji zamówienia. Przy płatności BLIKIEM kupujący wpisuje jednorazowy kod złożony z sześciu cyfr.¹⁰

RESTful API: co obsługuje po stronie sklepu?

RESTful API ING Pay służy systemowi sklepu do wymiany danych o transakcjach z bramką. Za integrację odpowiada sprzedawca; kupujący nie uczestniczy w tej komunikacji. Osobne połączenie z ING Księgowością wymaga 1 indywidualnego klucza API użytkownika, wpisywanego w sekcji „ING Księgowość” danych integracyjnych sklepu.¹¹ Nie należy mylić klucza tej usługi z danymi wymaganymi do integracji imoje.¹²

FRONT API obejmuje ścieżkę kupującego, a RESTful API pracuje po stronie zaplecza sklepu. Ten podział pomaga ustalić, gdzie szukać źródła problemu. Inaczej sprawdza się ekran płatności, a inaczej wymianę danych o transakcji.

Od rozpoczęcia płatności do potwierdzenia: statusy i powiadomienia

ING Pay przekazuje zmianę statusu transakcji przez notyfikację wysyłaną na adres serwera sklepu.¹³ Sprzedawca używa jej do aktualizacji zamówienia. Powrót kupującego na stronę sklepu nie jest potwierdzeniem płatności.

• Sprzedawca ustawia adres notyfikacji w danych integracyjnych sklepu lub przekazuje go przez opcjonalny parametr notificationUrl.¹³ Wtyczka ING Pay dla WooCommerce przekazuje adres automatycznie, bez wpisywania go w panelu bramki.⁵
• Serwer sklepu potwierdza poprawny odbiór i przetworzenie notyfikacji odpowiedzią 200 OK z treścią {„status”:”ok”}.^6,13
• Sprzedawca sprawdza podpis z nagłówka X-IMoje-Signature, porównując otrzymaną sygnaturę z obliczoną. Zmienia status transakcji dopiero po udanej weryfikacji, a ponowioną notyfikację ignoruje.¹³

Notyfikacja ING Pay może zawierać dane transakcji, linku płatności, przekierowania albo profilu kartowego Oneclick/Recurring.¹³ Po wygaśnięciu lub ręcznym anulowaniu linku przychodzi wyłącznie obiekt payment.¹³ Dokumentacja wymienia cztery typy obiektów notyfikacji: transaction, payment, action i paymentProfile.⁶

Tabela pokazuje etapy ponawiania nieodebranej notyfikacji, liczbę prób oraz odstępy między nimi.¹³ Cały harmonogram przewiduje do 23 prób wysłania takiego powiadomienia.⁶

Dane w tabeli: 13

ING Pay przestaje ponawiać wysyłkę po prawidłowej odpowiedzi serwera albo po zakończeniu cyklu.¹³ Powiadomienia o dostępności raportów przychodzą jako obiekt JSON wysłany metodą POST.¹³ Notyfikacje o zwrotach są domyślnie wyłączone; sprzedawca może je włączyć, kontaktując się z obsługą i podając identyfikator sklepu.¹³ Odpowiedź HTTP 200 OK od serwera sklepu kończy ponawianie wysyłki notyfikacji.⁶

Płatność oczekuje na potwierdzenie – co może zrobić kupujący?

Kupujący powinien najpierw sprawdzić wynik płatności w aplikacji banku lub historii użytej metody. Potem może porównać go ze statusem zamówienia w sklepie. Jeśli środki pobrano, a zamówienie nadal oczekuje, przekazuje sprzedawcy identyfikator zamówienia i informację o płatności. Ponowna zapłata przed wyjaśnieniem sprawy grozi opłaceniem tego samego zamówienia jeszcze raz.

Moje ING podczas płatności: co widzi klient banku?

Klient ING korzystający z Moje ING widzi dane płatności wymagające akceptacji, jeśli wybrana metoda kieruje go do bankowości elektronicznej. Przed zatwierdzeniem porównuje kwotę i odbiorcę z informacjami o zamówieniu. Rozbieżność warto wyjaśnić, zanim dojdzie do autoryzacji.

Moje ING służy do autoryzacji operacji bankowej, a sklep pokazuje stan zamówienia. Po akceptacji płatności klient wraca do sklepu. Tam sprawdza, czy zamówienie ma status opłaconego.

Klient, który zauważy inną kwotę lub innego odbiorcę, powinien przerwać autoryzację. Rozbieżność wyjaśnia ze sklepem. Dopiero potem podejmuje decyzję o ponowieniu płatności.

Rejestracja sprzedawcy: od czego zacząć przyjmowanie płatności?

Sprzedawca przygotowuje dane firmy i sklepu potrzebne do zawarcia umowy o przyjmowanie płatności. Następnie wybiera sposób połączenia bramki ze sklepem. Znaczenie mają używana platforma oraz to, czy sklep potrzebuje własnej obsługi procesu płatności. Tabela porównuje oba sposoby połączenia.

Rejestracja sprzedawcy służy przyjmowaniu zapłat. Nie dotyczy konta kupującego. Klient nie zakłada konta sprzedawcy tylko dlatego, że płaci za zamówienie.

Jak dodać bramkę płatniczą w sklepie Shopify?

• Sprzedawca pobiera token autoryzacyjny z panelu bramki i wpisuje go w konfiguracji integracji Shopify.¹⁴
• Sprzedawca wybiera metody płatności dla klientów i sprawdza je przy zamówieniu.
• Sprzedawca uwzględnia prowizję operatora oraz prowizję Shopify właściwą dla swojego planu.

Opis integracji podaje standardowe prowizje imoje od 4. miesiąca, osobno dla poszczególnych metod. Opłata BLIK zawarta w podanej stawce nie jest naliczana drugi raz.^14,15 Poniższa tabela przedstawia prowizje za transakcję.

Przy szybkim przelewie lub płatności kartą do prowizji imoje dochodzi prowizja Shopify właściwa dla planu sprzedawcy. Tabela pokazuje obie wartości oraz łączny koszt transakcji.¹⁴

Dane w tabeli: 16

Sprzedawca w Shopify ocenia koszt przyjęcia płatności według metody i używanego planu. Sama opłata za dodanie integracji nie pokazuje kosztu obsługi zamówień. Liczy się również prowizja od każdej transakcji.

Najczęściej zadawane pytania

Czy środowisko testowe i produkcyjne korzystają z różnych wersji API?

Nie. Artykuł wskazuje wersję v1 zarówno dla środowiska testowego, jak i produkcyjnego.

Jakie wyniki może zwrócić test płatności kodem BLIK?

Dokumentacja opisuje trzy wyniki: realizację, odrzucenie i błąd dostawcy.

Czy każda notyfikacja o transakcji zawiera te same dane?

Nie. Notyfikacja może zawierać dane transakcji, linku płatności, przekierowania albo profilu kartowego Oneclick/Recurring.

Jaki obiekt przychodzi po wygaśnięciu lub ręcznym anulowaniu linku płatności?

W takim przypadku notyfikacja zawiera wyłącznie obiekt payment.

Czy notyfikacje o zwrotach są włączone od razu?

Nie. Sprzedawca może je włączyć, kontaktując się z obsługą i podając identyfikator sklepu.

Czy opłata BLIK wymieniona w prowizji imoje na Shopify jest naliczana ponownie?

Nie. Artykuł zaznacza, że opłata BLIK zawarta w podanej stawce nie jest naliczana drugi raz.

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