HermesSQL

  1. Strona główna
  2. Docs
  3. HermesSQL
  4. Terminale Płatnicze
  5. Integracja z terminalami Polskich ePłatności

Integracja z terminalami Polskich ePłatności

Wydrukuj dokument

Polskie ePłatności (PeP) to wiodący polski operator płatności bezgotówkowych specjalizujący się w dostarczaniu terminali płatniczych (POS), systemów płatności online oraz integracji kasowo-fiskalnych. W odpowiedzi na rosnące potrzeby klientów i dynamiczny rozwój płatności bezgotówkowych poszerzono zakres integracji systemów Humansoft z terminalami płatniczymi o urządzenia Polskich ePłatności.

Obsługiwane urządzenia

Wykonana integracja z urządzeniami Polskich ePłatności swoim zakresem obejmuje urządzenia:

  • Ingenico DESK/2600,
  • Ingenico DESK/3500,
  • Ingenico MOVE/3500 WiFi.

Konfiguracja terminala płatniczego

Konfiguracja dla urządzeń Polskich ePłatności dostępna jest w menu Konfig., z poziomu Stacji roboczej, pod przyciskiem Konfiguracja terminala płatniczego, po wskazaniu Model komunikacji z terminalem płatniczym – ePłatności.

Po zmianie modelu komunikacji z terminalem płatniczym na ePłatności należy uzupełnić pola:

  • Adres IP – adres sieciowy terminala płatniczego,
  • Port – port sieciowy terminala płatniczego (5000 lub 5010),
  • Terminal ID – identyfikator urządzenia, dostępny m.in. na wydruku Wizytówki bezpośrednio z terminala płatniczego – ZarządzanieWizytówka,
  • Operator ID (Kasjer terminala płatniczego) – identyfikator kasjera, który będzie automatycznie zalogowany do urządzenia (kasjerzy urządzenia – wydruk listy kasjerów wraz z identyfikatorami i nazwą możliwy z terminala płatniczego: ZarządzanieKasjerzyLista, dostęp po autoryzacji hasłem, w przypadku braku możliwości sprawdzenia listy kasjerów na terminalu – należy spróbować ID Administratora 9999 lub 1, ew. pozostawić pole puste – ustawi się wartość -1),
  • Timeout – czas oczekiwania odpowiedzi między urządzeniem, a systemem wyrażony w sekundach – zalecana wartość – co najmniej 15 sekund,
  • Lokalny IP – adres sieciowy systemu kasowego to adres IP komputera, na którym uruchamiany jest program, który łączy się z terminalem,

Przykładowy wydruk wizytówki terminala płatniczego (Zarządzanie – Wizytówka).

UWAGA!!!

W celu prawidłowej komunikacji z terminalem płatniczym niezbędne jest ustawienie Systemu kasowego: UDP/PEP. W przypadku, gdy na wizytówce widnieje inne ustawienie należy skontaktować się z operatorem – Polskie ePłatności, w celu dokonania zmian w konfiguracji urządzenia. 

W oknie konfiguracji dostępne są także przyciski:

  • Test połączenia – umożliwia sprawdzenie poprawności wprowadzonych parametrów komunikacji z terminalem płatniczym; po wybraniu przycisku wyświetlane jest okno Komunikacja z terminalem PeP z informacją dotyczącą poprawności połączenia. Przed wykonaniem testu należy ustawić w programie konfigurowaną stację roboczą (pasek stanuZmiana stacji). 

 

  • Raport ostatniej transakcji – pozwala na wyświetlenie informacji dotyczących ostatniej transakcji tj.
  • kwotę,
  • kod STAN – nr sekwencyjny transakcji wykorzystywany m.in. do unieważnienia transakcji, zapisywany w tabeli NAGL_DOK w polu POSAUTHID po zakończeniu transakcji,
  • kod operatora – urządzenia,
  • TID – Terminal ID,
  • typ transakcji, np. PB_PT_SELL – Payment by Point Terminal – Sale,
  • datę z dokładną godziną.

  • Zamknięcie dnia – wybranie przycisku powoduje rozpoczęcie na terminalu płatniczym wydruku raportu zamknięcia dnia, który zawiera wykaz liczby poszczególnych typów transakcji z kwotą.

