Skip to main content

Terminal driver

Introduction​

The Stitch terminal driver provides a seamless way to connect Stitch payment terminals across a wide range of deployment configurations. It decouples the terminal interface from the point-of-sale (POS) system, allowing you to integrate Stitch terminals with your chosen POS software in a flexible and scalable way.

Stitch supports both integrated and standalone terminal deployments when connecting to POS systems:

Integrated terminals​

The terminal operates as part of the POS environment. A reliable internet connection is required on the premises so the terminal can communicate with Stitch to authorise and process payments in real time.

Standalone terminals​

The terminal uses its own connectivity (for example, via a cellular network) to process transactions. This setup is ideal where the POS or premises do not have a stable internet connection, or where the terminal needs to operate independently of a fixed POS system.

Integration options​

The Stitch terminal driver can be integrated into a POS or till environment in several ways. The most appropriate approach depends on how your POS system is built, maintained, and extended.

Direct integration (SDK)​

The terminal driver is included as part of the Stitch SDK. Teams that develop and maintain their own POS or till software can use the SDK to embed payment functionality directly into their application, enabling a tightly integrated payment experience.

Plugin​

You can add Stitch as a payment method to an existing POS that supports third-party payment add-ons.

Some POS systems allow third parties to provide plugins (or extensions) that add additional functionality. In this model, Stitch provides the plugin and documentation to guide merchants or their IT teams through installation and configuration.

Because plugins are POS-specific, availability depends on the POS platform. Please contact Sales to confirm whether your POS is supported. Alternatively, you can build your own plugin using the Stitch SDK.

Gateway or service​

For third-party POS systems that do not support plugins but expose an API for payment integration, the Stitch terminal driver can be implemented as part of a gateway or intermediary service that sits between the POS and the terminal.

In one deployment model, a single on-premises service connects to multiple POS systems and multiple terminals over TCP/IP. Alternatively, each POS can run its own local service instance, depending on the architecture and operational requirements.