When you receive a delivery from neaPay for an iso8583 simulator, you will get 1 zip file.
This step by step guide will guide you through the deployment process, which is as simple as using the software.
STEP 1: use/deploy java 1.8
STEP2: 2:unpack delivered simulator; 3:start server; 4: start client; 5:run transaction
INSTALL JAVA
Reccomended version 1.8 JRE or JDK
ORACLE JAVA SE
https://www.oracle.com/es/java/technologies/javase/javase8-archive-downloads.html
JRE 1.8 - windows 2026+
https://javadl.oracle.com/webapps/download/AutoDL?BundleId=252907_0d06828d282343ea81775b28020a7cd3
JRE 1.8 - linux 2026+
https://javadl.oracle.com/webapps/download/AutoDL?BundleId=252897_0d06828d282343ea81775b28020a7cd3
https://www.oracle.com/java/technologies/downloads/#java8
OPENJDK compatibility
YES - up to openjdk 14
- OPENJDK 17, 19 and 21 DOES NOT WORK, packages were removed
INSTALL JAVA globally on the machine, or local
The simulator is the same for Windows, Mac or Linux
Deploy to Windows
Download simulator - DOWNLOAD
Check java version
Windows 10: Open the search box (press Win⊞ + S, type About Java, and hit Enter. If nothing comes up, please install Java.
Alternatively, open a command prompt window (press Win⊞ + R, type cmd, and hit Enter) and enter the command:
java -version.
C:Usersnp>java -version
java version "1.8.0_202"
Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)
This will output the version of Java installed on your computer. If the command is not recognized, please install Java.
Deploy to Mac
Download simulator - DOWNLOAD
Download the package for any system.
Unpack to a location of your choice
Deploy to Linux
Download simulator - DOWNLOAD
Unpack to a location of your choice
UNZIP / unpack the downloaded archive
No installer is required - just unpack - you can deploy via a deploy script!
Unzip the archive to a folder of your choice. You will have a structure like this:
E.g. C:/neaPaySimulator/simulator_ISO8583_Acq_client_PRO
E.g. C:/neaPaySimulator/simulator_ISO8583_Iss_host_auth_PRO
If you choose to not isntall java, but run it from a separat folder, you can deploy java to a folder next to the simulator
E.g. C:/neaPaySimulator/jre1.8
You are ready to run
Checkist:
1. java installed - check with java -version
2. simulator unzipped - folder structure as above
Run the simulator
1. Start Issuer - Server - Host
Go to folder
cd simulator_ISO8583_Iss_host_auth_PRO/
and run - on Windows
./start_neaPay_Win.bat
For MAC and Linux use
./start_neaPay_linuxMac.sh
Press the Start button at the top left or in the Console View
If start is successful, you will receive a message:
Issuer starting, TCP Server starting
Server connection started on port 9009
Server Connections started:TCPServer
Success! The server has started!
Also, the transactions list will automatically display
2 Start Acquirer - Client
Go to folder
cd simulator_ISO8583_Acq_client_PRO/
and run - on Windows
./start_neaPay_Win.bat
For MAC and Linux use
./start_neaPay_linuxMac.sh
Press the Start button at the top left or in the Console View
If start is successful, you will receive a message:
Attempting to start a new TCP/IP Client connection on localhost:9009
3. Verify connection
Server -
Once The client requests, the server will allow the connection
Server TCP/IP socket accepted on address /127.0.0.1:9009[4785]
Server listener started on port:9009 Thread-18
Success - The server is now listening for transactions from the client
Client -
Once started, the client will request to connect to the server
Client TCP/IP socket created on address localhost/127.0.0.1:9009[4785]
Client listener running on port:9009 Thread-15
Success - The clien tis now listening for trasnactions from the server
3. Run a test case
A new window will open automatically, the "Transactions List", which contains the test cases.
Select a test case (first one) and click "Send". You should see in the console, a request and response message to the Issuer.
Net: Message sent by Simulator Acquirer
:
- - - - - - - - - - - - - - - - - - - - - - - - - -
Sim: MessageType: 0800
Sim: Bitmap: A2380000008000000400000000000000 [1,3,7,11,12,13,41,70]
Sim: F03_ProcessingCode: 000000
Sim: F07_TransmissionDateTime: 0128171135
Sim: F11_SystemTraceAuditNumber: 000314
Sim: F12_DateTimeLocalTransaction: 260128
Sim: F13_DateLocalTxn: 0128
Sim:F41_CardAcceptorTerminalIdenti: 20390059
Sim: F70_AuthInstCntryCode: 000
- - - - - - - - - - - - - - - - - - - - - - - - - -
Client connected:true keepAlive, checking again in 60 seconds 89
4. Check result
- - - - - - - - - - - - - - - - - - - - - - - - - -
Sim: MessageType: 0810
Sim: Bitmap: 0230000002000000 [7,11,12,39]
Sim: F07_TransmissionDateTime: 0128171135
Sim: F11_SystemTraceAuditNumber: 000314
Sim: F12_DateTimeLocalTransaction: 260128
Sim: F39_ActionCode: 00
- - - - - - - - - - - - - - - - - - -
- - - - - - - - - TEST PASS - - - - - - - - - - - - -
RC Received:00 RC Expected:00
Tests Executed:1
Tests Passed :1
Tests Failed :0
Response time is 1s
You should see TEST PASS in the test results, in the console. In this case, congratulations, your simulator is working!
If any of the steps above is unclear or did not work, write us back for help!
Your Structure on disk should look like this (for local java).
Deployment instructions for Docker - no GUI, just server
1. Install Docker.
Use this URL, https://docs.docker.com/install/
choose your operating system and install;
2. Unpack
Unpack “neaPay_demo_delivery_******.zip” to the same folder where folder jre1.8 was created.
E.g. C:/neaPaySimulator/ISS_auth
3. Build and start Server
Go into folder ISS_auth and run
start_neaPay_Docker.sh
the start script will automatically stop existing container, build a new container from existing delivery, and run the new container.
4. check logs
docker logs neapayserver
Deployment instructions for JAVA 7
1. Deploy java 1.7 runtime environment to your system and use it as default. Java SE 7 Archive Downloads.
Alternatively, if you cannot do that, download jre1.7 from our website as a zip . In this case, unpack jre1.7.zip to the folder where the simulator will be deployed. E.g. C:/neaPaySimulator/jre1.7
For Mac use this link to download the jre1.7 from https://neapay.com/download.html
2. Stop previous instances of the ISO8583 simulator.
3. If the received archive has an extension of *.zip.neaPay, rename the file and remove the .neaPay extension, so the extension will be .zip. (E.g. rename neaPay_demo_delivery.zip.neaPay to neaPay_demo_delivery.zip)
4. Unpack “neaPay_demo_delivery.zip” to the same folder where folder jre1.7 was created.
5. Go into folder ISS_auth and run start_neaPay.bat. For MAC and Linux use start_neaPay.sh. Press the Start button at the top and it will show a message that it is waiting for a connection. That means it has started .
6. Go into folder ACQ_client and run start_neaPay.bat. Press the Start button at the top and it will show messages of files being loaded, and then a transaction window name "Transactions List".
7. Congratulations, your simulator is working! Write in the contact form below if it is not and you need help!
Thank you for following this article! Please leave us a note below if something is wrong or unclear, we will review and change it asap!
