Posted on 25th Jan 2019 1670 views
Once you have received and successfully deployed your ISO8583 converter from neaPay, deploy and run is easy
1:use/deploy java 8;
2:unpack delivered converter;
3:start converter;
4:start client and server simulators;
5:run transaction
Running transaction with the neaPay ISO8583 converter is as easy as running the simulator.
In test mode, you can enable the User Interface and you can do everything by mouse click.
If you manged to come this far, you are ready to continue to configure your converter to match your own specification or to do a test run for production, in Docker.
For running in production we reccomend running the converter in headless mode inside a container.
Headless mode is achieved by disabling the UI in config.properties. If you add this line, you will disable the UI.
gui.disabled=true
By default the converter comes with a Dockerfile and also with a configuration parameter to switch off the UI.
Automatically all output goes to standard out, where it is captured by the container.
Cloud providers usually have solutions for these los, storage or export to data lake analytics.
Platform | x86_64 |
---|---|
Docker Desktop for Mac (macOS) | |
Docker Desktop for Windows (Microsoft Windows 10) |
sudo yum install unzip
unzip -v
Platform | x86_64 / amd64 | ARM | ARM64 / AARCH64 | IBM Power (ppc64le) | IBM Z (s390x) |
---|---|---|---|---|---|
CentOS | |||||
Debian | |||||
Fedora | |||||
Ubuntu |
While on the VM, execute first OR second command, edit to match your delivery link:
wget -O /tmp/neapay_delivery.zip 'https://link_neapay_delivery.zip.zip'
curl -o /tmp/neapay_delivery.zip 'https://link_neapay_delivery.zip.zip'
Assume the delivery is a zip file called neapay_delivery.zip. You need to unpack this
mkdir ~/neapay/
unzip /tmp/neapay_delivery.zip -d ~/neapay/
Assume the converter was delivered in a folder called "neapayconverter". All you need to do is execute the script that starts it with Docker.
cd ~/neapay/neapayconverter
./start_neaPay_Docker.sh
If you have several converters, you either have a composer file or you need to start manually each of the converters
cd ~/neapay/neapayconverter2
./start_neaPay_Docker.sh
The same package can be deployed to the test environment. So it is likely that teh delivery also contains other folders, for example simulators for triggering transactions or web servers in case the converter converts to a web host format.
They get unpacked anyway. Do not start them, they are not needed. If you do though, nothing bad will happen
In case of a redeploy, the procedure can be repeated from start
In case of a configuration change, the script "start_neaPay_Docker.sh" can be run again.
The script will automatically find the running container, kill it, remove it, then find the image, remove it, rebuild a new container, and start it. No need to take care of anything about that. 
Run the following command to see the logs of the converter that is called "neapayconverter"
docker logs neapayconverter
If you do not know how your running container is called, run the following command to see running containers
docker ps
The converter by default runs in several ways and logging options are available for all.
1. Standalone on windows. Ideal for test situations.
The logs are displayed in standard to the UI console, if activated, or to standard out, if UI is disabled.
Enhanced logs below can be generated.
2. Standalone on Mac or Linux. This can apply to Test or Production situations
The logs are displayed in standard to the UI console, if activated, or to standard out, if UI is disabled.
Enhanced logs below can be generated.
UI mode is not suitable for production situations.
3. Container on any platform
All output to system.out
Enhanced logs below can be generated.
Options to generate HTML or CSV reports are available, as well as sending transactions live (real-time) to another ISO8583 host (warehouse), SQL database or a HTTP host.
Read smart card chip data with APDU commands ISO 7816 11931 views
Deploy, run and generate with neaPay Card Data Generator 7374 views
Run the neaPay ISO8583 simulator 6223 views
ISO8583 payments message format, programmers guide 5875 views
ISO8583 Message Converter JSON and XML interface specification mapping 4389 views
Deploy the neaPay ISO8583 simulator - video guide 3880 views
ISO8583 message: The list of ISO 4217 currency codes for data elements 49 and 52 3858 views
MCC Codes - Merchant Category Codes to use in ISO8583 Field 18 2907 views
Create a new test case in the neaPay ISO8583 simulator Video guide 2903 views
Asking for defects support for the neaPay products: converter, switch, issuer, simulator 2418 views
Log Files in BASE24 classic 2193 views
Performance testing at 500, 1000 and 1500 TPS 2186 views
Connect the neaPay ISO8583 Acquirer simulator to your own host or Issuer 2036 views
Sample Recommended design for an Acquirer test cases suite, Scenarios and Regression 1957 views
Card readers supported by neaPay payments simulator, CHIP and NFC 1915 views
Regression Testing in 1 click with instant Analytics and CSV report 1816 views
BASE24 documentation to read 1813 views
BASE24 classic vs BASE24-eps 1768 views
Load Test enabling and performance testing at 1TPS and 100TPS 1745 views
BASE24 classic interview questions 1695 views
Run the neaPay ISO8583 converter to JSON, XML, SQL, in a test environment 1671 views
BIN List & Range for MasterCard, Visa, Amex, Diners, Discover, JCB, CUP 1601 views
BASE24 classic screens examples explained 1552 views
Adding your own card to the Payments simulator to test your system 1500 views
How the fingerprint reader works in the ISO8583 payments simulator 1466 views
Changing fields definitions in the ISO8583 simulator and message converter 1461 views
Enabling traces in the payments simulator 1452 views
Deploy the neaPay ISO8583 Payments converter in a test environment 1366 views
Altering test cases in Excel for the ISO8583 simulator 1255 views
Run One, Run Scenario, Run All, Run Load in the neaPay ISO8583 Simulator - Use guide 1255 views
BASE24 classic ATM configuration Tutorial in ATD and XPNET with examples 1209 views
Cards and Banks Training 1161 views
BASE24 classic cards configuration tutorial with Examples 1149 views
EMV explained for programmers 1099 views
BASE24-eps interview questions 1084 views
Deploy the neaPay HSM simulator in a test environment 1002 views
Getting started with BASE24. Compiling your first TAL program 932 views
BASE24-EPS ACI DESKTOP tutorial - Getting started 909 views
BASE24 classic prefix configuration tutorial CPF with examples 852 views
BASE24 classic tracing of transactions. Audits, configuration, enabling and opening 837 views
BASE24 classic Institution configuration Tutorial with example 801 views
ACI BASE24 classic automatic extract configuration 685 views
BASE24 classic interchange configuration with examples 683 views
BASE24 classic balance file configuration PBF with example 675 views
Base24-eps how to create journals with esbldjnl 666 views
Deploy the Payments Switch Router in a test environment 601 views
Getting started with Base24 development. TAL tutorial 579 views
BASE24 classic routing in IDF 535 views
Working with Base24-eps vs BASE24 Classic 495 views
BASE24 classic External Message File configuration EMF with examples 484 views
Managing BASE24-eps implementation projects 476 views
ISO8583 converter to JSON XML SQL to HTTP host - start& run - video guide - Part.1 472 views
ISO8583 converter to JSON XML SQL to HTTP Host - host unavailable - video guide- Part.3 470 views
ISO8583 converter to JSON XML SQL to HTTP host - message flow - video guide - Part.2 468 views
First steps with BASE24 Classic 467 views
What to expect when installing Base24-eps 463 views
Getting started with using Prognosis for BASE24 and BASE24-eps 455 views
BASE24 classic host configuration tutorial HCF with examples 418 views
Ask a question, get advice and 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!