The PIN Pad App is an Android application designed to run on supported POS devices. It exposes payment terminal functionality to external systems by listening for incoming requests and executing payment-related operations.

Typical operations include:

Card payment processing
Transaction cancellation (void)
Batch close
Other terminal-related commands supported by the payment processor

The application acts as a bridge between external systems and the payment terminal hardware.

Connection modes

The application supports two primary connection modes: Global mode and Local mode. The selected mode determines how the application receives requests and communicates with external services.

The connection mode can be selected in the Administration section, by selecting the Connection type.

Global Mode

In Global mode, the application connects to a remote Mediator.

In this configuration:

The device maintains a connection to the remote service.
Incoming payment requests are delivered from the backend.
The PIN Pad App executes the requested operation on the POS device.
Transaction results are returned to the remote service.

This mode is typically used when payment terminals are centrally managed or when requests originate from systems outside the local network.

Local Mode

In Local mode, the application operates entirely within the local network.

In this configuration:

The PIN Pad App exposes a local endpoint.
External systems send requests directly to the POS device.
No remote service connection is required.

This mode is typically used when the POS software and the payment terminal operate within the same local infrastructure.

Typical Workflow

Regardless of the connection mode, the request processing flow is generally the same:

An external system sends a request (e.g., start payment).
The PIN Pad app receives the request.
The application processes the request (e.g. interacts with the POS device or payment gateway).
The result of the operation is returned to the requesting system.