Glossary

The Glossary chapter provides quick definitions and clarifications for terms, abbreviations, and concepts used throughout the SDK integration guides. Its purpose is to ensure that users can instantly understand key terminology without breaking the reading flow.

A

Approval Code

A unique code returned by the bank to confirm that a transaction is approved.

B

Bluetooth Connection

A wireless method used to connect the POS system to the payment terminal after pairing the devices.

C

CDC (Communication Device Class)

A USB mode that allows the payment terminal to behave like a serial (COM) port when connected to a POS system.

COM Port

A communication port on a computer used to connect external devices such as payment terminals via USB or serial cable.

D

Device Manager

A Windows tool used to view and manage hardware devices, including COM ports.

E

ECR (Electronic Cash Register)

The POS system or billing application that communicates with the payment terminal to process transactions.

ECR Reference Number (CRN)

A unique number generated by the POS system to identify each transaction.

I

IP Address

A unique number assigned to a device on a network (for example: 192.168.0.102) used to connect via TCP/IP.

L

LAN (Local Area Network)

A network that connects devices within a limited area such as a shop or office.

M

Middleware

A software layer that simplifies communication between the POS system and the payment terminal without requiring direct SDK integration.

P

POS (Point of Sale)

The system used by merchants to bill customers and process payments.

Port (Network Port)

A communication endpoint used in TCP/IP connections (for example: 8888).

R

RRN (Retrieval Reference Number)

A unique 12-digit number assigned to a transaction for tracking and reference.

S

SDK (Software Development Kit)

A set of tools and libraries used by developers to integrate payment functionality into applications.

Serial Connection (COM / USB CDC)

A wired connection between the POS system and terminal using a USB cable that acts as a COM port.

Signature (SHA-256)

A security value generated to ensure the transaction request is authentic and not altered.

T

TCP/IP (Wi-Fi / LAN)

A network-based communication method used to connect the POS system and terminal using IP address and port.

Terminal (Payment Terminal)

The physical device used to accept card or digital payments.

Transaction

A payment operation such as purchase, refund, or reversal.

Transaction Type

Defines the type of operation being performed (e.g., Purchase, Refund, Cashback).

U

USB CDC Mode

A USB configuration that allows the terminal to be recognized as a COM port on the POS system.