Platební terminály

1. Aktivace integrace pro pobočku

Integrace se aktivuje výhradně přes tým Membex - v Nastavení pobočky → záložka Integrace platebního terminálu) se zobrazí stav Aktivní až po vygenerování API klíče pro danou pobočku (typ TERMINAL_CONNECTOR).

Pokud je stav „Integrace není aktivní", kontaktujte podporu s žádostí o vygenerování API klíče.

2. Přidání platebního terminálu

  1. Jděte na Nastavení pobočky → záložka Platební terminál → Přidat terminál
  2. IP adresu a port Vám sdělí poskytovatel terminálu
  3. Název terminálu slouží pro Vaši potřebu, pojmenujte libovolně

3. Instalace aplikace Membex Connector

Terminal Connector je aplikace, která běží na PC pobočky a zprostředkovává komunikaci mezi Membex a fyzickým terminálem. Platební terminál musí být přístupný ze stejné lokální sítě, kde běží Terminal Connector.

Instalace:

  1. Stáhněte aktuální verzi
  2. Spusťte instalátor jako Správce

  1. Při první instalaci budete vyzváni k zadání ID pobočky a API klíče, které jste získali od podpory Membex v prvním kroku (Aktivace integrace pro pobočku). Opište/vložte údaje do terminálového okna a stiskněte ENTER

4. Po úspěšné instalaci se aplikace spustí a uvidíte ji v informačním panelu Windows.

Po kliknutí pravým tlačítkem myši na ikonu Membex se zobrazí nabídka:

    1. Služba
      1. Toto je služba ve Windows, pokud neběží, zkuste znovu spustit aplikaci z nabídky Start
    2. Cloud
      1. Signalizuje připojení na Membex
    3. Nápověda
      1. Přesměruje Vás na tuto stránku
    4. Otevřít logy
      1. Otevře složku ve Vašem počítači, kam se ukládají logy z komunikace s platebními terminály a s Membex.
      2. Časy v logu jsou v UTC (světový koordinovaný čas), nikoli v místním čase počítače - důvodem je jednoznačnost při přechodu na letní/zimní čas, kdy by místní čas mohl být nejednoznačný nebo by v logu vznikaly mezery.
      3. Logy se automaticky promazávají podle stáří: záznamy komunikace s terminály jsou uchovávány 90 dní, záznamy komunikace se službou Membex 7 dní.
      4. Logy je potřeba uchovávat pro případný audit ze strany poskytovatele platebního terminálu, jejich smazáním před uvedenou lhůtou porušujete podmínky poskytovatele.
    5. Konfigurace
      1. Zde je možné změnit ID pobočky nebo API klíč (je vyžadováno administrátorské oprávnění).
      2. Po změně konfigurace je potřeba restartovat aplikaci.
    6. Ukončit
      1. Ukončí aplikaci a odpojí Connector z Membex.
      2. Aplikace se automaticky spustí při dalším startu Windows.

Spuštění:

Windows: Membex Connector se spustí jako služba automaticky po instalaci, případně ho lze spustit z nabídky Start jako běžnou aplikaci

5. Stránka správy terminálů /payment-terminal/

Po přidání terminálu a spuštění Membex Connectoru přejděte v Membex (internetový prohlížeč) na Finanční operace → Platební terminály.

Co zde najdete:

  • Stav Membex Connector (nahoře) - Online / Offline / Neznámý, verze, čas poslední aktualizace, tlačítko pro odpojení Connectoru
  • Stav každého terminálu - Ready / Busy / Offline
    • Akce:
      • Obnovit stav
        • Vyšle příkaz na terminál s dotazem na stav
      • Handshake
        • Inicializuje spojení s terminálem, na displeji terminálu se zobrazí informace o probíhajícím handshake
      • Mezisouhrny
        • Vytiskne přehled transakcí bez uzávěrky na terminálu
        • Tento přehled se zobrazí i v Membex
      • Uzávěrka
        • Denní uzávěrka (VYNULUJE data v terminálu)
        • Vytiskne přehled transakcí na terminálu
        • Tento přehled se zobrazí i v Membex
      • Passivate
        • Přeruší čekající operaci na terminálu a vrátí terminál do klidového stavu
        • Funguje pouze pokud terminál dosud neodeslal platbu do banky
      • Odpojit konektor
        • Pošle Connectoru příkaz k odpojení
        • Connector má v sobě zabudouvanou funkci pro automatické znovu-připojování. V případě že potřebujete Connector trvale odpojit a není možnost ho odinstalovat z PC kde běží, je nutné požádat o změnu API klíče a poté kliknout na tlačítko odpojit v Membex.

5. Troubleshooting

Connector status je „Neznámý"

  • Pobočka nemá žádný nastavený terminál → přidejte alespoň jeden terminál (ping se posílá jen pro pobočky s terminálem) a počkejte cca 30 sekund - ping se odesílá každých 30 s.

Connector status je „Offline"

  • Zkontrolujte stav v informačním panelu Windows.
    • Služba je aplikace nainstalovaná na PC a pokud neběží, zkontrolujte stav ve správci úloh Windows, případně spusťte Connector z nabídky Start.
    • Cloud signalizuje spojení s Membex. Jsou možné tyto stavy:
      • Online - Připojeno k Membex, pokud přesto nefungují příkazy, ověřte, že jste přihlášeni ke stejné pobočce jako je nastaveno v konfiguraci Connectoru.
      • Připojování - Connector se pokouší připojit k Membex. Počkejte chvíli, stav by se měl změnit na Online.
      • Jiná instance připojena - někde běží jiná instance Connectoru připojená ke stejné pobočce. Ukončete ji a Connector se automaticky připojí do 60 sekund.
      • Odpojeno - Connector není připojen. Zkontrolujte připojení k internetu. Connector se pokusí znovu připojit automaticky

  • Zkontrolujte firewall

Terminál má status „Offline"

  • Terminal Connector běží, ale nemůže se připojit k fyzickému terminálu
  • Ověřte IP adresu a port v nastavení terminálu v Membexu
  • Zkontrolujte, zda je terminál zapnutý a dostupný na na stejné síti jako PC pobočky

Verze Connectoru je „zastaralá"

Transakce „zamčena" na terminálu

  • Na stránce /payment-terminal/ je vidět sekce Zámek u daného terminálu
  • Pokud transakce visí, použijte Passivate - přeruší čekající operaci
  • Pokud Passivate nepomůže, zámek se automaticky odblokuje po 90 vteřinách bez odpovědi
Odpovědělo to na vaši otázku? Díky za zpětnou vazbu Nastal problém při odesílání vaší zpetné vazby. Prosím, zkuste to později.

Stále potřebujete pomoc? Kontaktujte nás Kontaktujte nás