Integracja Subiekta GT z terminalem płatniczym pozwala automatycznie przekazywać kwotę do zapłaty, bez ręcznego jej wprowadzania na terminalu.

Na czym polega ta usługa

Konfiguracja obejmuje połączenie Subiekta GT z terminalem płatniczym oraz przetestowanie poprawności przekazywania kwot do zapłaty kartą.

Dla kogo ma sens

Usługa jest przydatna dla firm przyjmujących płatności kartą, korzystających z Subiekta GT jako systemu sprzedaży.

Ile to trwa

Konfiguracja integracji z terminalem mieści się z reguły w standardowym czasie do 3 dni.

Warunki

Diagnoza wstępna i wycena są bezpłatne, a usługa objęta jest gwarancją do 12 miesięcy.

Zasada działania integracji programu Subiekt GT z terminalem płatniczym

Integracja systemu sprzedaży z urządzeniem płatniczym polega na utworzeniu bezpośredniego kanału komunikacyjnego pomiędzy aplikacją handlową a oprogramowaniem układowym terminala (firmware terminala płatniczego). W środowisku InsERT GT za komunikację ze sprzętem zewnętrznym odpowiada moduł Kasiarz GT (wbudowany program pomocniczy zarządzający urządzeniami fiskalnymi, wagami i terminalami) lub usługa SUZ (Serwer Urządzeń Zewnętrznych, czyli komponent systemowy pośredniczący w wymianie danych przez sieć lokalną).

W tradycyjnym modelu sprzedaży bez integracji sprzedawca musi ręcznie wprowadzić kwotę do zapłaty na klawiaturze terminala po podliczeniu dokumentu w Subiekcie GT. Taki proces niesie ze sobą ryzyko pomyłki kasjerskiej (przestawienie cyfr lub błędne wpisanie groszy), a także wydłuża czas obsługi klienta przy kasie. Po wdrożeniu integracji proces przebiega w sposób w pełni zautomatyzowany. W momencie zatwierdzenia paragonu lub faktury z formą płatności kartą program Subiekt GT wysyła komendę inicjalizacji płatności wraz z dokładną kwotą bezpośrednio do terminala.

Terminal płatniczy automatycznie wyświetla żądaną sumę i oczekuje na zbliżenie lub włożenie karty przez klienta. Po przeprowadzeniu autoryzacji w centrum autoryzacyjnym (proces weryfikacji dostępności środków i poprawności kodu PIN w banku) terminal odsyła do Subiekta GT sygnał zwrotny z kodem autoryzacji transakcji. Dopiero po odebraniu komunikatu o pomyślnej płatności Subiekt GT zamyka dokument sprzedaży i wysyła polecenie wydruku paragonu do drukarki fiskalnej. W przypadku odrzucenia transakcji (brak środków na koncie, błędny kod PIN lub rezygnacja klienta) system sprzedaży otrzymuje stosowny komunikat błędu i pozwala na ponowienie próby lub zmianę formy płatności bez blokowania rejestru.

Obsługiwane protokoły komunikacyjne i modele urządzeń

Połączenie Subiekta GT z terminalem wymaga zastosowania odpowiedniego protokołu komunikacyjnego, który musi być zgodny zarówno ze sterownikiem w programie Kasiarz GT lub usłudze SUZ, jak i z oprogramowaniem zainstalowanym w terminalu przez agenta rozliczeniowego (firmę przetwarzającą płatności bezgotówkowe). Najczęściej wykorzystywanym standardem jest protokół ECR-EFT (Electronic Cash Register – Electronic Funds Transfer, czyli uniwersalny protokół wymiany danych między systemem kasowym a terminalem płatniczym).

W zależności od operatora płatności bezgotówkowych konfigurujemy współpracę z terminalami dostarczanymi przez wiodących agentów rozliczeniowych działających na polskim rynku, w tym:

eService (protokół ECR oraz sterowniki komunikacyjne TCP/IP i RS-232),
Polcard / First Data (protokoły integracji kasowej przez interfejs szeregowy i sieciowy),
Elavon (protokół ECR i komunikacja z wykorzystaniem dedykowanych bibliotek),
PayTel (obsługa terminali stacjonarnych i mobilnych w oparciu o protokół EFT),
Polskie ePłatności – PeP (zintegrowane sterowniki dla urządzeń Ingenico oraz Verifone),
IT Card / Planet Cash oraz bankowe centra autoryzacji (m.in. PKO BP, ING Bank Śląski, Santander).

