Introduction and Integration Model

The Pinpad Getnet solution is a specialized payment application developed for Newland N750P terminals. This application transforms the device into a high-performance payment peripheral, allowing it to process card payments via magnetic stripe, chip, and contactless technologies, as well as render dynamic QR codes.
The solution communicates with a Host System through a serial port interface. Through this connection, the application receives standardized command requirements, manages physical hardware interactions (such as reading a card or capturing a PIN), and returns formatted responses with the necessary transaction data.

General Integration Model

The integration model defines the coordinated flow between the cardholder, the Pinpad, the Host System, and the financial authorizer.

  1. Requirement: The Host System initializes the transaction and formats a command requirement. This payload is sent to the terminal via the serial interface.
  2. Interaction: The Pinpad receives the command and manages the physical interaction, prompting the user for card entry or displaying a QR code.
  3. Capture: The cardholder inserts, swipes, or taps their card. The Pinpad captures sensitive data and, if required, prompts for a PIN using its secure keyboard.
  4. Data Retrieval: The Pinpad returns the processed data to the Host System.
  5. Authorization: The Host System communicates with the Authorizer (Switch/Bank) to approve or decline the request.
  6. Finalization: The Host System forwards the authorizer's response to the Pinpad. If the transaction was an EMV Contact (Chip) operation, the Pinpad uses this data to perform the "Second Generate AC" to conclude the transaction.

Internal Software Architecture

Pinpad Getnet is built on a modular architecture composed of specialized libraries and components that manage the payment lifecycle.

  • SerialCom (Serial Communication Library): A reusable .aar library that provides a unified interface for managing raw serial port data flow between the terminal and the Host System.
  • HandlerCommands (Command Processor): This module manages the processing of commands received from the Host. It operates using its own internal state machine to validate command types (e.g., Y19, Y02) and trigger the appropriate logic.
  • Transaction (Transaction State): A centralized module that stores the current status, amounts, and metadata of the ongoing transaction to ensure consistent data reporting.
  • CardReader & EmvL3Flow (Hardware Logic): The CardReader handles physical card detection across all interfaces. Once detected, the EmvL3Flow module executes the complex EMV L3 protocol steps, including card authentication and application selection.
  • UI/UX & PinEntryActivity (User Interface): UI/UX manages the visual navigation. When a PIN is required, the EmvL3Flow triggers the PinEntryActivity, which takes exclusive control of the terminal's secure keyboard to safely capture user input.

Next Steps

To begin your integration:

  1. Review the Glossary to understand the specific message formats and terminology.
  2. Follow the Environment Setup guide to prepare your Newland N750P terminal.
  3. Perform a Connectivity Check using the Echo Request (Y0I) command to verify communication between your system and the Pinpad.

On this page

Introduction and Integration Model
General Integration Model
Internal Software Architecture
Next Steps