Deze module verbindt Logistics met de betaalterminal van Banksys via TCP/IP. Dit betekent dat de gebruiker niet langer handmatig de betaalmethode van een verkoop hoeft op te geven. Indien men kiest voor Bankkaart in het betalingsscherm, stuurt Logistics het transactiebedrag naar de terminal. Van zodra de transactie voorbij is, voegt Logistics het betaalde bedrag automatisch toe in de gebruikte betalingswijze van de klant. Op deze manier worden omkeringsfouten tussen betaalmethoden voorkomen.
De module Beheer van een betalingsterminal is een uitbreiding van de module Y (Module Betalingenbeheer). In de string met modules moet B6 staan. |
|
Op deze blz |
|
|
Voorwaarden
Gebruikt protocol: CTEP
Betaalterminal van Banksys gekoppeld via een LAN ethernet kabel
Winbooks Worldline Service (WWService) geïnstalleerd op een PC (met een vast IP adres) in dezelfde LAN als die van de Banksys terminals.
Laatste versie van Logistics 6.2
Framework .NET versie 4.6.2
Installatiepakket van de WWService (laatste update : hier)
Begin van de pagina
Gebruik
De communicatie tussen Logistics en de Banksys-terminals gebeurt met de Winbooks Worldline Service (WWService), die als coördinator dient voor het verzenden van betalingsaanvragen naar de terminals en voor de feedback terug naar Logistics.
Begin van de pagina
Winbooks Worldline Service (WWService)
WWService is een Windows-service waardoor de Banksys-terminals en Logistics met elkaar kunnen communiceren.
WWService kan verschillende terminals beheren, maar kan ook op verschillende machines worden geïnstalleerd, zodat elke computer een enkele terminal Banksys beheert.
Voorbeeld implementatieschema
- Terminals en Logistics in dezelfde LAN
- Logistics uitgevoerd op een externe TS-server, verbinding met WWService via VPN
- Logistics uitgevoerd op externe TS-server, verbinding met WWService via WAN
In het geval van externe toegang via WAN, raden wij u aan om het gedeelte "communicatie beveiligen" aandachtig te lezen. |
Controleer in het geval van een verbinding via WAN met WWService of u beschikt over een vast Wan IP-adres. Anders is het nodig om een DynDns-service te configureren en Logistics met dit adres te configureren. |
Begin van de pagina
Installatie
U kunt het installatiebestand van de Winbooks Worldline-service downloaden via deze link.
De Banksys-terminal maakt verbinding met een IP-adres, dus het is belangrijk dat de computers met WWService in de LAN zijn geconfigureerd met een vast IP-adres. |
Sluit Logistics tijdens een WWService-update.
Overzicht van de installatieschermen van de service.
Aan het einde van de installatie wordt een venster (Winbooks Worldline View) geopend om u in staat te stellen de service te configureren
Indien na het heropstarten van de pc de terminals niet automatisch ingevuld worden, gelieve na te kijken of de gebruiker schrijfrechten heeft in de map waar de WWService draait. Deze info wordt nl. in het tekstbestand port.list onthouden. |
Begin van de pagina
Configuratie
De volledige configuratie van de service gebeurt uitsluitend via de Winbooks Worldline View (WWView).
Configuratie van een terminal
Let op! Dit onderdeel kan verschillen, afhankelijk van uw terminal en uw versie. In geval van twijfel, raadpleeg de documentatie van uw terminal of neem contact met worldline op. (Support: +32 (0)2 727 88 99)
|
- Open het terminalmenu met volgende combinatie : Stop, OK, Menu
- Kies 3 SETUP TERMINAL
- Ga naa de 2de blz. via 0 of kies de optie 10 SUIVANT
- Kies 9 SEUL TECHNICIEN
- Geef het paswoord in ( standaard 123 5 789 )
- Kies 4 HARDWARE SETTING
- Kies 2 ECR PROTOCOL
- Kies het protocol CTEP en ga terug naar de vorige menukeuze => OK
- Kies 9 ECR PHYSICAL CONF
- Kies TCP/IP => OK
- Kies Client => OK
- Geef het IP adres in van de machine waar de WWService draait ( Zie het voorbeeld na de instructies. Merk op dat het belangrijk is dat de machine die de WWService host een Fixed IP heeft)
- Geef de luisterpoort van de terminal in (standaard 9000. Als meerdere terminals verbinding maken met dezelfde WWService, moeten ze allen een andere poort gebruiken! ) => OK
- Verlaat de menu's via 3 x Stop
- De terminal start opnieuw op met de nieuwe configuratie
Voorbeeld ingave van het het ip adres 192.168.10.5 ( U kunt steeds de knop Corr gebruiken om foutieve waarden te schrappen )
- 192 => OK
- 168 => OK
- 10 => OK
- 5 => OK
- => OK
Configuratie terminal YUMI type ? |
Zorg ervoor dat de klant het wachtwoord heeft om de configuratie via de "winkelier"-gebruiker in te voeren
Om de configuratie in te voeren:
- Ga naar "TERMINAL MANAGER"
- Zoek naar het submenu Kassier
- Kies “SELECTED MODE” en kies het protocol “CTEP” “DEFINE” “START SETUP”
- Kies “ERC PHYSICAL CONF” en kies het “ETHERNET” protocol
- Geef het IP-adres van de "Kassa"-pc in (het moet een VAST IP zijn, bijvoorbeeld 10.0.0.32)
- Geef het te gebruiken POORTNUMMER in. bv 9000
- "DEFINE"
- "START SETUP"
Begin van de pagina
Configuratie van de firewall van de pc die de WWService host
Poort 6127 en de terminalpoorten moeten open en geautoriseerd zijn in het TCP-protocol op de firewall op de computers die de WWService als invoer en uitvoer hosten.
Begin van de pagina
Voeg een terminal toe aan de WWService
Nadat u uw Banksys-terminal hebt ingesteld met het IP-adres van de computer en de poort die de terminal zal benaderen, klikt u op de knop Toevoegen van de WWView
In het scherm Add Terminal vult u de poort in die u in de terminal hebt opgegeven.
Nadat het scherm is gevalideerd, wordt het begin van het luisteren naar de poort gestart en wordt er een regel toegevoegd aan het raster of wordt er een terminalkolom toegevoegd met het woord "Listen".
Zodra de terminal is verbonden, wordt de lijn groen en vervangt de terminal-id de "Listen".
Op de Banksys-terminal wordt de tekst "NO CAISSE CONNECTION" vervangen door de formulering "READ CARD"
Als uw lijn op "Luisteren" blijft staan, controleer dan of de gecodeerde poort degene is die in de terminal is geconfigureerd en dat deze poort open is in de computerfirewall. Doorgaans maakt de terminal binnen 30 seconden verbinding |
Begin van de pagina
Bekijken events
U kunt de reeks bewerkingen die door de WWservice worden uitgevoerd volgen in de Windows-observatielogboeken
U kunt ook een samenvatting van de transacties bekijken via WWView in het tabblad Transaction
Begin van de pagina
Communicatie beveiligen.
De communicatie tussen WWservice, de WWView-klanten en Logistics is gebaseerd op de Windows Communication Foundation-technologie.
Om de installatie en de configuratie eenvoudig te houden, is standaard de communicatie tussen Logistics en WWService niet beveiligd.
Normaal is het niet nodig om de beveiliging aan te passen, omdat de WWService niet buiten de LAN wordt blootgesteld. Maar als u de WWService rechtstreeks via WAN blootstelt, wordt het aanbevolen om de communicatie te beveiligen door de bindingen van de service en die van de klanten te wijzigen.
U kunt zich hiervoor baseren op de Microsoft-documentatie voor het personaliseren van bindingen.
Hieronder vindt u twee voorbeelden van beveiliging, de eerste met de standaardconfiguratie van de component WsHttpBinding en een tweede op basis van Windows-gebruikers.
De bindingsbestanden moeten naar dezelfde locatie worden gekopieerd als hun uitvoerbare bestanden |
Voorbeeld van bindingen volgens de standaardconfiguratie van wsHttpBinding
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1"/>
</startup>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WWServiceBinding"/>
</wsHttpBinding>
</bindings>
<services>
<service behaviorConfiguration="WWServiceBehavior" name="WWService.WWWCF">
<endpoint address="" binding="wsHttpBinding" contract="WWService.IWWWCF"/>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="WWServiceBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
</behavior>
</serviceBehaviors>
</behaviors>
<serviceHostingEnvironment multipleSiteBindingsEnabled="true"/>
</system.serviceModel>
<system.webServer>
<modules runAllManagedModulesForAllRequests="true"/>
</system.webServer>
</configuration>
|
|
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_IWWWCF" />
</wsHttpBinding>
</bindings>
<client>
<endpoint address="http://wb-lt-170523-00:6127/" binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_IWWWCF" contract="WWService.IWWWCF"
name="WSHttpBinding_IWWWCF">
<identity>
<servicePrincipalName value="host/WB-LT-170523-00.winbooks.be" />
</identity>
</endpoint>
</client>
</system.serviceModel>
<startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1"/></startup></configuration> |
|
Voorbeeld van bindingen volgens de verbindingsbeveiliging met Windows-gebruikers
Als u de volgende configuratie gebruikt: - Als u zich in een domein bevindt: de machine waarop de WWService wordt gehost en de clients moeten in deze laatste zijn geregistreerd.
- Als u geen domein gebruikt: de machine die de WWService host, moet lokale Windows-gebruikersaccounts (met dezelfde wachtwoorden) hebben als de computers die verbinding willen maken met de WWService.
|
U kunt de configuratiebestanden hier downloaden
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1"/>
</startup>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WWServiceBinding">
<security mode = "Message">
<message clientCredentialType="Windows" />
</security>
</binding>
</wsHttpBinding>
</bindings>
<services>
<service behaviorConfiguration="WWServiceBehavior" name="WWService.WWWCF">
<endpoint address="" binding="wsHttpBinding" contract="WWService.IWWWCF"/>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="WWServiceBehavior">
<serviceMetadata httpGetEnabled="true"/>
<serviceDebug includeExceptionDetailInFaults="true"/>
</behavior>
</serviceBehaviors>
</behaviors>
<serviceHostingEnvironment multipleSiteBindingsEnabled="true"/>
</system.serviceModel>
<system.webServer>
<modules runAllManagedModulesForAllRequests="true"/>
</system.webServer>
</configuration> |
|
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.serviceModel>
<bindings>
<wsHttpBinding>
<binding name="WSHttpBinding_IWWWCF" >
<security mode = "Message">
<message clientCredentialType="Windows" />
</security>
</binding>
</wsHttpBinding>
</bindings>
<client>
<endpoint address="http://wb-lt-170523-00:6127/" binding="wsHttpBinding"
bindingConfiguration="WSHttpBinding_IWWWCF" contract="WWService.IWWWCF"
name="WSHttpBinding_IWWWCF">
<identity>
<servicePrincipalName value="host/WB-LT-170523-00.winbooks.be" />
</identity>
</endpoint>
</client>
</system.serviceModel>
<startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6.1"/></startup></configuration> |
|
Begin van de pagina
WWService-instellingen in Windows Service Manager (optioneel)
U kunt het gedrag van de verschillende services aanpassen via de Windows Service Manager.
U kunt toegang tot deze manager krijgen via de opdracht services.msc via het Windows-runmenu
De Winbooks Worldline Service kunt u in de lijst met services zoeken. Klik met de rechtermuisknop op de lijn en kies Eigenschappen.
In het configuratiescherm heeft u een aantal opties om de werking van de service aan te passen, zoals:
- Het opstarttype (handmatig is geen goede keuze)
- Definieer een specifiek gebruikersaccount voor de service
- Het gedrag bepalen na een servicefout
- enz.
|
|
We raden u aan om, om te garanderen dat de WWService beschikbaar blijft, zelfs in geval van een storing waarvoor een afsluiting nodig is, de herstelopties in te stellen op "De service opnieuw opstarten". U kunt de fouten die een afsluiting hebben veroorzaakt bekijken via het Windows-gebeurtenislogboek.
|
Begin van de pagina
Logistics
Instellingen Logistics
Ter herinnering: het is noodzakelijk om B6 in de string van de modules te hebben op het niveau van de licentie. |
Als u een lagere versie dan 6.2.6 gebruikt en u kunt de versie niet bijwerken. Als de nieuwste versie van WWService is geïnstalleerd, moet u de volgende parameter toevoegen in de tabel met programmaparameters (beschikbaar via het menu Bestand > Tabellen > Algemeen > Parameters):
Code: "WWCLIENT" Waarde: "1.0.6.0" |
In de algemene instellingen, het tabblad Opties, parameter Beheer Verkooppunt, parameter Gebruik van de POS-interface, tabblad Beheer van een betalingsterminal verschijnt een nieuw selectievakje: Beheer van een betaalterminal met TCP/IP.
Het is mogelijk om een terminal te gebruiken die is aangesloten op een seriële poort en tegelijk een andere terminal die met TCP/IP is verbonden. In dit geval moet u ook 'Beheer van een betalingsterminal' aanvinken naast het 'Beheer van een betalingsterminal met TCP/IP'. De verdere configuratie moet in de dagboekinstellingen worden gedaan. Merk op dat het niet mogelijk is om een seriële terminal en een TCP/IP terminal voor hetzelfde dagboek te gebruiken. |
Bij het parametreren van de instelling van deze optie kunt u het adres van een WWService opgeven dat standaard in de toepassing wordt gebruikt.
Om te controleren of de opgegeven WWService functioneel is, kunt u de knop 'Verbindingstest' gebruiken.
Een aangepaste foutboodschap wordt getoond indien nodig.
Als u de knop 'Verbindingstest' gebruikt, wordt een log-bestand met de naam 'WWClientDebug.txt' gemaakt in de map WWClient in de installatiemap van uw werkstation. |
Begin van de pagina
Instellingen dagboeken
In het tabblad Optie Terminal Banksys TCP/IP vindt u alle opties die specifiek zijn voor het beheer van de TCP/IP-terminal.
Opties | Omschrijving |
---|
Gemeenschappelijke configuratie voor werkstations | Als deze optie actief is, gebruiken de werkstations dezelfde configuratie voor Banksys voor het geselecteerde dagboek. |
Dit journaal gebruikt een TCP/IP terminal | Deze optie verschijnt alleen als u beide terminalsoorten gebruikt. U moet deze optie selecteren als dit dagboek een TCP / IP-betaalterminal gebruikt |
Serviceadres | IP adres van de WWService voor dit dagboek. Indien leeg wordt het adres uit de algemene parameters gebruikt |
ID van de terminal | Terminalnummer, gebruik de knop ... om een lijst te bekomen van alle aangesloten en functionele WWService terminals.
Als er slechts één terminal beschikbaar is, wordt het nummer ervan direct in het veld aangegeven |
Verzonden expressie voor terminal ticket printer
| De uitdrukking wordt vóór de betaling geëvalueerd en naar de terminal verzonden om het REF-veld van het afgedrukte ticket te personaliseren.
|
Volgende instellingen zijn nodig om te voorkomen dat een PC die de terminal NOOIT gaat gebruiken, telkens gaat zoeken naar de beschikbaarheid van de aangesloten Banksys terminals tijdens het opstarten van Logistics: - de parameter "Gemeenschappelijke configuratie voor werkstations" NIET activeren;
- voor elk station die wel een terminal gebruikt, de betrokken TCP/IP configuratie invullen.
|
Begin van de pagina
Instellingen betalingswijzen
Parametreer het bestand Betalingswijzen via de 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.
Indien deze boodschap getoond wordt wanneer een betaling met het apparaat wordt uitgevoerd, moet de nieuwe betaalmethode aan de tabel met betaalmethoden worden toegevoegd. Hiervoor gebruikt U als Identificatienummer voor de betaalterminal het nummer dat in de foutboodschap vermeld wordt. Het is ook aangewezen om een betaalmethode Andere aan te maken met als "identificatie voor de betaalterminal" het cijfer 999 te geven. Op deze manier zal, als de klant een door de betaalterminal geaccepteerde kaart gebruikt, maar de bijbehorende betaalmethode niet in de tabel met betalingswijzen voorkomt, Logistics het bedrag aan deze methode koppelen. Vervolgens kan U de tabel met betalingswijzen uitbreiden met deze nieuwe betaalmethode. |
|
|
Let op! De betalingscodes voor het TCP/IP protocol en deze voor een seriële poort zijn niet dezelfde!
U moet de verzamelde betalingsreferenties gebruiken om dezelfde betalingsmethode te gebruiken voor een TCP/IP terminal en een seriële terminal. |
Sinds Logistics versie 6.0.11 kan u een enkele betaalmethode via het Memo-veld Identificators voor de betaalautomaat koppelen aan meerdere betalingswijzen.
Bij voorbeeld, de identificatiegegevens 1001 (Bancontact / MisterCash) en 1013 (BC / MC EMV (Bancontact)) kunnen bijvoorbeeld worden gegroepeerd in dezelfde Bancontact-betaalmethode. De verschillende aanvullende ID's die moeten worden gegroepeerd in een betaalmethode moeten in dit memoveld worden gescheiden door een komma. Een identifier moet altijd aanwezig zijn in het numerieke veld Identificatie voor de betaalterminal. |
|
|
Begin van de pagina
Betalingscode
De betalingswijzen met kaart hebben een volgordenummer groter dan 1, en u moet verplicht volgende identificatienummers opgeven.
We raden u aan om minimaal de betalingsmethoden die blauw gemarkeerd zijn in deze tabel te configureren
ID | Brand |
---|
0001 | TOTAL Be National | 0002 | TOTAL Eutotrafic | 0003 | TOTAL ETAS24 | 0004 | DKV Selection | 0005 | UTA | 0006 | Esso Mark II | 0007 | euroShell | 0008 | Prepaid Shell GiftCard | 0009 | Shell Happy Days | 0010 | Service Card | 0011 | Eurotrafic (Benelux) | 0012 | Total Prepaid | 0013 | Tokheim card | 0014 | Total Lux trafic | 0015 | Total GR | 0016 | CCV IFSF | 1001 | Bancontact/MCA | 1002 | Visa Electron | 1003 | V Pay 1009 Maestro | 1010 | GIRO | 1011 | (NL) BANK | 1011 | (BE) CE-NAT | 1012 | (NL) EPWS | 1012 | (BE) CE-INT | 1013 | BC/MC EMV (Bancontact) | 1020 | Cartes Bancaires | 1030 | Payconiq | 1040 | GoodPay | 2002 | Visa | 2003 | MasterCard | 2004 | American Express | 2005 | Diners | 2007 | JCB | 2008 | UnionPay | 2009 | PAYFAIR/Monizze | 2012 | CMFC | 2013 | PRLI | 2014 | Basic Card | 3001 | Aurora | 3001 | Buy Way | 3002 | PASS | 3003 (BE) | Sodexo e-Pass | 3003(NL) | Yourgift H&G | 3004 | Edenred | 3013 | CCV Card | 3014 | Travelcard | 3015 | Intratuin | 3016 | Giftfor2 | 3020 | Company Cards | 3021 | AtosWorldline WL | 3100 | Equens WL | 3200 | Yourgift | 3300 | Giftcard | 3401 | RES | 4010 | Proton | 5601 | TOTAL CLUB |
|
Het betaalscherm in Logistics is nu een beetje anders:
Alle andere betaalmethoden dan Cash worden grijs weergegeven. Wanneer de klant betaalt met een kaart, start de gebruiker de transactie door op Bankkaart te drukken.
Logistics zal om een bevestiging van het bedrag van de transactie vragen indien de betaling per kaart gedeeltelijk is.
Begin van de pagina
Foutcodes
Code | Meaning | 0000 | Positive message | 0001 | Partial approval | 1802 | Unexpected message | 1803 | Timeout expiration | 1811 | Technical problem | 1822 | Connection failure | 1823 | Reserved | 2000 | Unknown acquirer identifier | 2100 | Unsupported balance action code | 2625 | Corrupted message | 2628 | External Equipment Cancellation | 2629 | User cancellation | 2630 | Device cancellation | 2631 | Host cancellation | 2632 | Host error | 2633 | Operation already performed | 2634 | Operation busy | 2635 | Operation not performed | 2800 | Doesn’t exist | 2802 | Not allowed | 2806 | Bad signature | 2807 | Conditional field missing | 2808 | Not found | 2809 | Dependency not found | 2810 | Bad value | 2811 | Bad sequence | 2812 | Device attachment | 2813 | Unexpected field | 3100 | Chip card expected | 3101 | Card not well read |
3102 | Condition of use not satisfied | 4000 | Purse technical problem | 4001 | Purse host identifier invalid | 4002 | Purse SDA certificate error | 4003 | Purse extended SDA certificate error | 4004 | Purse in red list | 4005 | Purse is locked for credit | 4006 | Purse is locked for debit | 4007 | Purse expired | 4008 | Purse state error | 4009 | Purse recovery error | 4010 | Purse key identifier error | 4011 | Purse balance too large | 4012 | Insufficient purse balance | 4100 | No purse in reader and time out expired | 4101 | Time-out on fallback card reading | 4102 | Problem linked to card | 4103 | Card information not available | 4200 | Entered amount invalid | 4201 | Double operation | 4202 | Invalid currency | 4203 | Amount higher than authorized amount | 4204 | Floor limit exceeded in EMV mode | 4205 | Transaction refused by the terminal in EMV mode | 4206 | Transaction refused by the card in EMV mode | 4207 | Product not available | 4208 | Cashback not supported by terminal | 4209 | Cashback not allowed for the selected brand | 4210 | Maximum cashback amount exceeded | 4211 | Cashback service declined by card (NFC) | 4300 | Service (already) activated | 4301 | Service (already) deactivated | 4302 | Maximal transaction number per (calendar) month reached | 4303 | Maximal uncollected journals number reached | 4304 | Service activation not supported | 4305 | Maximum transaction records reached | 4306 | Maximum service activation number reached | 4400 | Product delivery failed | 4401 | Partial product delivery | 6003 | Paper jam |
6004 | Remove previous ticket | 6005 | No paper | 6006 | Low paper | 6008 | Printer specific | 2000 | Unknown acquirer identifier | 2100 | Action code not supported | 7806 | Product not allowed | 7808 | Bad pump number | 7816 | Incorrect pump session number | 7817 | Transaction amount null | 7818 | Transaction amount null and quantity null | 7819 | Pump unhooked time-out expiration | 8000… 8999 | Reserved for added applications | 9002 | No key fault | 9003 | Cryptographic fault | 9004 | No PIN fault | 9005 | Bad MAC | 9006 | Bad MDC | Others | Reserved |
|
Service update
Als de service wordt bijgewerkt, is het aangeraden deze handmatig te sluiten voordat u de installatie start.
Mogelijke problemen
Begin van de pagina