Get Mini Android SDK Overview
What You'll Learn
This overview introduces the Get Mini Android SDK architecture, explains how your application communicates with the Pinpad 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.).
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 Pinpad 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, allowing your application to remain outside the PCI scope while still controlling 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 Pinpad.
- 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.
- Pinpad 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
| Method | Description | Best for |
|---|---|---|
| Direct Library | Integrate the mPOS library directly into your Android application to control Pinpad 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 Pinpad and the payment host.
- Quickstart: Your first sale – Learn how to log in, connect and initialize the Pinpad, and process a basic card payment using the SDK.
Nesta página