Voorvereisten

Gebruikt protocol : VIC 1.07

Banksys betaalterminal met een seriele poort die compatibel zijn met het protocol : YOMANI, (XENTA, XENTISSIMO)

Banksys betaalterminal zonder seriele poort die niet compatibel is : YOXIMO

De Banksys terminal moet aangesloten zijn met een geschikte kabel (verkrijgbaar bij Banksys op volgend nummer: 02/727.88.99)
Gelieve dus goed te controleren of deze kabel aangesloten is bij uw klant.
Dit zijn de beschikbare referenties van de kabels:

Referentie (niet afgeschermd):
2m - 230 140 23 93
5m - 530 140 03 93

Referentie (afgeschermd):
5m - 530 140 54 37

Port COM :

Begin van de pagina

Hoe werkt de module ?

Om te beginnen installeert u de SrvTerminal op de PC die fysiek verbonden zal zijn met de terminal via seriële poort. SrvTerminal is een kleine applicatie (een service) die op de achtergrond zal draaien op deze computer. De SrvTerminal zal geïdentificeerd zijn door dit icoon:

Dit zal toegevoegd worden aan de actieve services in de taakbalk (aan de kant van de systeemklok):

Deze service zal bestanden van uit te voeren transacties kunnen ontvangen. De PC die een transactievraag verstuurt moet niet per se dezelfde machine zijn waarop de service draait, dus waaraan de terminal fysiek verbonden is. Zo kunnen meerdere kassa machines werken met een enkele betaalterminal. De transacties die verzonden worden naar de service worden een voor een behandeld. Hierdoor bestaat echter wel de mogelijk dat er een wachtrij ontstaat voor de uit te voeren transacties.

Begin van de pagina

Installatie van SrvTerminal

