Get Mini Android SDK Overview
The Get Mini Android SDK (iTPV-PC) enables developers to integrate secure card payments into their Android applications by connecting to an external Get Mini PIN pad. In this model, the Android device acts as a host application, while all card reading, PIN entry, and cryptographic operations are executed on the certified PIN pad device.
This SDK is designed for mPOS (mobile Point of Sale) scenarios, where an Android phone or tablet controls the payment flow and communicates with a paired PIN pad over Bluetooth, USB, or Wi‑Fi.
What You’ll Learn
This overview introduces the Get Mini Android SDK architecture, explains how your application communicates with the PIN pad and the payment host, and summarizes the main capabilities provided by the SDK. After reading this section, you will understand the integration approach and be ready to add the SDK to your Android project.
Architecture
The Get Mini SDK follows a host–terminal architecture typical of mPOS solutions.
Your Android application integrates a client-side mPOS library and is responsible for initiating payment operations, such as sales or refunds, by providing transaction data (amount, currency, invoice reference, etc.).
Communication with the physical payment hardware is handled through the PIN pad Manager, which establishes and manages the connection to the Get Mini PIN pad via Bluetooth, USB, or Wi‑Fi. The PIN pad performs all sensitive operations, including card reading (EMV, contactless, or magnetic stripe), PIN verification, and secure key handling.
The Get Mini Android SDK exchanges messages with the payment authorization host using the P.U.P protocol. Transaction results flow back from the host, through the PIN pad and the SDK, to your application, where they can be processed and presented to the user.
This architecture ensures that sensitive card data and cryptographic processes remain confined to certified payment components, while your application keeps control of the payment experience.
Key Features
The Get Mini Android SDK provides support for a wide range of mPOS payment operations:
- Card payments using chip (EMV), contactless, and magnetic stripe through a connected PIN pad.
- Transaction operations including sales, refunds (with or without original transaction), pre-authorizations, confirmations, and cancellations.
- Recurring and reference payments, allowing subsequent charges without re-presenting the card when supported by the transaction flow.
- Operational queries, such as transaction searches, daily totals, session closures, and financial receipt data retrieval.
- PIN pad management, including connection status, initialization, and controlled opening and closing of communication sessions.
All network operations are performed asynchronously and must not be executed on the Android UI thread.
Integration Methods
Get Mini payment functionality can be integrated into your Android solution using different approaches. This documentation focuses on the Direct Library integration using the Get Mini Android SDK.
| Method | Description | Best for |
|---|---|---|
| Direct Library | Integrate the mPOS library directly into your Android application to control PIN pad connection and payment flows programmatically | Applications requiring tight integration with business logic and full control of the payment lifecycle |
| App2App | Launch a certified payment application via Android Intents to delegate the payment flow | Faster integrations with minimal development effort (documented separately) |
For App2App integrations, refer to the dedicated Get Mini App2App documentation.
Next Steps
- Add the SDK to your project – Include the Get Mini Android SDK library (.jar) in your Android application and configure required dependencies.
- Configure Android permissions – Declare the necessary Bluetooth and network permissions to communicate with the PIN pad and the payment host.
- Quickstart: Your first sale – Learn how to log in, connect and initialize the PIN pad, and process a basic card payment using the SDK.