Toto je starší verze dokumentu!


Instalace bankovního platebního terminálu

Scénář

Chci zajistit on-line komunikaci mezi terminálem ISKAMu (dále jen ISKAMem) a platebním terminálem pro platby platebními kartami (dále jen „bankovní terminál“).

Postup

Při malé frekvenci plateb a pečlivé obsluze je možné se bez tohoto propojení obejít. ISKAM umožňuje evidovat provedení platby i bez přímé vazby na platební terminál. Platby kartou jsou umožněny jen v případě, že ve vlastnostech terminálu ISKAMu je nastaveno, že má připojen platební terminál (ve smyslu, že terminál je k dispozici a lze na něm provádět platby, i když připojení k počítači není žádné).

Pokud však provádíte platebních transakcí více a chcete eliminovat chyby obsluhy a zrychlit odbavení platební kartou, tak oceníte možnost přímého propojení s platebním terminálem. Tuto funkcionalitu nabízí ISKAM aktuálně pouze ve spolupráci s terminály od firmy SoNeT. Tato firma spolupracuje jen s některými bankami, proto tato je tato funkce podmíněna tím, že používáte některou z podporovaných bank. ISKAM prošel certifikací této firmy a je tedy schválen pro tento druh integrace.

Pokud se pro toto propojení rozhodnete, je potřeba počítat s tím, že banka, resp. některá z jejich servisních organizací, bude za implementaci této služby požadovat úhradu. Rovněž ApS Brno dodává tuto funkci do ISKAMu za podíl na nákladech na certifikaci a tato částka byla stanovena na 3000 Kč (bez ohledu na počet terminálů, kde tuto funkci využijete). Pro aplikaci této funkce je tedy nutné kontaktovat jak nás, tak Vaši banku.

Postup zprovoznění propojení s ISKAMem

Platební terminál je propojen do Vaší sítě pomocí běžného TCP/IP rozhraní a adresu získává z DHCP serveru (je však dobré si tuto adresu na DHCP serveru nastavit napevno, protože ji budete muset zadat do konfiguračního souboru). Adresu tedy zjistíte buď právě z DPHCP serveru, nebo přímo z bankovního terminálu (postup by měl být shodný pro všechny typy terminálu a měli byste se k adrese dostat pomocí menu terminál „Hlavní menu“⇒„Funkce“⇒„66“). Teminál ISKAMu by měl být umístěn ve stejné síti.

Při instalaci bankovního terminálu byste měli dostat i konfigurační soubor „hcterm.ini“, který musí být umístěn ve složce s ISKAMem. V tomto souboru najdete část věnovanou nastaveni IP adresy (viz ukázka níže) a adresu nastavíte. Knihovny hcterm.dll a hcterm64.dll (jejich výrobcem je firma SoNeT) jsou distribuovány spolu s ISKAMem, takže byste je měli v adresáři ISKAMu mít k dispozici.

!***********************
! server : IP address of terminal
! port   : server port
!***********************
[tcpip]
server=192.168.0.128
port=1818
count_reconnect=3
keepalive_use=y
keepalive_timeout=20000
keepalive_interval=1000

V nastavení terminálu ISKAMu je potřeba zvolit druh komunikace s bankovním terminálem „SoNeT“ (předpokládáme, že časem budou k dispozici i komunikace s jinými terminály jiných výrobců).

Po provedení těchto úkonů bude platba kartou (v ISKAMu ji zadáte běžným způsobem) automaticky odesílána na bankovní terminál a po úspěšném provedení transakce bude platba připsána na konto klienta. Je možné provádět i vrácení peněz na kartu klienta (libovolnou částku, i v případě, že původní platba byla třeba v hotovosti).

Úspěšně jsme testovali i možnost, že jeden bankovní terminál má nastaveno více terminálů ISKAMu (tj. např. dva terminály na recepci využívají jediný bankovní terminál). Samozřejmě během provádění platby z jednoho terminálu není možné zahájit platbu z druhého terminálu, na což je obsluha upozorněna.

Možné potíže a jejich řešení

Proces komunikace probíhá tak, že ISKAM předá na bankovní terminál požadavek na provedení platby/vratky. Dále se musí obsluha řídit pokyny na displeji bankovního terminálu. Po úplném dokončení transakce bankovní terminál pošle terminálu ISKAMu výsledek transakce. V případě chyby se objeví na obrazovce ISKAMu oznámení o chybě včetně důvodu, který terminál uvedl (stejný text se zobrazuje i na displeji platebního terminálu) a platba se neprovede.

Pokud by v průběhu transakce došlo k poruše spojení mezi platebním terminálem a terminálem ISKAMu, objeví se na obrazovce ISKAMu upozornění a dotaz, zda byla transakce dokončena úspěšně. V takovém případě je potřeba, aby obsluha podle výsledku operace na platebním terminálu správně rozhodla, zda platba byla nebo nebyla provedena.

Další tipy a triky

~~DISCUSSION~~