Logging In
When you first open NetPOS, you’ll be presented with the login screen.Enter your username
In the Username field, enter your registered email address or username. The field accepts lowercase letters, numbers, and these special characters:
. _ @The username field is located at LoginFragment.kt:48-64 and includes an email icon for easy identification.Enter your password
In the Password field, enter your account password. Click the eye icon on the right to toggle password visibility.
The password field uses secure input masking to protect your credentials from shoulder surfing.
Tap Login
Press the LOGIN button to authenticate. The system will verify your credentials with the Storm API backend.A progress indicator will appear on the button while authentication is in progress.
Authentication Flow
The authentication process involves several backend steps:- Credential Validation - Your username and password are validated against the Storm API
- Terminal Initialization - NetPOS Terminal Config is initialized with your device settings
- MQTT Event Logging - An authentication event is logged with your business name, Storm ID, and device serial
- Session Creation - A secure session is established for your terminal
Password Reset
If you’ve forgotten your password, NetPOS provides a self-service password reset feature.Access password reset
On the login screen, tap the Forgot Password? link located below the password field.This will open the password reset dialog (
LoginFragment.kt:82-84).Enter your registered email
In the password reset dialog, enter the email address registered with your Storm account.
Password Reset Dialog Fields
Password Reset Dialog Fields
- Header: “Reset Password” in primary color
- Email Field: Accepts your registered email with Storm
- Close Button: X icon in the top-right corner
- Reset Button: Submits the password reset request
Submit reset request
Tap the RESET PASSWORD button. A progress indicator will show while the request is being processed.The system calls
viewModel.resetPassword() which sends a password reset email to your registered address.Toast Notifications
During the authentication process, you may see various toast messages:- Success: “Authentication successful” or automatic redirect to Dashboard
- Invalid Credentials: “Invalid username or password”
- Network Error: “Please check your internet connection”
- Server Error: Error message from the backend API
viewModel.message.observe() at LoginFragment.kt:77-80.
Device Registration
NetPOS uses device-specific authentication for enhanced security:- Each device is assigned a unique Device ID generated from hardware identifiers
- The Device ID is sent with every login request (for certain builds like “easypay”)
- This ensures that your terminal credentials are tied to your specific Android device
Your device ID is automatically generated and managed by NetPOS. You don’t need to configure it manually.
Security Best Practices
Strong Passwords
Use a combination of letters, numbers, and special characters for your password.
Keep Credentials Private
Never share your login credentials with others, even colleagues.
Secure Device
Keep your Android device locked with a PIN, pattern, or biometric authentication.
Regular Updates
Change your password periodically to maintain security.
Troubleshooting
Login button not responding
Ensure you’ve entered both username and password. The login button may be disabled if fields are empty.Authentication taking too long
Check your internet connection. The authentication process requires communication with Storm API servers.Password reset email not received
- Check your spam/junk folder
- Verify you entered the correct registered email address
- Contact your administrator if the issue persists
Automatic logout
Your session may expire after a period of inactivity. Simply log in again to resume.Next Steps
Dashboard Overview
Learn about the Dashboard and available services
Process Transactions
Start processing customer transactions