Integration Options
NetPOS offers three primary integration methods:SDK Integration
Embed NetPOS functionality directly into your Android application
MQTT Notifications
Real-time event streaming for transactions, authentication, and device events
REST API
HTTP endpoints for transactions, user management, and data retrieval
Common Use Cases
Point-of-Sale Applications
Integrate the NetPOS SDK to build custom POS applications with:- Card payment processing (contact and contactless)
- QR code payments (MasterPass, NIBSS, Zenith)
- Transaction management and reporting
- Receipt printing
- Device configuration
Backend Integration
Connect your backend systems using:- REST APIs for transaction queries, user authentication, and data synchronization
- MQTT for real-time transaction notifications and device monitoring
- Webhooks (Firebase Cloud Messaging) for push notifications
Multi-Channel Commerce
Build unified commerce experiences:- Synchronize in-store and online transactions
- Real-time inventory updates
- Unified customer profiles
- Cross-channel analytics
Architecture Overview
NetPOS follows a distributed architecture:Device Initialization
The NetPOS SDK initializes on app startup, loading EMV parameters and terminal configuration.
Transaction Processing
Transactions are processed through the SDK and logged to both local database and backend API.
Security
All integrations use industry-standard security:Transport Security
Transport Security
- TLS 1.2+ for HTTPS connections
- MQTTS (MQTT over TLS) on port 8883
- Certificate pinning for API clients
- Mutual TLS authentication for MQTT
Authentication
Authentication
- JWT tokens with Bearer authentication
- Token expiration and refresh
- Role-based access control
- Terminal-specific credentials
Data Protection
Data Protection
- PCI-DSS compliant card data handling
- Encrypted local storage
- Sensitive data masking
- Secure key storage (Android KeyStore)
Environment Configuration
NetPOS supports multiple environments:| Environment | API Base URL | MQTT Broker |
|---|---|---|
| Production | https://netpos.netpluspay.com/ | BuildConfig.BASE_URL_NETPOS_MQTT |
| Staging | Configured via app-settings.properties | Configured per environment |
env.use.mode.production flag in your build configuration.
Getting Started
SDK Integration
Start with SDK setup for Android applications
API Integration
Explore REST API endpoints for backend integration
Support
For integration assistance:- Technical documentation: Review the detailed integration guides
- Sample code: Available in the NetPOS repository
- Terminal configuration: Contact your NetPOS account manager