IPC Installation Steps
To start, use the command line to set the correct path for Java and bin in the environment. These paths are set each time the application starts:
JAVA_HOME=<path to java>
Set the system path - Add the Java home bin path to:
Computer > properties > advanced > Environment Variables > User Variables > Path
The next task is to extract the application distribution zip file from the installation folder:
ipc-app.zipfile from the installation folder.
The folder structure should appear as the screen shot below:
From the folder:
Locate and run
A message appears that confirms the IPC application has started to initialise.
Click the configuration portal link, supplied with the zip file, or in the zip file.
IPC checks for a stored key (IPS key) in the IPC folder. As you are installing IPC for the first time, IPC will not find the stored key. Instead a pop-up appears:
Click the Configuration portal link, supplied with the zip file, or included in the zip file. The link takes you to the IPS Control Center.
Follow the procedures in the
IPS Control Centersection of this guide and enter your credentials.
When you have used the [IPS Control Center] to generate the Application ID, Application Reference and Activation Code, enter them into the fields in the Payment Application (IPC) Registration popup.
When you click Register the application generates the IPS Key and stores the key in the IPC App folder. You are automatically redirected to the Configuration portal homepage. See
When IPC and the payment terminal are configured, you can begin using the payment service API to make payments.
Configuration service API:
Payment service API:
When the installation is complete
When the installation is complete, IPC is normally left running day and night. If for some reason you need to start or stop IPC, do the following:
To start the IPC application:
Go to the
ipc-appfolder where you have installed/extracted the
Double click the
start.batfile (Windows) or
Note: Because the Payment Application (IPC) Registration process is a one-time procedure, you do not have to use the IPS Control Center to generate codes again.
To stop the IPC application:
- Double click the
stop.bat(Windows) file or
stop.sh(Linux) in the