Zapłata kartą

Możliwość przeprowadzania transakcji w terminalu płatniczym wymaga skonfigurowania karty płatniczej w systemie z włączoną Obsługą karty terminalem płatniczym.

W przypadku braku skonfigurowanej karty płatniczej z włączoną obsługą karty terminalem płatniczym nie będzie możliwe przeprowadzenie transakcji.

W przypadku dostępnej karty płatniczej z omawianą konfiguracją wybranie przycisku Zapłać kartą spowoduje ustawienie kwoty zapłaty kartą dla pierwszej karty z obsługą terminali płatniczych oraz uruchomienie aplikacji odpowiedzialnej za komunikację z terminalem płatniczym. Oznacza to otworzenie okna Komunikacji z terminalem PeP, natomiast rozpoczęcie transakcji na terminalu odbywa się po wybraniu przycisku Sprzedaż.

Na terminalu płatniczym transakcja obejmuje:

  1. akceptację kwoty transakcji – potwierdzenie kwoty przez OK,

  1. możliwość doliczenia napiwku do rachunku,

  1. wybór waluty – * dla PLN lub # dla EUR,

  1. zbliżenie karty płatniczej,

  1. wprowadzenie kodu PIN,

  1. wydruk – w przypadku wyboru waluty EUR wydruk zostanie wykonany w języku angielskim,

  1. możliwość wydruku kopii dla klienta.

W czasie transakcji poszczególne operacje są sygnalizowane w oknie komunikacji z terminalem płatniczym. Po jej zakończeniu zwracany jest kod autoryzacji oraz kod STAN.

Okno komunikacji z terminalem płatniczym zostanie uruchomione również w przypadku ręcznego ustawienia zapłaty kartą w Płatności dokumentu w czasie jego zamknięcia.

Płatność BLIK

Integracja obejmuje również możliwość płatności poprzez system BLIK, w tym celu należy w oknie komunikacji z terminalem płatniczym przed wybraniem przycisku Sprzedaż zaznaczyć Płatność BLIK.

W efekcie, po rozpoczęciu sprzedaży na terminalu pojawi się monit z możliwością wprowadzenia kodu BLIK (BLIK T6 – 6 cyfrowy kod lub BLIK V9 – 9 cyfrowy kod).

Przebieg transakcji jest sygnalizowany w oknie komunikacji z terminalem płatniczym. Po zakończeniu transakcji zwracany jest kod autoryzacji oraz kod STAN.

 

Zwrot

Wykonanie zwrotu za pośrednictwem terminala płatniczego jest możliwe z poziomu korekty sprzedaży po wybraniu przycisku Zapłać kartą. W efekcie wyświetlone zostanie okno komunikacji z terminalem płatniczym z możliwością zwrotu, po wciśnięciu przycisku Zwrot.

Po wybraniu przycisku do terminala zostanie wysłana kwota z dokumentu KF oraz wyświetlony monit z prośbą o zbliżenie karty płatniczej.

Przebieg transakcji jest sygnalizowany w oknie komunikacji z terminalem płatniczym. Po zakończeniu transakcji zwracany jest kod autoryzacji oraz kod STAN.

W raporcie ostatniej transakcji transakcja zwrotu ma typ PB_PT_REFUND.

Unieważnienie transakcji

Po wykonaniu transakcji sprzedaży lub zwrotu, przycisk Zapłać kartą zmienia się na Unieważnienie.

Wybranie przycisku skutkuje wyświetleniem okna komunikacji z terminalem płatniczym z możliwością unieważnienia transakcji.

Przeprowadzenie unieważnienia wymaga autoryzacji hasłem na terminalu.

Przebieg unieważnienia jest sygnalizowany w oknie komunikacji z terminalem płatniczym, po zakończeniu zwracany jest kod STAN.

W raporcie ostatniej transakcji unieważnienie ma typ transakcji PB_PT_REVERSAL.

Próba ponownego unieważnienia transakcji spowoduje wyświetlenie na terminalu informacji o braku możliwości unieważnienia transakcji.

Zmiany w wersji 3.87.005

