Login & Access Issues – Complete Troubleshooting Guide

Overview

Login and access issues prevent users from entering Hana POS, making them high-priority operational blockers. Since florists rely on Hana POS for daily transactions, any login failure can result in:

• Inability to process orders
• Delayed customer service
• Business downtime

This guide provides a systematic approach to quickly diagnose and resolve login issues, ensuring minimal disruption to operations.

Why This Matters (Support Context)

Login issues are often urgent and time-sensitive, especially during business hours.

? Key Insight:
Most login problems are not system failures, but are caused by:

• Incorrect credentials
• Browser/cache issues
• Account lockouts after multiple attempts

? A structured approach helps agents:

• Resolve issues quickly at Tier 1
• Avoid unnecessary escalation
• Improve user confidence

Common Symptoms Reported by Users

Users may describe login issues in different ways:

• Unable to log in to Hana POS
• “Incorrect password” error
• Account locked after multiple attempts
• OTP not received
• Login page not loading or stuck

Root Cause Categories

Understanding the root cause speeds up resolution:

1. Credential Issues

• Incorrect email/username
• Wrong password (case-sensitive errors)

2. Account Lock / Security Restrictions

• Multiple failed login attempts
• Temporary account lock for security

3. Browser/Cache Issues

• Cached old session data
• Conflicts with cookies or extensions

4. Email/OTP Delivery Issues

• Reset email going to spam
• Incorrect email address entered
• Delay in OTP delivery

5. Network/Browser Issues

• Slow or unstable internet
• Unsupported or outdated browser

Step-by-Step Troubleshooting Process

⚠️ Always start with basic validation before assuming a system issue.

Step 1: Verify Credentials (First and Most Important Step)

Ask the user to confirm:

• Correct email/username
• Password entered carefully (case-sensitive)
• No extra spaces while typing

? Why this matters:
A majority of login failures are due to simple input errors.

Step 2: Reset Password

If credentials are uncertain:

1. Click “Forgot Password”
2. Enter registered email address
3. Follow reset instructions from email
4. Create a new password
5. Retry login

? Best Practice:
Encourage password reset early to avoid repeated failed attempts.

Step 3: Clear Cache / Use Incognito Mode

Ask the user to:

• Clear browser cache and cookies
  OR
• Open an Incognito/Private window
• Attempt login again

? Why this works:
Removes stored session data that may interfere with authentication.

Step 4: Check Account Lock Status

If multiple failed attempts occurred:

• Inform user that account may be temporarily locked
• Options:
  • Wait for auto-unlock (if applicable)
  • Reset password to regain access

? Important:
Repeated attempts during lock period may extend the lock duration.

Step 5: Verify Email / OTP Delivery

If user is not receiving reset email or OTP:

• Ask them to check:
  • Spam/Junk folder
  • Correct email address entered
• Ask them to retry password reset

? Additional Check:

• Ensure no typo in email (common issue)

Step 6: Check Network & Browser

If login page is not loading or behaving unexpectedly:

• Confirm stable internet connection
• Try:
  • Different browser (Chrome recommended)
  • Different device (if available)

Critical Scenarios & How to Handle Them

Account Locked After Multiple Attempts

• Explain this is a security feature
• Guide user to:
  • Reset password
    OR
  • Wait for unlock period

OTP / Reset Email Not Received

Possible causes:

• Spam filtering
• Incorrect email
• Delay in email delivery

✅ Action:

• Verify email address
• Retry request
• Ask user to check spam folder

Login Page Not Responding

Possible causes:

• Browser issue
• Network lag

✅ Action:

• Refresh page
• Use incognito mode
• Switch browser/device

Best Practices for Support Agents

• ✅ Always verify credentials first
• ✅ Encourage password reset early
• ✅ Use incognito mode as a quick fix
• ✅ Confirm email accuracy before troubleshooting OTP issues
• ❌ Do NOT assume system issue without validation
• ❌ Avoid repeated login attempts (may lock account)

Escalation Guidelines

Escalate ONLY IF:

• Multiple users are unable to log in (possible system-wide issue)
• Login failures persist despite password reset and cache clearing
• OTP/email delivery is failing for multiple users
• Authentication system appears unresponsive

? Include in escalation:

• User email/username
• Error message (if any)
• Time of issue
• Steps already attempted

FAQ Section

Q1: Why can’t I log in?

Most commonly due to:

• Incorrect password
• Cached browser data

Q2: Why is my account locked?

This happens due to:

• Multiple failed login attempts
• Temporary security lock

Q3: Why am I not receiving reset email?

Possible reasons:

• Email in spam folder
• Incorrect email entered

Q4: How long does account lock last?

Depends on system settings, but usually temporary. Resetting password can often restore access immediately.

Support Agent Script (Standardized)

Opening

“I understand you're having trouble logging in. Let’s resolve this quickly.”

Credential Check

“Could you please confirm your email and try entering the password carefully once more?”

Password Reset Guidance

“Let’s try resetting your password using the ‘Forgot Password’ option.”

Cache/Browser Fix

“Also, please try logging in through an incognito window or after clearing your browser cache.”

Reassurance

“This is a common issue and we should be able to fix it quickly.”

Closure (Resolved)

“You should now be able to log in successfully. Please try again and let me know.”

Closure (Escalation)

“Thanks for trying those steps. I’ll escalate this to get it resolved as soon as possible.”