Pod względem fizycznego interfejsu połączeniowego integracja może być zrealizowana na dwa główne sposoby. Pierwszym z nich jest połączenie przez sieć lokalną LAN (przewód Ethernet lub stabilne połączenie Wi-Fi z wykorzystaniem protokołu TCP/IP), gdzie terminal i stanowisko komputerowe komunikują się za pośrednictwem stałego adresu IP i wskazanego portu komunikacyjnego. Drugim rozwiązaniem jest połączenie przewodowe przez port szeregowy COM (standard RS-232) lub przewód USB z wykorzystaniem wirtualnego portu szeregowego (sterownik USB-to-UART). Wybór odpowiedniego interfejsu zależy od możliwości technicznych posiadanego modelu terminala oraz topologii sieci w lokalu klienta.

Szczegółowe etapy konfiguracji integracji na stanowisku sprzedaży

Prawidłowe wdrożenie połączenia wymaga wykonania ściśle określonych czynności konfiguracyjnych w systemie operacyjnym Windows, w parametrach sieci lokalnej oraz bezpośrednio w strukturze bazy danych programu Subiekt GT. Prace konfiguracyjne realizujemy bezpośrednio w siedzibie firmy klienta, co pozwala na natychmiastowe przetestowanie całego toru sprzedaży.

Wdrożenie obejmuje następujące kroki techniczne:

Weryfikacja wersji oprogramowania i bazy danych – sprawdzenie wersji programu Subiekt GT, silnika bazy danych Microsoft SQL Server oraz zainstalowanych pakietów sterowników InsERT. W razie potrzeby instalujemy aktualne biblioteki sterowników urządzeń zewnętrznych.
Konfiguracja parametrów terminala płatniczego – weryfikacja, czy terminal ma aktywowaną funkcję współpracy z kasą (profil ECR) oraz przypisanie urządzeniu stałego, statycznego adresu IP (przypisanie adresu w menu terminala lub poprzez rezerwację adresu MAC na routerze sieciowym).
Instalacja i parametryzacja usługi SUZ lub konfiguracja modułu Kasiarz GT – dodanie nowego terminala płatniczego na liście urządzeń, wybór dedykowanego modelu sterownika, ustawienie numeru portu IP lub parametrów transmisji portu COM (prędkość transmisji bodów, bity danych, parzystość, bity stopu).
Definicja parametrów płatności w Subiekcie GT – konfiguracja w menu Administracja – Parametry – Płatności kartą przy użyciu terminala. Wskazanie powiązanego urządzenia z programu Kasiarz GT, przypisanie odpowiedniego centrum autoryzacji (instytucji finansowej) oraz zdefiniowanie sposobu ewidencji płatności na dokumentach handlowych.
Konfiguracja zapory sieciowej Windows Defender Firewall – dodanie reguł dla ruchu przychodzącego i wychodzącego dla portów wykorzystywanych przez usługę Serwera Urządzeń Zewnętrznych, co zapobiega blokowaniu pakietów danych przez system zabezpieczeń.
Przeprowadzenie serii transakcji testowych – wykonanie próbnego przesłania kwoty, zatwierdzenie płatności testowej, wykonanie symulacji odrzucenia transakcji oraz próby unieważnienia dokumentu.

Typowe problemy i zakłócenia w komunikacji z terminalem

W codziennej eksploatacji zintegrowanego stanowiska sprzedaży mogą pojawić się zakłócenia w przekazywaniu danych. Prawidłowa diagnoza źródła problemu pozwala na szybkie przywrócenie sprawności systemu bez konieczności wstrzymywania sprzedaży.

Do najczęściej spotykanych problemów należą:

