Prérequis

Le terminal Banksys doit être branché à l'aide d'un câble disponible chez banksys au numéro suivant : 02/727.88.99
Veuillez donc bien vérifier si ce câble existe chez votre client.
Voici les références disponibles de ces câbles :

Référence non blindé :
2m - 230 140 23 93
5m - 530 140 03 93

Référence Blindé :
5m - 530 140 54 37

Voici la configuration pour le port COM :

Paramétrage de la liaison vers le terminal de paiement Banksys

Fonctionnement

Il faut préalablement installer le SrvTerminal sur le PC qui sera physiquement connecté au terminal via le port série. SrvTerminal est une petite application de type service qui va tourner en tâche de fond sur cet ordinateur. Le SrvTerminal sera identifié par cette icône :

Celle-ci viendra s'ajouter aux services déjà actifs que l'on peut trouver à côté de l'horloge du système :

Ce service va pouvoir recevoir des fichiers de transactions à effectuer. Le PC qui fait une demande de transaction ne doit pas forcément être le poste sur lequel le service tourne, c'est-à-dire le poste où le terminal est connecté physiquement. Ainsi, plusieurs postes caisses peuvent travailler avec un terminal de paiement unique. Les transactions envoyées au service terminal seront traitées l'une après l'autre, nous avons donc ici la possibilité d'avoir une file d'attente pour les transactions à effectuer.

Paramétrage de la liaison vers le terminal de paiement Banksys

Installation du SrvTerminal

