Device & Terminal Management

Part of: MPAC SmartPOS Cloud Platform - Product RequirementsVersion: 2.0 Last Updated: 2026-01-28

---

Overview

The Device & Terminal Management domain defines the lifecycle, operations, configuration, and monitoring of the SmartPOS terminal fleet. It provides comprehensive management capabilities for 400,000+ concurrent devices, including provisioning, health monitoring, remote configuration, and fleet operations. This domain ensures operational excellence through real-time status tracking, automated alerting, and bulk management capabilities.

Table of Contents

• Device Operations
• Device Attributes
• Device Management Features
• Portal UI Features
• API Endpoints

---

Device Operations

Purpose: Manage fleet of SmartPOS terminals including provisioning, monitoring, and configuration.

Device Attributes

• Device ID (UUID, primary key)
• Serial Number (hardware identifier)
• Client ID (OAuth2 identifier)
• Merchant/Store Assignment
• Public Key (for signature verification)
• Status (active, suspended, decommissioned)
• Device Model/Manufacturer
• Activation Date
• Last Connected Timestamp
• Battery Level
• Paper Status (OK, LOW, EMPTY)
• GPS Location (optional)

---

Device Management Features

1. Device Activation

• Generate activation code
• Bind to merchant/store
• Configure device settings
• Assign printer configuration

2. Device Monitoring

• Online/offline status
• Battery level alerts
• Paper low notifications
• Connection health
• Transaction activity

3. Device Configuration

• Printer settings (IP, port, protocol)
• Payment method enablement
• Receipt delivery preferences
• App version policy
• Network configuration

4. Device Lifecycle Management

• Suspend device (temporary)
• Decommission device (permanent)
• Transfer device to different store
• Bulk device operations
• Device replacement workflow

---

Portal UI Features

• Device list with filters (store, status, model)
• Device detail view with health metrics
• Activation wizard
• Bulk device import/export
• Device activity logs
• Alert configuration

---

API Endpoints

• GET /terminals - List devices with filters
• GET /terminals/{id} - Device details
• POST /terminals - Register new device
• PATCH /terminals/{id} - Update device
• POST /terminals/{id}/suspend - Suspend device
• POST /terminals/{id}/transfer - Transfer to different store
• DELETE /terminals/{id} - Decommission device

---

See Also

Related Domains:

• Identity & Access Management - Device authentication and provisioning flows
• App Updates - Device software version management and deployment
• Merchant Hierarchy - Device assignment to merchant organizational structure

Technical Implementation:

• Security Architecture - Device authentication and cryptographic specifications
• Database Architecture - Device data model and schema design

API Reference:

• API Endpoints - Complete API specification for device management endpoints

---

Navigation: ← Previous: IAM | ↑ Back to Domain Catalog | Next: Merchant Hierarchy →