Om SrvTerminal te laten draaien moet eerst een DLL geïnstalleerd worden, bc_int.dll.
Deze DLL is geschreven in C sharp (C#) dus moet, om deze DLL te kunnen gebruiken, eerst het Microsoft.NET Framework geïnstalleerd worden. Eenmaal dit Framework geïnstalleerd, kopieert u deze DLL in de map Windows/System32 (voor een systeem 64 bit, kopieer deze DLL in de map Windows/Syswow64) en dient u hem te registreren.

Concreet, hier zijn de stappen om SrvTerminal en zijn DLL bc_int.dll te installeren.

Installatie van het Microsoft.NET FrameWork

U downloadt eerst het installatiebestand.

Eenmaal geïnstalleerd, zou u een map moeten vinden als deze:
C:\windows\Microsoft.NET\FrameWork\v4.x.xxxxx
Het framework versienummer v4.x.xxxxx kan variëren.

Installatie en registratie van de DLL

1. U kunt het zipbestand dat de DLL bevat hier downloaden banksys_dll.zip.
2. Unzip de inhoud van dit bestand naar c:\windows\system32.
   (2 bestanden worden gekopieerd: Int_BC.dll en Int_BC.tlb)
3. Om deze DLL te registreren in het register van Windows zijn er twee mogelijkheden (manuele of automatische oplossing):
   
   

   • Manuele oplossing
     
     Ga in een dos prompt (als administrator) naar de map waar het C# FrameWork zich bevindt (bijvoorbeeld: C:\windows\Microsoft.NET\FrameWork\v2.0.50727)
     
     Voer volgend DOS commando uit:

     REGASM /codebase /tlb c:\windows\system32\int_bc.dll

     Ter informatie, voor een ont-registratie zou hetzelfde commando moeten uitgevoerd worden maar dan met /u op het einde.

     Resultaat:
     

   • Automatische oplossing (via Logistics/Flex)
     
     Klik op de knop De component wordt bewaard (Opgelet: U dient Logistics als administrator op te starten!)
     
     

Installatie van de applicatie SrvTerminal

1. Download de applicatie srvterminal hier.
   Als de geïnstalleerde versie van Flex/Logistics hoger of gelijk is aan 4.0.6, is het aangeraden om versie 1.6 van SrvTerminal te gebruiken, hier te downloaden.

2. Maak op uw harde schijf een nieuwe map aan: C:\srvterminal

   Let erop de map srvTerminal aan te maken op hetzelfde niveau van de map die de transactiebestanden zal bevatten (zie verder, de parameter POS_TERMINAL_PAY_PATH). Als de map van de transactiebestanden bijvoorbeeld C:\Banksys is, maak dan C:\srvTerminal aan.

3. Unzip in deze map de inhoud van het bestand srvterminal.zip dat u net hebt gedownload.
   

   
   

4. De service is bijna klaar om te gebruiken ! Er rest nog een iets te doen, namelijk 2 parameters invoeren in het bestand srvterminal.ini. Open dit bestand met windows kladblok :
   
   
   
   
   1. Let erop de map C:\Banksys op uw harde schijf aan te maken.
   2. U moet nu aangeven op welke COM poort de terminal is aangesloten, en waar de map zich bevindt waar de transactiebestanden geplaatst zullen worden door Flex/Logistics (zie de parameter POS_TERMINAL_PAY_PATH in Flex/Logistics om dit pad te wijzigen). Duid C:\Banksys aan als transactiemap, POS_TERMINAL_PAY_PATH zal dus ook als waarde C:\Banksys hebben. In Terminal Server zullen we dus hebben: \\TSCLIENT\C\Banksys.
5. Als alle stappen goed uitgevoerd zijn, kan de service nu starten.
   In geval van een probleem zal een venster openen voor 5 seconden met een uitleg van het probleem, en zichzelf vervolgens weer sluiten.
   
   
   
   De 2 mogelijke foutboodschappen zijn :
   • Terminal.CTerminal' (DLL) can't be initialised, please register it...
   • Directory error, check if exist : xxxxxxxxxxx

Bovenaan pagina

Instellen van uw Banksys betaalterminal

Tenslotte moet in de Banksys terminal de optie geactiveerd worden die aangeeft dat de terminal voortaan verbonden is met een externe applicatie die informatie zal verzenden over de uit te voeren transacties. Zie hieronder voor de procedure die gevolgd moet worden (die naar ons gecommuniceerd is door de maatschappij Banksys).

Begin van de pagina

Instellingen in Flex/Logistics

In de algemene parameters, tabblad Opties, parameter Beheer Verkooppunt, parameter Gebruik van de POS interface, tabblad Beheer van een betalingsterminal, zal een nieuw aankruisvakje verschijnen: Beheer van een betaalterminal. Vink dit vakje aan en herstart de applicatie.

Instellen van de tabel met betalingswijzen

Instellen van de tabel met betalingswijzen: Ga naar het menu Bestand > Tabellen > Derden > Betalingswijzen.

Voer de lijst met betalingswijzen in die de winkel ondersteunt op vlak van betaalkaarten.

Ter herhaling, de betalingswijze CASH moet steeds nummer 1 hebben. Zie Tabel Betalingswijzen.

De betalingswijzen met kaart hebben een volgordenummer groter dan 1, en u moet verplicht volgende identificatienummers opgeven.

Het betaalscherm in het programma is nadien lichtjes anders:

Alle betalingswijzen behalve Cash zijn grijs. Als de klant zijn aankoop met kaart betaalt, zal de gebruiker de transactie starten door te klikken op Bankkaart.

In geval van gedeeltelijke betaling zal het programma bevestiging vragen voor het bedrag.

Begin van de pagina

Transactiebestanden

Logistics maakt nu een transactiebestand aan in de map C:\Banksys.

Dit bestand zal onmiddellijk verwerkt worden door de service srvterminal (voor zover er geen andere transacties in de wachtrij staan).

Eenmaal de transactie behandeld is, zal het bestand verplaatst worden ofwel naar de submap Error in geval van probleem, ofwel naar Processed indien de betaling correct verlopen is.

Een transactiebestand ziet er als volgt uit :

De map HistLog bevat de geschiedenis van alle berichten die zijn getoond in het groene deel van het betaalscherm, dat de voortgang van de transactie toont.

Een bestand is aangemaakt per jaar en per maand.

In het betaalscherm werd een knop Manueel toegevoegd om op elk moment te kunnen overgaan naar de manuele mode, d.w.z. dat de operator het betaalde bedrag manueel moet invoeren in het juiste veld! Deze knop is enkel nuttig als er een communicatieprobleem is tussen de Flex/Logistics applicatie en srvterminal.

Begin van de pagina

Foutcodes

Overzicht

Begin van de pagina

Fout 4000

Manage Terminal

You must disable this via the terminal:
• Press STOP - OK - MENU in sequence
• 3.
• 0.
• 9.
• 1235789 + OK
• 4. Hardware settings
• 2. ECR protocol
• NVIC OK
• Ticket OK
• Ticket width OK
• STATE INFORMATION must be "BY ECR", not "ALWAYS"

Begin van de pagina

Fout 60 of vermelding PDV_STATE in de logging

Voer de bovenstaande procedure uit als u dit in het logboek tegenkomt

Begin van de pagina

Citrix omgeving - specifieke instelling

Soms bevestigt de terminal dat deze goed is betaald, maar wordt er geen bevestiging aan Logistics gegeven.

Logistics wil telkens een bestand maken of verplaatsen, maar deze actie wordt niet of te laat uitgevoerd.

Daarom moet u deze parameters in het register bewerken:

HKLM\System\CurrentControlSet\Services\picadm\Parameters
CacheTimeout = 0
DirCacheTimeout = 0
RemoveableCacheTimeout = 0

Begin van de pagina

"Kaart geweigerd"

Als u dit bericht hebt, probeer dan de actieve kaartinformatie in de terminal bij te werken

Menu : 
4 - Other cards 
7 - Parameters : 
Kies WORLDLINE BCMC en WORLDLINE EUROPE
STOP
STOP
STOP 
De terminal zal opnieuw opstarten en de fout zou moeten zijn opgelost.

Als dit nog steeds niet het geval is, gelieve Banksys te bellen.

Begin van de pagina