Blog Home

Deploy the neaPay HSM simulator in a test environment

Posted on 16th Dec 2019 1268 views


deploy neapay HSM simulator


When you receive a delivery from neaPay for an HSM 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. 
In brief: 1:use/deploy java 7; 2:unpack delivered simulator; 3:start server; 4: start client; 5:run transaction 

Download package for Windows, with java:

Download package for any system:

Deploy to Windows

Download package with java, ready to run

Download package with java, for windows

Unpack the archive to a folder of your choice. You will have a structure like this:

E.g. C:/neaPayHSMSimulator/jre1.8

E.g. C:/neaPayHSMSimulator/sim_HSM_commander

E.g. C:/neaPayHSMSimulator/sim_HSM_HOST

you are ready to run

Download only package and install java

Download the package for any system.

Windows 10: Open the search box (press Win⊞ + S, type About Java, and hit Enter. If nothing comes up, please install the latest Java version.

Alternatively, open a command prompt window (press Win⊞ + R, type cmd, and hit Enter) and enter the command: java -version. This will output the version of Java installed on your computer. If the command is not recognized, please install the latest Java version.

Deploy to Mac

Download package

Download the package for any system.

Unpack to a location of your choice

please install the latest Java version.

Deploy to Linux

Download the package for any system.

Unpack to a location of your choice

please install the latest Java version.


Run the simulator

3. Start Issuer

Go into folder ISS_auth and run start_neaPay_Win.bat. For MAC and Linux use and .

Press the Start button at the top left and it will show a message that it is waiting for a connection. That means it has started . 

4 Start Acquirer

Go into folder ACQ_client and run start_neaPay_Win.bat. For MAC and Linux use and .

Press the Start button at the top left and it will show messages of files being loaded, and a message that it had connected the Issuer on port 8181.

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

7. Check result

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

neapay Demo Java 8 on MAC


Deployment instructions for Docker - no GUI, just server

1. Install Docker.

Use this URL,

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:/neaPayHSMSimulator/sim_HSM_HOST

3. Build and start Server

Go into folder ISS_auth and run

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 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 our website:

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 to 

4. Unpack “” 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 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!


Top Read Articles

Read smart card chip data with APDU commands ISO 7816 13284 views

Deploy, run and generate with neaPay Card Data Generator 7758 views

Run the neaPay ISO8583 simulator 6814 views

ISO8583 payments message format, programmers guide 6377 views

ISO8583 Message Converter JSON and XML interface specification mapping 4766 views

ISO8583 message: The list of ISO 4217 currency codes for data elements 49 and 52 4259 views

Deploy the neaPay ISO8583 simulator - video guide 4155 views

MCC Codes - Merchant Category Codes to use in ISO8583 Field 18 3350 views

Create a new test case in the neaPay ISO8583 simulator Video guide 3191 views

Asking for defects support for the neaPay products: converter, switch, issuer, simulator 2557 views

Log Files in BASE24 classic 2450 views

Performance testing at 500, 1000 and 1500 TPS 2422 views

Connect the neaPay ISO8583 Acquirer simulator to your own host or Issuer 2292 views

BIN List & Range for MasterCard, Visa, Amex, Diners, Discover, JCB, CUP 2245 views

Sample Recommended design for an Acquirer test cases suite, Scenarios and Regression 2135 views

BASE24 documentation to read 2102 views

BASE24 classic vs BASE24-eps 2086 views

Card readers supported by neaPay payments simulator, CHIP and NFC 2069 views

Regression Testing in 1 click with instant Analytics and CSV report 2054 views

BASE24 classic interview questions 1956 views

Load Test enabling and performance testing at 1TPS and 100TPS 1907 views

Run the neaPay ISO8583 converter to JSON, XML, SQL, in a test environment 1851 views

Adding your own card to the Payments simulator to test your system 1740 views

BASE24 classic screens examples explained 1740 views

Changing fields definitions in the ISO8583 simulator and message converter 1705 views

How the fingerprint reader works in the ISO8583 payments simulator 1693 views

Deploy the neaPay ISO8583 Payments converter in a test environment 1661 views

Enabling traces in the payments simulator 1622 views

Altering test cases in Excel for the ISO8583 simulator 1566 views

Run One, Run Scenario, Run All, Run Load in the neaPay ISO8583 Simulator - Use guide 1564 views

BASE24 classic ATM configuration Tutorial in ATD and XPNET with examples 1471 views

Cards and Banks Training 1361 views

EMV explained for programmers 1333 views

BASE24 classic cards configuration tutorial with Examples 1283 views

Deploy the neaPay HSM simulator in a test environment 1269 views

BASE24-eps interview questions 1267 views

Getting started with BASE24. Compiling your first TAL program 1136 views

BASE24-EPS ACI DESKTOP tutorial - Getting started 1113 views

BASE24 classic prefix configuration tutorial CPF with examples 1056 views

BASE24 classic tracing of transactions. Audits, configuration, enabling and opening 1034 views

BASE24 classic Institution configuration Tutorial with example 941 views

BASE24 classic balance file configuration PBF with example 866 views

ACI BASE24 classic automatic extract configuration 865 views

ISO8583 converter to JSON XML SQL to HTTP host - start& run - video guide - Part.1 859 views

ISO8583 converter to JSON XML SQL to HTTP host - message flow - video guide - Part.2 858 views

ISO8583 converter to JSON XML SQL to HTTP Host - host unavailable - video guide- Part.3 857 views

BASE24 classic interchange configuration with examples 849 views

Base24-eps how to create journals with esbldjnl 833 views

Deploy the Payments Switch Router in a test environment 725 views

Getting started with Base24 development. TAL tutorial 700 views

BASE24 classic routing in IDF 696 views

BASE24 classic External Message File configuration EMF with examples 655 views

Working with Base24-eps vs BASE24 Classic 637 views

BASE24 classic host configuration tutorial HCF with examples 576 views

What to expect when installing Base24-eps 569 views

Managing BASE24-eps implementation projects 566 views

First steps with BASE24 Classic 564 views

Getting started with using Prognosis for BASE24 and BASE24-eps 558 views

ISO8583 Response Codes for Transaction processing 214 views

Add extra custom fields to the ISO8583 simulator 168 views

ISO8583 Processing Codes for Transaction Processing 147 views

ISO8583 Message Types for Transaction Processing 134 views

Ask a question, get advice and help


Read related articles - Iso8583

Are you ready to start or need help?

Ready to start your next project with us? Give us a call or send us an email and we will get back to you as soon as possible!

Get a free quote, Ask for details, Get guidance

Contact us

Download and Use the software yourself

Download software

Follow a getting started guide to deploy and use the software

Get started