Błąd przekroczenia limitu czasu odpowiedzi (tzw. timeout komunikacji) – objawia się brakiem reakcji terminala po zatwierdzeniu dokumentu w Subiekcie GT. Najczęstszą przyczyną jest zmiana adresu IP terminala przez serwer DHCP (mechanizm automatycznego przydzielania adresów sieciowych) po restarcie routera lub awarii zasilania. Jeśli Subiekt odwołuje się do nieaktualnego adresu IP, pakiety danych nie docierają do urządzenia.
Konflikt portów szeregowych COM – w przypadku integracji przez przewód USB lub RS-232 system Windows może przypisać inny numer portu wirtualnego (np. po przepięciu kabla do innego gniazda USB w komputerze) lub port może zostać zablokowany przez inną aplikację działającą w tle.
Zablokowanie komunikacji przez oprogramowanie antywirusowe lub zaporę sieciową – po automatycznej aktualizacji systemu Windows Defender lub pakietu zabezpieczającego reguły zezwalające na komunikację usługi SUZ mogą zostać zresetowane, co skutkuje odcięciem połączenia.
Zawieszenie sesji usługi InsERT SUZ – usługa systemowa pośrednicząca w transmisji może ulec zatrzymaniu w wyniku błędu pamięci lub nagłego wyłączenia komputera kasowego, co wymaga restartu usługi w panelu zarządzania usługami Windows.
Błąd desynchronizacji stanu transakcji – sytuacja, w której klient dokonał płatności na terminalu i środki zostały zablokowane na koncie bankowym, lecz w wyniku zakłócenia sieciowego sygnał potwierdzenia nie dotarł do Subiekta GT na czas. Dokument w systemie pozostaje niezatwierdzony, co wymaga bezpiecznego powiązania wpłaty bez podwójnego obciążania karty.

Błędy popełniane podczas prób samodzielnej konfiguracji

Próby samodzielnego połączenia terminala z programem Subiekt GT bez odpowiedniej wiedzy technicznej często prowadzą do przestojów w pracy punktu handlowego lub błędów księgowych. Warto poznać najczęstsze błędy, aby uniknąć problemów w ewidencji finansowej.

Najczęstszym błędem jest próba konfiguracji Subiekta GT przed przygotowaniem terminala przez agenta rozliczeniowego. Terminal płatniczy w wersji autonomicznej (standardowej) nie posiada aktywnego protokołu komunikacji kasowej. Podłączenie kabla sieciowego lub przewodu USB do komputera nie przyniesie rezultatu, dopóki operator nie wgra na terminal odpowiedniego profilu ECR z poziomu swojego serwera konfiguracyjnego (tzw. TMS – Terminal Management System).

Kolejnym poważnym błędem jest pozostawienie automatycznego przydzielania adresu IP (DHCP) w konfiguracji karty sieciowej terminala. Przy każdym restarcie routera dostawcy Internetu terminal może otrzymać nowy adres IP, co powoduje natychmiastowe zerwanie integracji i paraliż stanowiska kasowego w godzinach największego natężenia ruchu.

Często spotykanym problemem jest także nieprawidłowe powiązanie form płatności w słownikach Subiekta GT. Zdarza się, że płatność kartą zostaje przypisana do rejestru gotówkowego lub do niewłaściwego konta rozrachunkowego, co prowadzi do niezgodności w raportach kasowych i utrudnia późniejsze uzgadnianie wyciągów bankowych z agentem rozliczeniowym.

Niebezpieczną praktyką jest również całkowite wyłączanie zapory sieciowej Windows Firewall w celu wymuszenia łączności. Zamiast precyzyjnego otwarcia wymaganego portu nasłuchu użytkownicy wyłączają osłony systemowe, co naraża całą sieć lokalną i bazę danych Microsoft SQL na ataki ze strony złośliwego oprogramowania.

Kiedy problem dotyczy Subiekta GT, a kiedy łącza bankowego

W przypadku problemów z obsługą płatności kluczowe jest prawidłowe rozróżnienie, który element infrastruktury uległ awarii. Nie każda odmowa wykonania transakcji wynika z błędu programu sprzedażowego.

Problem leży po stronie programu Subiekt GT lub komputera kasowego, gdy:

Program wyświetla komunikat o braku połączenia ze sterownikiem lub braku odpowiedzi urządzenia w momencie próby zatwierdzenia dokumentu,
Terminal w ogóle nie reaguje na rozpoczęcie operacji sprzedaży i pozostaje w stanie bezczynności,
Komunikat błędu dotyczy zatrzymania usługi InsERT SUZ lub braku uprawnień użytkownika w systemie Windows,
Kwota przesyłana na terminal różni się od wartości brutto dokumentu (np. w wyniku błędnego przeliczenia waluty lub błędów w zaokrągleniach).

Problem leży po stronie terminala, łącza internetowego lub agenta rozliczeniowego, gdy:

Terminal poprawnie odbiera kwotę z Subiekta GT, lecz podczas próby zbliżenia karty wyświetla komunikat o błędzie transmisji z bankiem (błąd połączenia z hostem autoryzacyjnym),
Na ekranie terminala pojawia się komunikat o konieczności wykonania zamknięcia dnia (zamknięcie partii transakcji – tzw. batch close),
Wystąpiła blokada kluczy kryptograficznych w terminalu (komunikat typu tamper lub błąd pamięci bezpiecznej), co wymaga interwencji serwisu operatora płatności,
Nastąpiła ogólna awaria infrastruktury bankowej lub operatora telekomunikacyjnego (brak zasięgu karty SIM/GPRS w terminalu bezprzewodowym).

