Blog Home

Deploy the neaPay ISO8583 simulator - video guide

Posted on 5th Jun 2013 4974 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 22985 views

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

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

Run the neaPay ISO8583 simulator 9543 views

ISO8583 payments message format, programmers guide 9019 views

ISO8583 Message Converter JSON and XML interface specification mapping 6573 views

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

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

ISO8583 Response Codes for Transaction processing 5770 views

Deploy the neaPay ISO8583 simulator - video guide 4975 views

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

ISO8583 Message Types for Transaction Processing 4244 views

ISO8583 Processing Codes for Transaction Processing 3953 views

Log Files in BASE24 classic 3831 views

Performance testing at 500, 1000 and 1500 TPS 3421 views

BASE24 classic interview questions 3409 views

BASE24 documentation to read 3373 views

BASE24 classic vs BASE24-eps 3334 views

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

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

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

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

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

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

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

BASE24 classic screens examples explained 2605 views

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

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

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

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

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

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

Enabling traces in the payments simulator 2306 views

Altering test cases in Excel for the ISO8583 simulator 2305 views

EMV explained for programmers 2305 views

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

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

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

BASE24-eps interview questions 2255 views

Deploy the neaPay HSM simulator in a test environment 2179 views

Cards and Banks Training 2084 views

BASE24 classic cards configuration tutorial with Examples 1995 views

Deploy the Payments Switch Router in a test environment 1845 views

BASE24-EPS ACI DESKTOP tutorial - Getting started 1727 views

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

BASE24 classic prefix configuration tutorial CPF with examples 1673 views

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

BASE24 classic Institution configuration Tutorial with example 1461 views

BASE24 classic interchange configuration with examples 1429 views

BASE24 classic balance file configuration PBF with example 1413 views

ACI BASE24 classic automatic extract configuration 1387 views

Working with Base24-eps vs BASE24 Classic 1298 views

Add extra custom fields to the ISO8583 simulator 1240 views

Base24-eps how to create journals with esbldjnl 1213 views

BASE24 classic routing in IDF 1139 views

Getting started with Base24 development. TAL tutorial 1132 views

BASE24 classic External Message File configuration EMF with examples 1067 views

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

First steps with BASE24 Classic 965 views

ISO8583 ATM POS Crypto API integration with exchanges like Coinbase or Binance 953 views

What to expect when installing Base24-eps 935 views

BASE24 classic host configuration tutorial HCF with examples 919 views

Managing BASE24-eps implementation projects 866 views

Ask a question, get advice and help


Read related articles - Iso8583

EMV explained for programmers

EMV explained for programmers

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