W celu poprawy ergonomii pracy z wykorzystaniem terminali płatniczych wprowadzono zmiany ograniczające konieczność konfiguracji opcji dotyczących płatności kartą. Zmiany dostępne są na dokumentach sprzedaży zarówno z poziomu formularzy jak i Sprzedaży detalicznej. Zmodyfikowano również okno Komunikacji z terminalem płatniczym dla modułu komunikacji ePłatności.

 

a)   Formularze dokumentów sprzedaży

Do okna dokumentu F, dodano przyciski:

  • Zapłać kartą – przycisk uruchomi okno Komunikacji z terminalem płatniczym Polskich ePłatności w trybie płatności kartą, a do urządzenia trafi kwota dokumentu bez konieczności wykonania dodatkowych czynności w samym oknie komunikacji.

 

  • Blik – przycisk dostępny wyłącznie dla modelu komunikacji ePłatności. Wybranie przycisku spowoduje wywołanie okna Komunikacji z terminalem płatniczym Polskich ePłatności w trybie płatności za pośrednictwem systemu BLIK. Wówczas na terminalu zostanie wyświetlony monit z możliwością wprowadzenia kodu BLIK bez konieczności zaznaczania dodatkowych opcji lub wybierania przycisku w samym oknie komunikacji.

Należy pamiętać, że:

  • BLIK T6 to 6 cyfrowy kod,
  • BLIK V9 to 9 cyfrowy kod.

 

Dodatkowo, wybranie przycisku Zapłać kartą/ BLIK spowoduje ustawienie w Płatności dokumentu karty płatniczej z włączoną Obsługą terminali płatniczych, przenosząc kwotę dokumentu do karty.

 

Przycisk Zwrot o analogicznym działaniu do opcji Zapłać kartą, został dodany do formularza Korekt sprzedaży.

 

UWAGA!!!

Nowo dodane przyciski obsługi płatności terminali płatniczych tj. Zapłać kartą oraz Blik są sprzężone z modułem Obsługi terminali płatniczych. Oznacza to, że w przypadku braku modułu, przyciski nie będą widoczne.

 

W przypadku braku konfiguracji terminala płatniczego lub karty płatniczej, wyświetlane są stosowne komunikaty z informacją po wybraniu przycisku.

 

b)   Sprzedaż detaliczna

Nowe przyciski powiązane z obsługą terminali płatniczych tj. Zapłać kartą oraz Blik, dodano także do panelu Sprzedaży detalicznej.

 

W zależności od wskazanego przycisku, okno Komunikacji z terminalem płatniczym zostanie wywołane w trybie sprzedaży z płatnością kartą lub za pośrednictwem systemu Blik.

 

Niezależnie od wybranego sposobu płatności, Płatność dokumentu zostanie ustawiona w tle na pierwszą kartę płatniczą z włączoną Obsługą terminali płatniczych, jeśli nie została wskazana.

 

Po poprawnym zakończeniu transakcji zostanie wykonany wydruk fiskalny. W innym przypadku, np. przerwanej transakcji, zostanie wyświetlony komunikat o braku możliwości wydruku fiskalnego.

 

Komunikat jest wyświetlany po zamknięciu okna Komunikacji z terminalem płatniczym, w przypadku wystąpienia błędu okno nie zamyka się automatycznie.

 

c)   Komunikacja z terminalem płatniczym – moduł komunikacji ePłatności

Zmodyfikowano okno Komunikacji z terminalem płatniczym dla urządzeń Polskich ePłatności, upraszczając jego interfejs. Z okna usunięto przycisk Sprzedaż, w zależności od kontekstu wyświetlany był także jako Zwrot oraz Unieważnienie jak również znacznik Blik.

 

Przyciski zostały przeniesione bezpośrednio na formularz dokumentów sprzedaży oraz panel Sprzedaży detalicznej. Dodano także automatyczne zamknięcie okna po 5 sekundach.

 

d)   Zapłać kartą – Polcard (zagadnienie Płatność kartą)

Nowo dodany przycisk, tj. Zapłać kartą został również dodany w przypadku skonfigurowanego modułu komunikacji z terminalami Polcard. Jego działanie jest analogiczne jak w przypadku terminali PeP. Oznacza to, że po wybraniu przycisku ustawiana jest karta płatnicza z włączoną Obsługą terminali płatniczych oraz wywoływane jest okno komunikacji z terminalem, dedykowane terminalom Polcard.