1. Overview
The OctopusTMS POS SDK is an Android library that enables partner applications to process card payments through UNISWITCH-certified POS terminals. The SDK abstracts all hardware communication, EMV processing, key management, and printer control behind a clean, high-level API.
Multi-device Support
A single integration works across all supported OEM devices — the SDK automatically detects the hardware at runtime and routes all calls to the appropriate driver internally.
| OEM | Status | Notes |
|---|---|---|
| HorizonPay | ✓ Supported | Full EMV contact + contactless, PIN pad, thermal printer |
| Topwise | ✓ Supported | Full EMV contact + contactless (Paywave/Paypass/QPBOC), PIN pad, thermal printer |
| Additional OEMs | Coming soon | New device drivers are added in SDK updates without API changes |
Key Capabilities
- One-call payment flow via startPayment()
- Automatic OEM detection
- Automatic terminal-key provisioning from the UNISWITCH TMS
- Thermal receipt printing from any Bitmap
- BitmapBuilder utility for constructing pixel-perfect formatted receipt bitmaps