Page History
...
Section | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Prérequis
Protocole utilisé : VIC 1.07
Terminal de paiement Banksys avec port série compatible avec ce protocole : YOMANI, (XENTA, XENTISSIMO)
Terminal de paiement Banksys sans port série non compatible : YOXIMO
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 Blindé :
5m - 530 140 54 37
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.
Installation du SrvTerminal
Voici la configuration pour le port COM :
- Asynchronous
- Full duplex
- 1 start bit, 8 data bits, 1 stop bit
- Parity : None
- Speed : 9600 bps
- Physical encoding method : Non Return to Zero (NRZ)
- Byte serialisation : Least Significant Bit (LSB) first
En cas de problème, les spécialistes de chez Banksys pour les terminaux sont disponibles au 02/727.66.33
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.
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.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'installationFramework Microsoft .NET 4.0.
Une fois installé, vous devriez avoir un répertoire comme ceci :
C:\windows\Microsoft.NET\FrameWork\v2v4.0x.50727xxxxx
Le numéro de version du framework v2v4.0x.50727 xxxxx peut varier.
Installation et enregistrement de la DLL
- Téléchargez le fichier ZIP qui contient cette DLL.
- 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) - Pour enregistrer cette DLL dans la base de registre de Windows, 2 solutions sont possibles (manuelle ou automatisée) :
Solution manuelle
v2
En commande dos prompt mode administrateur, se placer dans le directory où se trouve le FrameWork C# (exemple : C:\windows\Microsoft.NET\FrameWork\v4.
0x.
50727xxxxx)
Lancer la commande DOS suivante :Code Block REGASM /codebase /tlb c:\windows\system32\int_bc.dll
Info 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 (Attention de bien lancer Logistics en mode administrateur !)
Installation de l'application SrvTerminal
- Si Télécharger la version installée de Flex/Logistics est supérieure ou égale à 4.0.6, télécharger la version 1.6 8 du SrvTerminal.
Si la version installée de Flex/Logistics est inférieur à 4.0.6, télécharger l'application SrvTerminal. - Sur le disque dur,
Sur le disque dur, créez un nouveau répertoire srvterminal : c:\srvterminal.
Warning 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. Dans ce répertoire, dézippez le contenu du fichier srvterminal.zip que vous venez de télécharger.
L'application srvterminal.exe fonctionnera uniquement si Logistics (ou Flex) est installé préalablement sur le poste (car srvterminal.exe utilise le même environnement visual FoxPro). Dans le cadre d'une utilisation de Logistics en Terminal Server, vous serez donc obligé d'installer Logistics WorkStation en local, même s'il n'est pas utilisé. Ne laissez donc pas de base de donnée sur le poste local au cas ou l'utilisateur démarrerait ce Logistics depuis la machine locale plutôt que depuis sa session TS. Supprimer éventuellement le racourcis de Logistics du bureau. Un programme setup sera bientôt mis à disposition pour installer SrvTerminal sans devoir installer Logistics.Tip title Conseils - Mettre cette application dans le menu de démarrage de Windows pour qu'elle se lance automatiquement (attention, n'utilisez que le srvTerminal.Bat que nous avons joint.).
- Mettre un raccourci sur le bureau de Windows pour pouvoir facilement démarrer cette application manuellement (sur le srvTerminal.Bat)
Nous avons joint un deuxième logiciel Manual_bc qui permet d'envoyer un montant au terminal sans passer par logistics. Un .Bat a été également prévu pour le lancer.Info
Ce programme peut être utilisé si vous rencontrez un problème avec notre serviceTerminal pour envoyer un montant au terminal sans passer par Logistics ou Flex.
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 :
Veuillez créer le répertoire sur votre disque dur : C:\Banksys
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ètrePOS_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
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 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).
Panel | ||
---|---|---|
| ||
Press <MENU> |
Note |
---|
Pour revenir à la situation initiale, au lieu de 4 - NVIC TICKET TERM indiquer 0 - PAS DE CAISSE |
Paramétrage de Flex/Logistics
- 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 :
- Veuillez créer le répertoire sur votre disque dur : C:\Banksys
- 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 Logistics (voir le paramètre
POS_TERMINAL_PAY_PATH
à créer du côté de 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
- Veuillez créer le répertoire sur votre disque dur : C:\Banksys
- 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
Warning title Impossible d'exécuter SrvTerminal.exe Si le fichier SrvTerminal.exe ne se lance pas ou si un message d'erreur indique qu'il manque le fichier msvcr71.dll, alors une Installation de « Logistics WorkStation » doit être réalisée sur le poste où SrvTerminal est lancé.
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).
Panel | ||
---|---|---|
| ||
|
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Note | ||
---|---|---|
| ||
Pour revenir à la situation initiale, au lieu de 4 - NVIC TICKET TERM indiquer 0 - PAS DE CAISSE |
Tip | ||
---|---|---|
| ||
Avec un nouveau terminal Banksys (affichage couleurs), après l'avoir configuré en liaison caisse, il faut préalablement faire |
Tip | ||
---|---|---|
| ||
Une fois la liaison installée, un paiement peut encore être transmis totalement manuellement sur le terminal à condition qu'il dispose d'un côté terminal VENDEUR. Pour cela, il faut faire |
Expand | |||||
---|---|---|---|---|---|
| |||||
|
Paramétrage de Logistics
Info |
---|
Rappel, il faut avoir B6 dans le |
Info |
Rappel, il faut avoir B6 dans le string des modules au niveau de la licence. |
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.
...
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 dans l'Identifiant pour le terminal de paiement. Voici la liste à respecter, veuillez introduire ces numéros :
...
les numéros suivants.
Tip | ||
---|---|---|
|
...
Numéro d'identifiant pour le terminal
...
American Express
...
122
...
Bancontact/MisterCash
...
128
...
Dinners Club
...
121
...
Eurocard
...
123
...
JBC
...
120
...
Maestro
...
127
...
MasterCard
...
123
...
Proton
...
125
...
Visa Electron
...
114
...
Visa
...
124
...
| |||||||||
Si le message ci-dessous s'affiche lorsqu'un paiement est effectué avec le terminal, alors un mode de paiement doit être ajouté dans la table des modes de paiement en remplissant l'Identifiant pour le terminal de paiement avec le numéro indiqué dans ce message d'erreur.
|
...
|
...
|
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
Warning |
---|
Pour définir ce chemin, il existe un paramètre général à créer dans le dossier via Fichier > Tables > Générales > Paramètres. Le paramètre à créer s'appelle : |
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.
Tip | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
Depuis la version 6.0.11 de Logistics, un seul mode de paiement peut être lié à plusieurs identifiants de paiement via le champ mémo Identifiants pour le terminal de paiement.
|
Paiement | ID | Paiement | ID | Paiement | ID | ||
---|---|---|---|---|---|---|---|
Bancontact/MisterCash | 128 | Pass promo 2 | 101 | Carwash | 74 | ||
Maestro | 127 | TINA | 100 | E-voucher | 73 | ||
Proton (load) | 126 | EIC | 99 | Loyalty card | 72 | ||
Proton (purchase) | 125 | Exxon | 98 | Pay Fair | 71 | ||
Visa | 124 | Cora Xenta | 97 | Sodexo e-Pass | 70 | ||
Eurocard Mastercard | 123 | Pass promo 3 | 96 | Ticket Restaurant (Edenred) | 69 | ||
American Express | 122 | Pass promo 4 | 95 | Reserved | 68 | ||
Dinners Club | 121 | Pass promo 5 | 94 | Reserved | 67 | ||
JBC | 120 | Pass promo 6 | 93 | Bancontact/MisterCash EMV (SEPA) | 66 | ||
National Company | 119 | Pass promo 7 | 92 | Emergency fallback (TINA EMV) | 65 | ||
International Company | 118 | Pass promo 8 | 91 | KADOZ | 64 | ||
FNAC | 117 | Pass promo 9 | 90 | AtosWorldline WL | 63 | ||
Smart Shopper | 116 | Pass promo 10 | 89 | RES | 62 | ||
M-BANXAFE | 115 | Pass promo 11 | 88 | Yourgift | 61 | ||
Visa Electron | 114 | Pass promo 12 | 87 | Giftcard | 60 | ||
Cirrus | 113 | Pass promo 13 | 86 | ORES | 59 | ||
Visa Cash | 112 | Pass promo 14 | 85 | Cartes Bancaires | 58 | ||
Clip | 111 | Pass promo 15 | 84 | Basic Card | 57 | ||
Aurora | 110 | Pass promo 16 | 83 | CCV Card | 56 | ||
109 | Visa VPAY | 82 | Equens WL | 55 | |||
108 | EZSwitch | 81 | Chèque | 54 | |||
SIS BPA Application | 107 | Chipknip | 80 | Travelcard | 53 | ||
Eloyse Application I and II | 106 | BANK | 79 | Smart Pay | 52 | ||
Pass CREDIT (PLC) | 105 | GIRO | 78 | UnionPay | 51 | ||
Pass CASH (PLC) | 104 | EPWS | 77 | Multi User | 50 | ||
Pass | 103 | Comfort card (CMFC) | 76 | Closed User | 49 | ||
Pass promo 1 | 102 | Prime line (PRLI) | 75 |
L'écran de paiement dans Logistics 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.
Logistics 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
Warning | ||
---|---|---|
| ||
|
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 Logistics et le SrvTerminal.
Codes d'erreur
Erreur 4000
Panel | ||
---|---|---|
| ||
You must disable this via the terminal: |
Erreur 60 OU PDV_STATE dans le log
Code Block |
---|
24/06/2019 09:58:22:831 --> 24/06/2019 09:58:22:831 --> Champ(4 - IEP_TX) -- 00 00 --> - 00
24/06/2019 09:58:22:831 --> 24/06/2019 09:58:22:831 --> Champ(9 - PDV_STATE) -- 00 00 00 00 --> - 00
24/06/2019 09:58:22:831 --> 24/06/2019 09:58:22:831 --> Champ(22 - TYPE DE MESSAGE) -- 60 --> - 00 |
Si vous rencontrez ce log, veuillez faire la procédure ci-dessus
ASTUCES
Il est possible de désactiver le Log se trouvant dans le répertoire de banksys en plaçant ce qui suit dans le fichier c:\SrvTerminal\srvTerminal.ini
DISABLE_LOG=YES
Environnement Citrix - réglage spécifique
Parfois, le terminal confirme que c'est bien payé mais la confirmation vers Logistics n'est pas faite.
En fait, Logistics veut créer ou déplacer un fichier mais l'action n'est pas effectuée ou effectuée trop tard.
Il faut alors éditer ces paramètres dans la base de registre :
HKLM\System\CurrentControlSet\Services\picadm\Parameters
CacheTimeout = 0
DirCacheTimeout = 0
RemoveableCacheTimeout = 0
"Carte refusée"
Si vous avez ce message, essayez de mettre les informations des cartes à jour dans le terminal
Menu :
4 - Other cards
7 - Paramétrage :
Choisir WORLDLINE BCMC et WORLDLINE EUROPE
STOP
STOP
STOP
le terminal redémarrera et l'erreur devrait être résolue.
Si ce n'est toujours pas le cas, il faudra alors téléphoner chez Banksys.