Pour faire tourner SrvTerminal, il faut préalablement installer une DLL qui s'appelle bc_int.dll.
Cette DLL a été écrite en C sharp (C#), dès lors, pour que cette DLL tourne, il faut avant tout installer le Microsoft.NET FrameWork. Une fois ce FrameWork installé, il faut copier cette DLL dans le répertoire Windows/System32 (si système en 64 bit, copier dans le répertoire Windows/SysWOW64) et l'enregistrer.

Concrètement, voici les étapes à suivre pour installer SrvTerminal et sa DLL bc_int.dll

Installation du FrameWork Microsoft.NET

Téléchargez le fichier d'installation.

Une fois installé, vous devriez avoir un répertoire comme ceci :
C:\windows\Microsoft.NET\FrameWork\v2.0.50727
Le numéro de version du framework v2.0.50727 peut varier.

Installation et enregistrement de la DLL

1. Téléchargez le fichier ZIP qui contient cette DLL.
   
   
2. Dézippez le contenu de ce fichier dans le répertoire c:\windows\system32
   (2 fichiers y seront copiés : Int_BC.dll et Int_BC.tlb)
   
   
3. Pour enregistrer cette DLL dans la base de registre de Windows, 2 solutions sont possibles (manuelle ou automatisée) :
   
   

   • Solution manuelle
     
     En commande dos prompt, se placer dans le directory où se trouve le FrameWork C# (exemple : C:\windows\Microsoft.NET\FrameWork\v2.0.50727)
     
     Lancer la commande DOS suivante :

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

     Pour un désenregistrement, la commande qu'il faudrait exécuter serait la même mais avec /u à la fin.

     Résultat :
     

   • Solution automatisée (via Logistics/Flex)
     
     Cliquez sur le bouton Enregistrement du composant
     
     

Installation de l'application SrvTerminal

1. Si la version installée de Flex/Logistics est supérieure ou égale à 4.0.6, télécharger la version 1.6 du SrvTerminal.
   Si la version installée de Flex/Logistics est inférieur à 4.0.6, télécharger l'application SrvTerminal.
   
   

2. Sur le disque dur, créez un nouveau répertoire srvterminal : c:\srvterminal.

   Veuillez créer le répertoire srvTerminal au même niveau que le répertoire qui va recevoir les fichiers de transactions (voir plus loin le paramètre POS_TERMINAL_PAY_PATH)
   Exemple, si le répertoire des fichiers des transactions est c:\Banksys alors créez c:\srvTerminal.

3. Dans ce répertoire, dézippez le contenu du fichier srvterminal.zip que vous venez de télécharger.
   
   

4. Voilà, le service est quasi prêt à l'emploi ! Une chose reste à faire, introduire 2 paramètres dans le fichier srvterminal.ini. Ouvrez ce fichier avec le bloc note de windows :
   
   
   
   
   1. Veuillez créer le répertoire sur votre disque dur : C:\Banksys
      
      
   2. Il vous reste donc à indiquer sur quel port com le terminal est connecté, et où se trouve le répertoire où les fichiers de transactions vont être placés par Flex/Logistics (voir le paramètre POS_TERMINAL_PAY_PATH à créer du côté de Flex/Logistics pour modifier ce chemin). Indiquez C:\Banksys comme répertoire de transaction, POS_TERMINAL_PAY_PATH aura donc comme valeur C:\Banksys aussi. En Terminal serveur, on aurait donc : \\TSCLIENT\C\Banksys
      
      
5. Si toutes les étapes ont été respectées, le service peut à partir de maintenant démarrer.
   En cas de problème, une fenêtre s'ouvre pendant 5 secondes avec l'explication du problème, et ensuite se referme.
   
   
   
   Les 2 messages d'erreurs possibles sont :
   • Terminal.CTerminal' (DLL) can't be initialised, please register it...
   • Directory error, check if exist : xxxxxxxxxxx

Paramétrage de la liaison vers le terminal de paiement Banksys

Paramétrage du terminal de paiement Banksys

Une dernière chose importante, il faut activer au niveau du terminal Banksys l'option qui indique à ce dernier que c'est désormais une application externe connectée qui va envoyer les informations des transactions à réaliser. Voici ci-dessous la procédure à suivre (procédure qui nous a été communiquée par la société Banksys).

Paramétrage de la liaison vers le terminal de paiement Banksys

Paramétrage de Flex/Logistics

Dans le paramétrage général, onglet Options, paramètre Options Point de Vente, paramètre Utilisation de l'interface POS, une nouvelle case à cocher apparaîtra : Gestion d'un terminal de paiement. Il faut la cocher et re-démarrer l'application.

Paramétrage des modes de paiements

Paramétrez la Table Modes de paiement via le menu Fichier > Tables > Tiers > Modes de paiement.

Introduisez la liste des modes de paiements que le magasin accepte au niveau des paiements par carte.

Pour rappel, le mode de paiement cash doit avoir le numéro d'ordre 1. Voir Table Modes de paiement.

Pour les modes de paiements par carte, ils ont un numéro d'ordre supérieur à 1, et il FAUT indiquer un numéro d'identification, voici la liste à respecter, veuillez introduire ces numéros :

Il est également conseillé de créer un mode de paiement Autre et de lui donner comme identifiant le chiffre 999. De cette manière, si le client passe une carte acceptée par le terminal mais que le mode de paiement correspondant n'existe pas dans la table des modes de paiements, le programme introduira le montant dans cette case. On pourra ensuite adapter la table des modes de paiement après avoir identifié le mode de paiement qui ne serait pas introduit dans Flex/Logistics.

L'écran de paiement dans le programme est désormais un peu différent :

Tous les modes de paiement autres que Cash sont grisés. Quand le client paie son achat avec une carte, l'utilisateur va lancer la transaction en appuyant sur Carte bancaire.

Le programme demandera confirmation du montant de la transaction (au cas où le paiement par carte serait partiel).

Fichiers de transaction

Logistics génère alors un fichier de transaction dans le répertoire : c:\Banksys

Ce fichier sera traité immédiatement par le service srvterminal (pour autant qu'il n'y ait pas d'autres transactions dans la file d'attente).

Une fois la transaction traitée, le fichier sera déplacé soit dans le sous-répertoire Error en cas de problème, soit dans Processed si le paiement est bien passé.

Un fichier de transaction se présente comme ceci :

Le répertoire HistLog contient l'historique de toutes les informations qui ont été affichées dans l'écran de paiement dans la partie verte qui affiche l'état d'avancement de la transaction engagée.

Un fichier est créé par année et par mois.

Dans l'écran de paiement, un bouton Mode Manuel a été ajouté afin de pouvoir à tout moment repasser en mode manuel, c'est-à-dire que l'opérateur devra introduire manuellement le montant payé dans la bonne case ! Ce bouton n'est utile que dans le cas où il y aurait un problème de communication entre l'application Flex/Logistics et le SrvTerminal.

Paramétrage de la liaison vers le terminal de paiement Banksys