Complete Onboarding Process
Follow this comprehensive guide to set up your CaliPay account, verify your property details, and configure payment methods.
Onboarding Overview
Step-by-Step Guide
1Name Input Screen
Enter your personal information to create your CaliPay profile.
Required Information:
- First Name: Required (maximum 255 characters)
- Last Name: Optional (maximum 255 characters)
Features:
- Real-time validation with error clearing
- Pre-fills existing data if available
- Cupertino design with proper text fields
2UPI Input Screen
Set up your UPI ID for seamless payment processing.
UPI ID Requirements:
- Format: username@bankname (e.g., john.doe@paytm)
- Validation: Follows regex pattern
^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+$ - Examples: john@gpay, user123@phonepe, member@paytm
What is a UPI ID?
UPI ID is your unique payment address that allows you to send and receive money instantly. You can find this in your payment apps like Google Pay, PhonePe, or Paytm under "UPI ID" or "Payment Address".
3Property Selection Screen
Select your property details from the hierarchical structure provided by your association.
Selection Process:
Subproject: Choose your residential complex or phase
Block: Select your building block or tower
Building: Choose your specific building
Important Notes:
- Single Selection: You can only select one option at each level
- Hierarchical: Each selection determines available options for the next level
- Required: At least one subproject must be selected
- Radio Button Behavior: Previous selections are cleared when making new choices
4Plot/Flat Input Screen
Enter your specific unit numbers (plot numbers, flat numbers, house numbers, etc.).
Input Features:
- Multiple Values: Add multiple plot/flat numbers if you own several units
- Dynamic Addition: Use "+" button to add more entries
- Validation: Each entry is validated for uniqueness and length
- Required: At least one plot/flat number must be provided
Examples:
Plot Numbers: 101, 102, 103
Flat Numbers: A-201, B-305, C-102
House Numbers: 15, 23, 45
5Summary Screen
Review all your information before final submission.
Information Sections:
Personal Information
- Phone number
- First & last name
Payment Information
- UPI ID
Property Information
- Subproject
- Block & building
- Plot/flat numbers
Final Steps:
- Edit Functionality: Click on any section to go back and make changes
- Multi-value Display: Plot/flat numbers shown as chip-style tags
- Submission: Loading states and progress indicators
- Success/Error Dialogs: Clear feedback on registration status
Technical Implementation
Architecture
- State Management: Provider pattern with OnboardingState
- Navigation: Cupertino page routes with proper back navigation
- Data Storage: Uses AuthService for property details storage
- Validation: Real-time validation with user feedback
Logging & Analytics
- Centralized Logging: AppLogger singleton with logger package
- Comprehensive Coverage: State changes, navigation, validation
- Structured Logging: JSON-formatted logs with timestamps
- Log Levels: Debug, Info, Warning, Error
Common Issues & Solutions
❌ Invalid UPI ID Format
Issue: "Please enter a valid UPI ID" error message
Solution: Ensure your UPI ID follows the format username@provider (e.g., john@gpay, not just "john")
❌ Property Selection Not Available
Issue: No buildings or blocks shown after selecting subproject
Solution: Contact your association admin to ensure property hierarchy is properly configured
❌ Registration Submission Failed
Issue: Error during final submission step
Solution: Check your internet connection and try again. If issue persists, contact support
After Onboarding
Explore Features
Learn about payment processing, invoice management, and notifications.
View Features →