You can choose to offer customers Givex gift cards.
There are a few steps you must follow in order for Givex gift cards to work in Erply. You also must have a valid contract directly with Givex.
The Givex Integration consists of several parts:
Givex microservice
Givex plugin
Erply Givex module
Erply config parameters for additional settings
Givex installation
Important notes:
Right now, Givex only works on Berlin POS.
The integration only works on the Retail view of the POS
Gift cards that will function as Givex gift cards must be listed as a Regular gift card in the back office.
Givex microservice
The Givex microservice must be installed and running on all devices.
You can download the Givex microservices at the following links:
https://erply-givex.s3.eu-central-1.amazonaws.com/64bit/Erply_GIVEX_64_Install.exe https://erply-givex.s3.eu-central-1.amazonaws.com/32bit/Erply_GIVEX_32_Install.exe
After the .exe file is downloaded start the installation process. The installation process has to be conducted under a user with Administrator rights.
The installer will open. Fill in the IP addresses supplied by Givex
Fill in the Givex application port number.
Make sure the Givex microservice is running before you complete the following steps. You can check if it’s running by opening your device’s Task Manager or Activity Monitor and searching for the name. If it’s not running, reopen the file.
Givex plugin
Right now, the Givex plugin only works on Berlin POS.
You’ll need a specific Givex plugin depending on your xxxx setup.
Contact support@erply.com to
POS configuration | Plugin needed |
EPSI | Givex-direct-plugin |
FIS Global payment terminals (formally WorldPay, Vantiv) | Follow steps below |
Heartland-PAX payment terminals | Follow steps below |
Manual plugin setup
At the POS, click on the Setting button and select Payments configuration
Click Givex settings.
In the Givex Microservice section, enter the following link wss://localhost.erply.com:5658
If nothing is added here, the plugin will use the default link.
Save when you are done.
Givex Module
Contact support@erply.com and request the Givex module to be enabled on your account.
Erply config parameters for additional settings
There are a few additional parameters that we can add to your Erply account to further customize Givex functionality.
Please contact support@erply.com if you’d like any of these enabled.
Parameter Name | Function |
givex_admin_id: “XX” | Adds the “Adjust GIVEX balance” button to the POS that allows all users in the group “XX” to adjust a balance on a Givex card.
This button will only show up in the Retail view at the POS
Please inform customer support what user group you would like to use so that they could replace the “XX” with the correct user group ID. |
givex_enable_transfer: "1" | This parameter enables the user to use the Givex transfer button. |
givex_use_pin: "1" | This parameter enables the user to require a pin on a Givex card. |
Givex installation
Once all of the following steps have been completed, download the following file:
https://drive.google.com/file/d/1FIxiTE1RdQmrNCH8r8Y2HJ48S_X6eSJB/view?usp=sharing
Unzip the folder and overwrite the files in C:\Program Files\ERPLY Givex