Blog Home

Deploy the neaPay ISO8583 simulator - video guide

Posted on 5th Jun 2013 4343 views


deploy neapay simulator


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. 
In brief: 1:use/deploy java 7; 2:unpack delivered simulator; 3:start server; 4: start client; 5:run transaction 


Download here:


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:/neaPaySimulator/jre1.8 

E.g. C:/neaPaySimulator/ACQ_client

E.g. C:/neaPaySimulator/ISS_auth

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

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

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

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.

4. 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:/neaPaySimulator/ISS_auth

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

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 15791 views

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

Run the neaPay ISO8583 simulator 7233 views

ISO8583 payments message format, programmers guide 6892 views

ISO8583 Message Converter JSON and XML interface specification mapping 5077 views

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

Deploy the neaPay ISO8583 simulator - video guide 4344 views

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

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

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

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

Log Files in BASE24 classic 2630 views

Performance testing at 500, 1000 and 1500 TPS 2601 views

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

BASE24 documentation to read 2310 views

BASE24 classic vs BASE24-eps 2286 views

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

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

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

BASE24 classic interview questions 2164 views

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

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

BASE24 classic screens examples explained 1892 views

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

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

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

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

Enabling traces in the payments simulator 1733 views

Altering test cases in Excel for the ISO8583 simulator 1713 views

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

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

EMV explained for programmers 1504 views

Cards and Banks Training 1492 views

Deploy the neaPay HSM simulator in a test environment 1428 views

BASE24-eps interview questions 1392 views

BASE24 classic cards configuration tutorial with Examples 1377 views

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

BASE24-EPS ACI DESKTOP tutorial - Getting started 1219 views

BASE24 classic prefix configuration tutorial CPF with examples 1195 views

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

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

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

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

BASE24 classic Institution configuration Tutorial with example 1031 views

ACI BASE24 classic automatic extract configuration 996 views

BASE24 classic balance file configuration PBF with example 981 views

BASE24 classic interchange configuration with examples 974 views

Base24-eps how to create journals with esbldjnl 944 views

Deploy the Payments Switch Router in a test environment 916 views

BASE24 classic routing in IDF 787 views

Getting started with Base24 development. TAL tutorial 776 views

BASE24 classic External Message File configuration EMF with examples 752 views

Working with Base24-eps vs BASE24 Classic 734 views

ISO8583 Response Codes for Transaction processing 688 views

What to expect when installing Base24-eps 673 views

BASE24 classic host configuration tutorial HCF with examples 670 views

First steps with BASE24 Classic 634 views

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

Managing BASE24-eps implementation projects 628 views

ISO8583 Processing Codes for Transaction Processing 560 views

ISO8583 Message Types for Transaction Processing 415 views

Add extra custom fields to the ISO8583 simulator 370 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