EasyZVT - EC Card Payment Terminal + CashGuard - Cash Terminal (and SdStore App)
Installation instructions
Introduction
In order to process card payments from the POS via a hardware terminal, additional software components are necessary, as the POS cannot directly access the user's hardware or network for security reasons.
The easyZVT software is used to control the many different payment devices/card terminals on the market, the easyZVT software is used, which must be purchased and licensed separately.
The connection between POS and easyZVT is again realized by our SdStore app.
Requirements
System
PC running Windows 8 or higher.
Payment device
The payment device should be connected and set up via LAN (network) via a service provider (payment provider, bank, etc.). In particular, the service provider has the followingSettingson the device:
Cash register | Zvt/zvt700 |
Cash register interface | Tcp/ip |
Subsequently, the IP address and the TCP port of the payer should be noted for the following steps. These can usually be retrieved via a menu on the device or a status expression.
Further information on installation and device-specific information can be found on the easyZVT manufacturer's website at http://www.easyzvt.de/?page_id=16 to find.
easyZVT license
easyZVT license code in version default. Prices and further price information are available at http://www.easyzvt.de/?page_id=26 to find.
To be purchased by order to easyzvt@groetzner.de stating the 8-digit "TID" (Terminal ID). This is often mounted on the device itself. You can also view it with the SdStore app. More about this below.
Installation easyZVT
Tested with the EasyZVT 3.0 ClickOnce (.NET 4.7.2) version with automatic update function.To install this version, open the page with the Microsoft Edge browser, click on the corresponding link and follow the instructions.
After installation, it is important to start and finish easyZVT once again.
A connection error or similar may be displayed as in the screenshot. This can be ignored at this time. It is only important that EasyZVT was started once before proceeding.
Installation of the SdStore app
The SdStore app is currently available as a ZIP file under the following links (an installer is in progress):
Windows: https://sd-storeapp.s3-eu-central-1.amazonaws.com/SdStoreApp-Setup.zip
MacOS: https://sd-storeapp.s3-eu-central-1.amazonaws.com/SdStore.app.zip
MacOS: https://sd-storeapp.s3-eu-central-1.amazonaws.com/SdStore.app.zip
It is loaded and e.g. unpacked on the desktop. At the first start, a security warning is displayed that the app comes from an unknown developer, that the file is dangerous, or the download website may be hacked. This must be confirmed/ignored/clicked (with the installer should do this).
The app starts with a double click on "sd_storeapp.exe" located in the unpacked folder.
If the start is not possible and an error message indicating missing libraries appears, these may have to be loaded and installed at https://sd-storeapp.s3.eu-central-1.amazonaws.com/VC_redist.x64.exe.
Configuration of the SdStore app
The SdStore app starts with the dashboard view. The tiles easyZVT, CashGuard and POS display the state of the system and should be green.
The easyZVT tile should already appear green after easyZVT has been installed. If this is not the case, check this first.
Via the button with the 3 strokes at the top left of the logo, you enter the configuration menu. First, the payment device is under "Payment-Terminals".
You can also access this area by clicking the "Manage terminals" button in the Dashboard's Cashier tile.
The "Create new terminal" button opens the form for creating a new payment terminal.
The following fields are important:
COM | Here should usually "LAN" be selected. |
IP address | IP address of the payment device. See above in section "Requirements". The IP address must be entered without leading zeros, e.g. "10.0.1.2" and not "010.000.001.002". |
Port | TCP port number of the payment device. See above in section "Requirements". |
Cash register number | Even if there is only one cash register, a number must be entered here. So e.g. the "1". |
In the text fields, it is necessary to complete the entry with the "Enter" keyboard key. Only then will the value be accepted.
Test Payment
After you have created the terminal, you should make a test payment to test the configuration. You can also cancel the process on the payment device itself so as not to make a real payment. It is only a question of whether the payment device works at all. Click on the green "Test" button and follow the instructions:
Next, a window opens to test the payment terminal. If everything works correctly, the payment device should prompt the user to insert a card.
If this does not occur, the error message/notification output in the EasyZVT window should be observed, if necessary, to narrow down the error.
Often it is due to the IP address or the configuration of the payment device itself.
If the test has worked, the URL/ID of the terminal for configuration should be copied in the next section. This can be done via the button "Copy"
License code and TID
If the test is successful, the terminal ID (TID) can be determined in the SdStore app. The TID is required to purchase an easyZVT license code, which must then also be entered in the SdStore app.
Via the "Menu" --> "EasyZVT" one gets into the easyZVT registry/administration.
After the test payment has been made, the "TID" can be found in the "Output" tab. It can be copied by a click.
The purchased license code must be placed in the tab "Input Parameters" under "License" to be entered/inserted:
Configuration in the admin
In the admin, make sure that a printer is created for the corresponding store ("Admin" --> "Hardware & System" --> "Printer").
Furthermore, a template for payment terminal receipts must be set for this printer:
It must be remembered in category "Store" at the category subpoint "Stores" with the light green "pen symbol" button "edit" right of a Storelist entry at the tab "Payment type" the payment method"EC Terminal" or "EC terminal (card payment)" to activate:
Now the terminal can be created under "Hardware & System" --> "Payment terminals".
In the field "Terminal ID" must insert the terminal ID/URL of the terminal copied from the SdStore app.
Now the payment type "card payment" should be available in the POS, e.g. in counter sales.
Card payments can only be made on the computer on which easyZVT and the SdStore app are installed and set up. The SdStore app must always be running in the background (but can be minimized to the taskbar) and the tiles in the dashboard must also appear permanently green.
While a card payment is being made through the browser, the EasyZVT window appears briefly to show progress. After that, it should disappear. If there are any errors, it will display a note to that effect. Otherwise, it can be ignored.
In the SdStore app, the individual transactions are listed in the dashboard.
Setup CashGuard
CashGuard is set up in the SdStore app. About the button "Configure" opens the CashGuard configuring form.
By clicking on "Configure", opens a window.
The access data will be added there:
- Server
- Port
- Username
- Password
And confirmed with "Apply".
The access data is available from the provider/technician who set up CashGuard on the local PC.
Subsequently, a new device is created via the button "Creating new device".
A window opens in which the cID itself can be chosen.
Then click on "Create device".
Afterwards, the terminal link can be copied to the clipboard using the "Copy" button.
Now CashGuard can be created in the Admin unter "Admin" --> "Hardware & System" --> "Payment terminal" --> "Add terminal".
The following fields are important:
Payment service | Select "easyZVT CashGuard". |
Description | A description is entered here. This is displayed to the user during selection. |
Terminal ID | The previously copied terminal ID is entered here. |
Payment types | Here, the switch at "Cash terminal (cash payment)" is set to "Yes". |
It is necessary to remember to activate the payment type "Cash terminal (cash payment)" in the category "Store" --> at the category subitem "Stores" --> at the light green "pencil icon" button "edit" on the right side at a store list entry --> at the tab "Payment types":
After that, the payment terminal "CashGuard" is available in the POS:
Related Articles
Payment terminals
Below is explained how to create and use interfaces to payment terminals in our system in general. Payplaza is taken as an example. For details regarding the easyZVT payment terminals and interfaces see: ...Driver app
The driver app can be downloaded from the Apple Appstore or Google Playstore at the following links: Apple: https://apps.apple.com/de/app/simplydrive/id1497860088 Android: https://play.google.com/store/apps/details?id=de.simplydelivery.gpsdriverapp ...SIDES Pay Terminal OnReader Tipping
Enable tip functionality with SIDES Pay For the SIDES Pay terminal, the functionality will be available when "Allow tips" is activated in "Global store settings". To do this, go to Admin -> under Store -> Global store settings -> Other settings -> ...Driver terminal
We recommend that you use a incognito tab if you open the driver terminal on the same computer as the cash register, otherwise this may cause problems. The driver terminal fulfills two functions. Firstly, it serves as a tool for your staff to record ...Driver terminal
What With the driver terminal, drivers can register, and delivery orders can be assigned to the driver. Where POS: Order overview > Driver terminal. We recommend using an incognito tab if the driver terminal is opened on the same computer as the POS, ...