User Tier Management
Overview
The User Tier Management system allows organizations to configure spending limit tiers and manage individual user spending limits. The system is accessed through Setting > User Tiers in the admin portal.
Key Components
User Tier Configuration
The system allows configuration of multiple user tiers with different spending limit ranges:
| Tier Code | Description | Min Spending Limit | Max Spending Limit | Assignees |
|---|---|---|---|---|
| high | High Quality | US$200.00 | US$300.00 | 5 users |
| medium | Medium Quality | US$100.00 | US$150.00 | 322 users |
| low | Lower Quality | US$20.00 | US$30.00 | 0 users |
| new | New Tier | US$5.00 | US$10.00 | 1 user |
Tier Management Features
- Default Tier Selection: Set which tier is assigned to new users by default
- Editable Descriptions: Customize tier names and descriptions
- Flexible Limit Ranges: Configure minimum and maximum spending limits for each tier
- User Assignment Tracking: View how many users are assigned to each tier
- Add New Tiers: Create additional tiers as needed
Individual User Spending Limits
Spending Limits Overview
Access individual user spending limits through Payment > Spending Limits to manage user-specific limits and monitor spending.
Maximum Exposure Dashboard
- Maximum Exposure: US$1,000,000.00 (total organizational limit)
- Total Issued: US$49,680.00 (currently allocated to users)
- Available: US$950,320.00 (remaining available for allocation)
User Spending Management
The system displays comprehensive user spending information:
| Field | Description |
|---|---|
| ID | Unique user identifier |
| mPass Number | User's mPass identification number |
| Consumer | User's full name |
| Tier | Assigned tier (e.g., "Medium Quality") |
| Spending Limit | Maximum allowed spending amount |
| Spent | Current spent amount |
| Remaining | Available balance (can be negative if overspent) |
| Last Updated | Timestamp of last modification |
| Actions | Edit button for individual limit adjustments |
Edit User Spending Limits
Individual user limits can be modified through the edit interface:
Edit Options
- User Tier Assignment: Change user's tier which automatically adjusts spending limits
- Default vs Custom Limits: Choose between tier-based limits or custom amounts
- Spending Limit Range: Set custom minimum and maximum spending limits
- Real-time Validation: Tier ranges are displayed to guide limit setting
Approval Process
Changes to user spending limits are subject to an approval workflow:
- Approval Required: All spending limit modifications require administrator approval
- Processing Delay: Changes have a configurable delay period (default: 24 hours)
- Pending Status: Modified limits remain in pending status until approved and delay period expires
- Administrative Oversight: Ensures proper review and control over spending limit adjustments
Search and Filtering
- Tier-based Search: Filter users by tier using @[tier-code] syntax (e.g., @medium)
- General Search: Search across all user fields
- Sortable Columns: Sort by ID, mPass Number, Consumer name, Spent amount, Remaining balance, and Last Updated
Debit History Management
Overview
The Debit History feature provides comprehensive tracking of users who have exceeded their spending limits and are scheduled for automatic debit processing. This system is accessed through Payment > Debit History.
Key Components
Transaction Overview
The debit history displays all transactions that occur when users exceed their minimum spending limits, triggering automatic charge creation after reconciliation.
Search and Filter Functionality
- Universal Search: Search across all transaction fields
- Status Filtering: Filter transactions by status (Finalized, Pending, etc.)
- Real-time Results: Instant search results as you type
Transaction Details
The system displays comprehensive information for each debit transaction:
| Field | Description |
|---|---|
| TXN ID | Unique transaction identifier with copy functionality |
| User ID | Unique identifier for the user with copy functionality |
| User Name | Full name of the user/consumer |
| Description | Detailed reason for the debit (e.g., "Minimum spending limit exceeded - charge created after reconciliation") |
| Debit Amount | Amount debited in US dollars |
| Status | Current transaction status with color coding |
| Submission Date | Date when the transaction was submitted |
| Failure Reason | Reason for failure (displayed when applicable) |
| Retry Count | Number of retry attempts (e.g., "1 of 3") |
| Next Retry | Scheduled date and time for next retry attempt |
Transaction Status Types
- Finalized: Successfully completed transactions with no further action required
- Additional statuses may be available based on transaction processing stages
Features
Transaction Management
- Comprehensive History: View all debit transactions with full details
- Copy Functionality: Click to copy Transaction IDs and User IDs
- Sorting Options: Sort by any column header for better organization
- Status Tracking: Monitor transaction progression through different states
- Retry Monitoring: Track failed transactions and their retry schedules
Data Navigation
- Pagination: Navigate through large transaction lists
- Result Count Display: Shows current view range (e.g., "Showing 1-2 of 2")
- Clickable Rows: Select transactions for detailed analysis
Operational Notes
- Debit transactions are automatically created when users exceed their spending limits
- The system handles retry logic for failed transactions
- All transactions maintain detailed audit trails for compliance and monitoring
- Status updates are reflected in real-time as transactions process