Pytania i odpowiedzi dotyczące integracji Subiekta GT z terminalami

Czy jeden terminal płatniczy może obsługiwać kilka stanowisk z Subiektem GT?

Tak, w przypadku połączenia sieciowego z wykorzystaniem protokołu TCP/IP i usługi InsERT SUZ istnieje techniczna możliwość współdzielenia jednego terminala przez kilka komputerów w sieci lokalnej. Należy jednak pamiętać, że terminal może w danym momencie przetwarzać wyłącznie jedną transakcję. Jeśli dwa stanowiska kasowe podejmą próbę wysłania kwoty w tej samej sekundzie, drugie stanowisko otrzyma komunikat o zajętości urządzenia i będzie musiało ponowić próbę po zakończeniu pierwszej operacji.

Czy do integracji z terminalem wymagany jest dodatkowy płatny moduł do Subiekta GT?

Podstawowa integracja z terminalami płatniczymi za pośrednictwem modułu Kasiarz GT oraz bezpłatnych sterowników InsERT Driver lub usługi SUZ jest standardową funkcją systemu Subiekt GT i nie wymaga zakupu dodatkowych pakietów rozszerzeń, takich jak Czerwony Plus czy Niebieski Plus. Wymagane jest jedynie posiadanie aktualnych sterowników urządzeń zewnętrznych oraz aktywnej usługi integracji u swojego agenta rozliczeniowego.

Czy integracja działa na terminalach bezprzewodowych Wi-Fi?

Tak, terminale bezprzewodowe komunikujące się przez sieć Wi-Fi mogą być w pełni zintegrowane z programem Subiekt GT pod warunkiem, że terminal oraz komputer z systemem sprzedaży znajdują się w tej samej podsieci lokalnej (w tym samym segmencie adresowym IP). Terminalowi należy przypisać stały adres IP, aby uniknąć problemów z gubieniem połączenia przy zmianie parametrów sieci.

Jak przebiega procedura zwrotu towaru na kartę w systemie zintegrowanym?

W przypadku wystawienia dokumentu zwrotu (korekty paragonu lub faktury) w Subiekcie GT program może automatycznie przesłać kwotę zwrotu na terminal płatniczy. W zależności od konfiguracji i wymagań agenta rozliczeniowego terminal poprosi o zbliżenie karty klienta oraz może wymagać podania numeru referencyjnego oryginalnej transakcji (numeru transakcji z wydruku potwierdzenia), co zabezpiecza firmę przed nieautoryzowanymi wypłatami.

Co zrobić w przypadku zawieszenia programu podczas trwania płatności zbliżeniowej?

Jeżeli dojdzie do zablokowania programu lub nagłego zaniku zasilania w trakcie autoryzacji, w pierwszej kolejności należy zweryfikować stan terminala. Jeśli terminal wydrukował potwierdzenie transakcji z kodem autoryzacji, płatność została pobrana z konta klienta. Po ponownym uruchomieniu Subiekta GT należy zapisać dokument sprzedaży wybierając formę płatności kartą z opcją wprowadzenia ręcznego numeru transakcji bez ponownego wysyłania żądania obciążenia na terminal, co zapobiega podwójnemu pobraniu środków od klienta.

Kompleksowa obsługa konfiguracji i wsparcie techniczne na miejscu

Zapewniamy pełne wsparcie techniczne przy konfiguracji, optymalizacji i naprawie integracji systemów sprzedaży InsERT GT z terminalami płatniczymi. Wszelkie prace wykonujemy z dojazdem do siedziby klienta na obszarze Warszawy oraz okolicznych powiatów. W przypadku nagłych awarii uniemożliwiających przyjmowanie płatności bezgotówkowych dojeżdżamy na miejsce w czasie do 1 godziny od zgłoszenia. Weryfikujemy konfigurację sieciową, parametry portów, stabilność usługi SUZ oraz poprawność ewidencji dokumentów w bazie danych. Na wszystkie wykonane prace konfiguracyjne udzielamy gwarancji do 12 miesięcy, zapewniając stabilne i bezbłędne funkcjonowanie stanowisk sprzedaży.

22 378 48 09

Subiekt GT — integracja z terminalem płatniczym