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

(tick) Gebruikt protocol: CTEP

(tick) Betaalterminal van Banksys gekoppeld via een LAN ethernet kabel

(tick) Winbooks Worldline Service (WWService) geïnstalleerd op een PC (met een vast IP adres) in dezelfde LAN als die van de Banksys terminals.

(tick) Laatste versie van Logistics 6.2

(tick) Framework .NET versie 4.6.2

(tick) 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

Veiligheid

In het geval van externe toegang via WAN, raden wij u aan om het gedeelte "communicatie beveiligen" aandachtig te lezen.

Verbinding via WAN

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.

Vast IP

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.


Extra controlemogelijkheden na installatie indien problemen


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

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"

Firewall

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.

Bindingsbestanden

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

Windows gebruikersidentificatie

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


Inhoud van WWService.exe.config beveiligd door Windows-gebruiker 
<?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>
Inhoud van Logistics.config.exe en WWView.exe.config beveiligd door Windows-gebruiker 
<?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.

Hervatten na mislukking

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.

Versie lager dan 6.2.6

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.


Co-existentie tussen seriële en TCP/IP terminals

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.


Client logbestand

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.


OptiesOmschrijving
Gemeenschappelijke configuratie voor werkstationsAls 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

ServiceadresIP 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.


Onbekende betaal-ID

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.

Geconsolideerde betalings-ID's

Gebruik van TCP/IP en seriële poort terminals

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

IDBrand
0001TOTAL Be National
0002TOTAL Eutotrafic
0003TOTAL ETAS24
0004DKV Selection
0005

UTA

0006

Esso Mark II

0007

euroShell

0008Prepaid Shell GiftCard
0009Shell Happy Days
0010

Service Card

0011

Eurotrafic (Benelux)

0012Total Prepaid
0013Tokheim card
0014Total Lux trafic
0015Total GR
0016

CCV IFSF

1001Bancontact/MCA
1002Visa Electron
1003

V Pay 1009 Maestro

1010

GIRO
1011(NL) BANK
1011(BE) CE-NAT
1012(NL) EPWS
1012(BE) CE-INT
1013BC/MC EMV (Bancontact)
1020Cartes Bancaires
1030Payconiq
1040GoodPay
2002Visa
2003MasterCard
2004American Express
2005Diners
2007JCB
2008UnionPay
2009

PAYFAIR/Monizze

2012CMFC
2013PRLI
2014Basic Card
3001Aurora
3001Buy Way
3002PASS
3003 (BE)Sodexo e-Pass
3003(NL)Yourgift H&G
3004Edenred
3013CCV Card
3014Travelcard
3015Intratuin
3016Giftfor2
3020Company Cards
3021AtosWorldline WL
3100Equens WL
3200Yourgift
3300Giftcard
3401RES
4010Proton
5601TOTAL 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

  • Als de setup weigert zich te installeren en aangeeft dat er al een versie is geïnstalleerd, is het raadzaam om de service te verwijderen via het programmamenu "toevoegen en verwijderen van Windows programma's"

  • Als de setup weigert zich te installeren en aangeeft dat "de service al bestaat", kunt u deze handmatig verwijderen via de Windows-opdrachtprompt (als beheerder) via de opdracht:

    sc delete WWService

     


Begin van de pagina