Skip to content

GHL Simulator v1.0

Choose a tag to compare

View all tags
@deadboy18 deadboy18 released this 29 Nov 11:48
· 4 commits to main since this release
v1.0.0
2323d26
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

GHL Terminal Simulator v1.0 (Initial Release)

Developer: Deadboy
Protocol: GHL/Verifone RS232 Integration v1.0.17

Overview

This tool simulates the behavior of a GHL Payment Terminal (PAX A920) via RS232. It allows POS developers to test integration logic (Sale, Void, Settlement, Refund) without needing a physical card transaction or live bank host.

Key Features

  • Full Transaction Simulation: Supports Sale (020), Void (022), Settlement (050), and Refund (026).
  • Protocol Compliance: Implements the correct STX/ETX framing and 8-byte XOR Check Digit calculation.
  • Smart Inputs: ATM-style currency entry and strict input validation.
  • Visual Feedback: Toast notifications, connection status indicators, and "Digital Receipt" popups upon approval.
  • Developer Tools: Live HEX communication logs with Timestamping, Copy, and Save to File options.
  • Auto-Increment: Automatically increments Invoice Number on successful transactions for rapid testing.

Downloads (Which one should I use?)

This release includes two versions of the simulator.

1️⃣ Recommended: GHL_Simulator_Deadboy_CSharp.exe (Small & Fast)

  • Built with: C# (.NET / Windows Forms).
  • Size: ~150KB - 30MB (depending on runtime).
  • Performance: Native Windows performance, responsive UI, and robust COM port handling.
  • Use this version for day-to-day testing.

2️⃣ Alternative: GHL_Simulator_Deadboy_Python_v7.exe

  • Built with: Python (Tkinter).
  • Size: ~11MB.
  • Note: This is the legacy prototype version. It functions identically but has a larger file size.

🛠 Hardware Requirements

To use this simulator with your physical POS hardware, ensure you have the following setup:

  1. USB to RS232 Adapter: Must use Prolific PL2303 Chipset (FTDI is known to cause compatibility issues with the PAX Base).
  2. Cable Wiring: Standard T568B to DB9 (Refer to documentation in source).
  3. Baud Rate: 9600 | Data: 8 | Parity: None | Stop: 1

📦 How to Run

  1. Download the .exe file.
  2. Plug in your RS232 cable to the PC.
  3. Run the application (No installation required).
  4. Select your COM port from the dropdown and click CONNECT.
Assets 4
Loading