C/C++ Windows Library

Supported Connections

Connection TypeSupportedNotes
TCP/IP (Wi‑Fi / LAN)Recommended for stable and fast communication
Serial (COM / USB CDC)Requires COM port configuration (baud, parity, etc.)
BluetoothUses device MAC address for connection

TCP/IP (Wi‑Fi / LAN)

Step 1: Prepare Your Project

  • Include EcrApi.h in your C/C++ project.
  • Ensure your system supports socket communication.

Step 2: Configure Terminal Settings

  • Enter terminal IP address and port (e.g., 192.168.0.102:8888).

Step 3: Connect to Terminal

  • Call doTCPIPTransaction() with IP, port, request data, and signature.

Step 4: Perform Transaction

  • Build request data (amount, CRN, etc.).
  • Send transaction request.

Step 5: Review Response

  • Parse response fields (approval code, receipt details).

Step 6: Disconnect Session

  • Call disconnect method when done.

Flow Summary

Connect → Register (17) → Start Session (18) → Transaction (0) → Response → Disconnect

Example

doTCPIPTransaction("192.168.0.102", 8888, requestData, 0, signature, response);

Serial (COM / USB CDC)

Step 1: Identify COM Port

  • Example: COM3.

Step 2: Configure Serial Parameters

  • Baud rate, parity, data bits, stop bits.

Step 3: Connect to Terminal

  • Call doCOMTransaction() with COM port and parameters.

Step 4: Perform Transaction

  • Build request data and send.

Step 5: Review Response

  • Parse approval/decline, receipt details.

Flow Summary

COM Connect → Register → Session → Transaction → Response

Example

doCOMTransaction("COM3", 9600, 0, 8, 1, requestData, 0, signature, response);

Bluetooth

Step 1: Pair Terminal

  • Pair terminal with host system.

Step 2: Get Device Address

  • Example: 00:11:22:33:44:55.

Step 3: Connect to Terminal

  • Call doBlueToothTransaction() with MAC address.

Step 4: Perform Transaction

  • Build request data and send.

Step 5: Review Response

  • Parse approval/decline, receipt details.

Flow Summary

BT Connect → Transaction → Response

Example

doBlueToothTransaction("00:11:22:33:44:55", requestData, 0, signature, response);