mFino Simulation Tool

mFino Simulation Tool is a packaged ISO8583 transaction simulator. Download the release archive for your operating system, start the executable, and use the local browser UI to send test transactions.

Use this tool in approved test or simulation environments.

Download

Download the matching archive from the GitHub Release page.

Platform	Release asset
macOS Apple Silicon	MFinoGUI-<version>-macos-arm64.tar.gz
macOS Intel	MFinoGUI-<version>-macos-x86_64.tar.gz
Linux ARM64	MFinoGUI-<version>-linux-arm64.tar.gz
Linux Intel/AMD x64	MFinoGUI-<version>-linux-x86_64.tar.gz
Windows ARM64	MFinoGUI-<version>-windows-arm64.zip
Windows Intel/AMD x64	MFinoGUI-<version>-windows-x86_64.zip

Install and run

macOS

1. Download the macOS archive for your CPU architecture.
2. Extract the archive.
3. Open MFinoGUI.app.
4. Allow the app in System Settings > Privacy & Security when macOS Gatekeeper asks for confirmation.

Linux

1. Download the Linux archive for your CPU architecture.
2. Extract the archive.
3. Make the executable runnable:

   chmod +x MFinoGUI

4. Start the app:

   ./MFinoGUI

Windows

1. Download the Windows archive for your CPU architecture.
2. Extract the archive.
3. Run MFinoGUI.exe.
4. Follow your organization policy when Windows SmartScreen asks for confirmation.

Open the UI

After the executable starts, the app opens this local address in your default browser:

http://127.0.0.1:5001

Open the address manually when the browser stays closed.

Configure the server

The default server connection is:

• IP Address: 10.16.180.45
• Port: 8008

Use Endpoint in the Guided Builder to confirm or change the IP address and port before sending a request.

Send a transaction with Guided Builder

1. Open the local UI and use Endpoint to confirm the target IP address and port.
2. Use Operation to choose the transaction type. The processing code appears with the operation name.
3. Use Fields to complete every required value. Field hints and validation messages come from the simulator metadata.
4. Use Review to confirm endpoint, operation, and input values.
5. Click Send ISO8583 Request.
6. Review Latest Response for response code, description, STAN, RRN, and reversal SN when available.
7. Use Live Trace for TX/RX payloads and system messages.
8. Use ISO8583 Message Breakdown to inspect parsed fields and copy individual values.
9. Use Transaction History to load previous parameters, copy an SN, or prepare a Rollback.

Transaction types

#	Transaction	Code	Required fields
1	Payment / Topup	180000	Mobile Number, Amount
2	Account Inquiry	380000	Mobile Number
3	Postpaid Bill Payment	280000	Mobile Number, Amount
4	Share Load / P2P Transfer	400000	Source Mobile Number, Destination Mobile Number, Amount
5	Package Inquiry	390000	Mobile Number, Package ID, Area ID
6	Package Purchase	490000	Mobile Number, Amount, Package ID, Area ID
7	Package Inquiry Area	390000	Mobile Number, Package ID, City Code
8	Package Purchase Area	590000	Mobile Number, Amount, Package ID, City Code
9	Reserved Payment / Reversal	180000	Mobile Number, Amount, SN
10	Reserved Bill Payment / Reversal	280000	Mobile Number, Amount, SN
11	Reserved Transfer / Reversal	400000	Source Mobile Number, Destination Mobile Number, Amount, SN

Reversal SN

The app generates a reversal SN after eligible original transactions:

0200 + STAN (6 digits) + Transmission Time (10 digits) + Institution Code (11 digits)

Example:

0200123456010115032200000000000881

Troubleshooting

Browser stays closed

Open this address manually:

http://127.0.0.1:5001

Connection fails

Check the target IP address, target port, VPN, firewall, and access to the mFino server.

Response code is empty

Review Latest Response and Live Trace to confirm the server returned an ISO8583 response with the RRN or terminal identifier.

Port 5001 is already in use

Close the other app using port 5001, then start MFinoGUI again.

macOS blocks the app

Open System Settings > Privacy & Security, find MFinoGUI.app, and allow it according to your organization policy.

Windows SmartScreen appears

Confirm the release source and follow your organization policy.

Support

When reporting an issue, include the release version, operating system, target server, selected transaction type, Guided Builder step, Latest Response, and Live Trace output.