Comprehensive Troubleshooting Guide
Need immediate help? Check the Before Contacting Support checklist first. Most issues can be resolved in minutes!
Error Codes Reference Tableโ
| Code | Issue | Module | Severity | Quick Fix |
|---|---|---|---|---|
| E001 | Invalid login credentials | Authentication | High | Verify School Code, GR Number, Password (case-sensitive) |
| E002 | GR Number not found | Authentication | High | Check student ID card; confirm with school admin |
| E003 | Date of birth format incorrect | Authentication | Medium | Use dd-mm-yyyy format (e.g., 15-08-2010) |
| E004 | School Code invalid | Authentication | High | Ask class teacher; verify exact capitalization |
| E005 | Account locked after failed attempts | Authentication | High | Wait 30 minutes or contact school admin |
| E101 | Network timeout on exam | Online Exams | Critical | Check internet; see Network Troubleshooting section |
| E102 | Exam timer mismatch | Online Exams | High | Sync device time; restart app |
| E103 | Answer not submitted | Online Exams | Critical | Reload page; check submission status |
| E104 | Exam access denied (date/time) | Online Exams | Medium | Verify exam schedule in timetable |
| E105 | Random question generation failed | Online Exams | High | Insufficient questions in bank; contact admin |
| E201 | Payment gateway timeout | Billing | Critical | Retry after 5 minutes; check provider status |
| E202 | Payment declined by bank | Billing | High | Verify card details; check with bank |
| E203 | Duplicate charge detected | Billing | Critical | Check bank account; contact support with transaction ID |
| E204 | Wrong currency conversion | Billing | Medium | Confirm invoice currency matches payment method |
| E301 | Attendance window closed | Attendance | Medium | Check submission deadline; contact teacher |
| E302 | Gradebook locked | Attendance & Grades | Medium | Assessment finalized; request admin unlock |
| E401 | Transportation route not available | Transportation | Medium | Enroll in available route; check enrollment deadline |
| E402 | Vehicle GPS offline | Transportation | High | Driver connectivity issue; contact school |
| E501 | Gallery image upload failed | Gallery | Low | Check file size (<10MB); use JPEG/PNG |
| E502 | Gallery sync error | Gallery | Low | Clear cache; restart app |
| E601 | Dashboard data not loading | Dashboard | Medium | Clear cache; check internet; reload |
PART 1: AUTHENTICATION & LOGIN ISSUESโ
Issue 1.1: Student Can't Log Inโ
Error Codes: E001, E004
Before Contacting Support - Verification Checklistโ
- Verify all THREE credentials match exactly (case-sensitive):
- School Code: _________ (confirm with school office)
- GR Number: _________ (check student ID card)
- Password: _________ (check with school if changed recently)
- Phone/Browser time is correct (within ยฑ5 minutes)
- Internet connection is stable
- Not locked after failed attempts (wait 30 minutes if needed)
- App version is latest (check app store for updates)
Quick Fix (Most Common - 5 minutes)โ
- Check your School Code exactly - Often has specific capitalization (e.g., "LACS-001" not "lacs-001")
- Verify GR Number matches your ID card - Copy it exactly as shown
- Try clearing cache (Web Portal only):
- Chrome: Ctrl+Shift+Delete โ Select "All time" โ Clear data
- Safari: Preferences โ Privacy โ "Manage Website Data" โ Remove 4sch.com
- Restart the app (mobile) or try incognito/private window (web)
Advanced Solutionsโ
Solution A: Reset Your Password (Recommended)
- On login page, click "Forgot Password?"
- Enter: School Code, GR Number, Date of Birth (dd-mm-yyyy)
- Follow verification steps
- Set new password (minimum 8 characters, mix of letters & numbers)
- Wait 30 seconds, then log in with new credentials
Solution B: Wrong School Code?
- Contact your class teacher or school office
- Common mistake: Using school name instead of code (e.g., "Lagos Academy" vs "LACS-001")
- Write down the exact code from school
Solution C: Device Time Is Wrong
- Check your device time/date settings
- Ensure it matches your timezone
- Turn on "Automatic date & time" (phone settings)
- Restart app after fixing
Solution D: Account Locked After Failed Attempts
- System locks after 5 failed login attempts
- Wait 30 minutes for auto-unlock
- Or contact school admin for manual unlock
Diagnostic Flowchart (Text-Based)โ
START: Can't log in?
โ
โโโ See error "E001: Invalid credentials"?
โ โโโ YES: Check capitalization of School Code
โ โโโ NO: Continue
โ
โโโ See error "E004: School Code invalid"?
โ โโโ YES: Contact school for exact code
โ โโโ NO: Continue
โ
โโโ Account locked message?
โ โโโ YES: Wait 30 minutes for unlock
โ โโโ NO: Continue
โ
โโโ Still failing? Contact support with error details
Video Reference: See "Student Login Walkthrough" in video tutorials
Issue 1.2: Student Password Reset Not Workingโ
Error Codes: E003, E002
Before Contacting Support - Verification Checklistโ
- GR Number matches exactly (check student ID card)
- Date of Birth is in dd-mm-yyyy format (NOT dd/mm/yyyy)
- School Code is exactly correct (check with teacher)
- Not attempting reset more than once per 5 minutes
- Check email spam folder (if email sent)
- Phone storage has enough space
Quick Fix (Most Common - 3 minutes)โ
The #1 mistake: Wrong date format!
- โ WRONG: 15/08/2010 or 2010-08-15
- โ CORRECT: 15-08-2010
Steps:
- Open 4SCH app or go to ngs.4sch.com
- Click "Forgot Password?"
- Enter School Code (e.g., "LACS-001")
- Enter GR Number (from ID card, e.g., "12345")
- Enter Date of Birth as DD-MM-YYYY (e.g., "15-08-2010")
- Click "Verify"
- Follow verification steps
- Set new password
Advanced Solutionsโ
Solution A: Date Format Still Wrong?
- Use notepad and write: 15-08-2010
- Copy-paste it into the app (avoid typing)
- This prevents accidental spacing errors
Solution B: Still "GR Number Not Found"?
- Your GR Number may have changed
- Check: Student ID card, school admit letter, report card
- Ask class teacher to confirm current GR Number
- If still different, contact school admin
Solution C: School Code Confusion
- School Code โ School Name
- Examples: "Lagos Academy" โ Code might be "LACS-001"
- Contact your school office for exact code
- Write it down and use copy-paste to avoid typos
Solution D: Reset Email Not Arriving
- Check spam/junk folder
- Add admin@4sch.com to contacts
- Wait up to 2 minutes
- If not received: Try again (wait 5 minutes between attempts)
Video Reference: "Password Reset Step-by-Step" tutorialโ
Issue 1.3: Teacher/Parent/Staff Password Reset Not Workingโ
Affected Roles: Teachers, Parents, School Staff, Accountants, Drivers
Before Contacting Support - Verification Checklistโ
- Email address on file is correct
- Check email spam/junk folder
- Email inbox not full (storage issue)
- Not attempting reset more than once per 10 minutes
- If SSO enabled: Contact identity provider instead
- Account not deactivated by admin
Quick Fixโ
For Web Portal Users:
- Go to ngs.4sch.com
- Click "Forgot Password?"
- Enter registered email address
- Check email (including spam folder)
- Click reset link within 24 hours
- Set new password (minimum 8 characters)
Advanced Solutionsโ
Solution A: Email Not Arriving
- Check SPAM folder - Most common fix
- Verify email on file: School admin can check in Admin Console
- Wait up to 2 minutes for email to arrive
- Try again after 10 minutes (rate limiting)
- Contact school admin to resend or check SMTP logs
Solution B: SSO (Single Sign-On) Enabled
- If your school uses SSO (Microsoft, Google, etc.):
- Don't use "Forgot Password" on 4SCH
- Reset password through your identity provider
- Then log in with your SSO account
Solution C: Account Deactivated
- Admin may have deactivated your account
- Contact school admin to reactivate
- Provide: Your name and email
Video Reference: "Staff Password Reset Guide"โ
PART 2: ONLINE EXAMS ISSUESโ
Issue 2.1: Can't Access Online Examโ
Error Codes: E104, E101
Before Contacting Support - Verification Checklistโ
- Exam date/time is TODAY (check timetable)
- Current time is within exam window (e.g., 2:00 PM - 3:30 PM)
- Device time is correct (within ยฑ5 minutes)
- Internet connection is stable (WiFi or 4G)
- App version is latest (check app store)
- Phone storage has at least 500MB free
- Not already submitted (can't re-enter after submission)
Quick Fix (Most Common - 2 minutes)โ
- Check exam timetable: Dashboard โ Exams โ Timetable
- Verify date and time match today's schedule
- Check device time: Settings โ Date & Time โ Enable "Automatic"
- Try refreshing the exam list: Pull down to refresh
- Restart the app completely
Advanced Solutionsโ
Solution A: "Exam Not Yet Available" Error
- Exam hasn't started yet
- Check exam start time in timetable
- Come back at correct time
- Set a phone reminder 5 minutes before
Solution B: "Exam Time Expired" Error
- You're trying to access after deadline
- Check exam window in timetable
- After deadline, exam closes
- Contact teacher if you entered within time but got error
Solution C: Device Time is Wrong
- Phone Settings โ Date & Time
- Enable "Automatic date & time" (use NTP)
- Check timezone matches your location
- Restart phone after changing
- Restart 4SCH app
Solution D: Still Can't Access?
- Check if exam moved to different time (check timetable again)
- Verify you're in correct CLASS/SECTION
- Different sections may have different exam times
- Contact teacher with screenshot of error
Video Reference: "Online Exam Access Guide"โ
Issue 2.2: Exam Timer Not Working / Time Mismatchโ
Error Codes: E102
Before Contacting Support - Verification Checklistโ
- Device time is synchronized (Settings โ Auto sync ON)
- Have stable internet (WiFi preferred for exams)
- App is fully updated to latest version
- Sufficient phone storage (500MB+ free)
- Not using VPN (disables time sync)
- Not in Airplane mode or low power mode
Quick Fix (Most Common - 5 minutes)โ
- Note the timer on screen - How much time left?
- Check your device time โ Settings โ Clock
- Enable automatic time sync:
- Android: Settings โ Date & Time โ "Automatic date and time" ON
- iOS: Settings โ General โ Date & Time โ "Set Automatically" ON
- Restart the app completely
- Return to exam - Timer should sync
Advanced Solutionsโ
Solution A: Timer Showing Wrong Time
- Timer is based on SERVER time, not device time
- If device is set ahead/behind, timer adjusts accordingly
- Always use automatic time sync
Solution B: Timer Keeps Resetting or Jumping
- Indicates poor internet connection
- Switch to WiFi if on mobile data
- Move closer to WiFi router
- Try restarting app
Solution C: Timer Stopped / Frozen
- Note the time on screen
- Check if WiFi/network is disconnected
- Reconnect to internet
- Wait 10 seconds
- Timer should resume
- If still frozen: Exit and re-enter exam (answer loss possible)
Solution D: VPN is Interfering
- If using VPN: Turn it OFF
- Exam system needs accurate time sync
- VPN can disrupt NTP time synchronization
Video Reference: "Online Exam Timer Guide"โ
Issue 2.3: Answers Not Submitting / "Submission Failed"โ
Error Codes: E103
Before Contacting Support - Verification Checklistโ
- Internet connection is active and stable
- Not disconnected mid-exam
- Exam not closed (deadline passed)
- Enough phone storage (at least 100MB)
- App version is latest
- All answers are visible on screen before submitting
- Not using VPN or proxy
Quick Fix (Most Common - 5 minutes)โ
- Check internet connection:
- WiFi: See WiFi icon with checkmark
- Mobile: See 4G/LTE indicator
- Try answering and submitting ONE question:
- Tap an answer
- Scroll down
- Tap "Save" or "Next"
- Wait for confirmation message
- If that works: Continue with other questions
- If that fails: See Solution A below
Advanced Solutionsโ
Solution A: "Connection Failed" or "Submission Error"
Step-by-step fix:
- Don't close the app! Your answers may still be saved locally
- Check internet connection:
- WiFi: Disconnected? Reconnect
- Mobile data: No signal? Move to better location
- Try submitting answer again:
- Tap answer option
- Scroll down
- Tap "Save" / "Next"
- Wait 3 seconds for response
- If still failing: Restart app (carefully):
- Completely close app (swipe out of recent apps)
- Wait 5 seconds
- Reopen app
- Go back to exam
- All answers should still be there
Solution B: "Network Timeout" During Exam
This happens when internet is very slow:
- Check internet speed (needs minimum 1 Mbps)
- Switch to better connection:
- WiFi: Move closer to router
- Mobile: Switch to 4G/LTE (not 3G)
- Disable background apps:
- Android: Close other apps in recent menu
- iOS: Swipe up to close background apps
- Try submitting answer again
Solution C: Exam Closed While Submitting
If exam deadline passes DURING submission:
- System may reject answer
- If happened within 30 seconds of deadline: Contact teacher
- If you submitted AFTER deadline: System won't accept answers
Solution D: Answer Saved Locally But Not Uploaded
Rare issue - answer on phone but not on server:
- Don't refresh or close app
- Try submitting again
- If exam still open: System will upload
- If exam closed: Contact teacher immediately with:
- Your full name
- Question number
- Your answer
- Time you answered
Video Reference: "Online Exam Submission Tips"โ
Issue 2.4: Questions Not Loading or Random Questions Failedโ
Error Codes: E105
Before Contacting Support - Verification Checklistโ
- Exam uses Manual (not Random) assignment OR
- Admin verified enough questions in question bank
- Internet connection is stable
- App cache has been cleared
- Device has at least 500MB free storage
Quick Fixโ
For Random Assignment Exams:
- What should happen: Questions randomly load from question bank
- If questions won't load:
- Click "Refresh" or "Reload Questions"
- Close and reopen exam
- If still failing: See Solution A
For Manual Assignment Exams:
- Questions should appear immediately
- If blank:
- Scroll down (questions may be below)
- Restart app
- Check internet connection
Advanced Solutionsโ
Solution A: "Not Enough Questions" Error
This happens when:
- Random assignment is used
- Question bank doesn't have enough questions
- Example: Teacher set "25 random questions" but only 15 exist
What you should do:
- Don't attempt the exam (will fail)
- Contact your teacher immediately
Solution B: Questions Load Very Slowly
Slow question loading (more than 10 seconds):
- Check internet speed (needs minimum 0.5 Mbps)
- Check WiFi signal (must be 3+ bars)
- Restart router: Off for 30 seconds, then on
- Try on different WiFi if available
- Close other apps using internet
Solution C: Questions Disappear Mid-Exam
If questions blank out while taking exam:
- Don't panic - Don't restart app immediately
- Check internet - Is WiFi still connected?
- Reconnect internet if disconnected
- Wait 5 seconds - Questions may reload
- If still blank: Restart app and re-enter
- All answers should still be saved
Video Reference: "Online Exam Questions Guide"โ
PART 3: OFFLINE EXAMS ISSUESโ
Issue 3.1: Can't View Offline Exam Resultsโ
Error Codes: E301, E302
Before Contacting Support - Verification Checklistโ
- Exam has been conducted (check timetable)
- Results have been published by teacher
- Your class/section is correct
- Internet connection is stable
- App version is latest
Quick Fixโ
- Go to Dashboard โ Exams โ Offline Exams โ Results
- Pull down to refresh the list
- Check the exam date - Results appear after marking is complete
- If results visible: Tap to view your marks
Advanced Solutionsโ
Solution A: Results Not Showing
- Teacher hasn't marked exams yet
- Marking may take 2-7 days depending on school policy
- Check exam date and ask teacher when results will be published
Solution B: Exam Not in Timetable
- Exam may have been cancelled
- Check with your teacher
- Contact school admin if unsure
Solution C: Results Show But Marks Seem Wrong
- Review the answer key (if provided)
- Check your answers against teacher's answer key
- If you believe there's an error: Message teacher politely with:
- Question number
- Your answer
- Why you think it should be marked differently
Video Reference: "Offline Exam Results Guide"โ
Issue 3.2: Offline Exam Timetable Not Showingโ
Error Codes: E104
Before Contacting Support - Verification Checklistโ
- Offline exams module is enabled (check with admin)
- Your class has exams scheduled
- Device time is correct
- Internet connection is stable
Quick Fixโ
- Go to Dashboard โ Exams
- Look for "Offline Exams" tab
- Tap Timetable to see schedule
- If not visible: Pull down to refresh
Advanced Solutionsโ
Solution A: "Offline Exams" Tab Not Visible
- Module may be disabled by school
- Contact school admin to enable Offline Exams module
- Check Admin Console โ Settings โ Modules
Solution B: Timetable is Empty
- Your school may not have scheduled offline exams
- Contact your class teacher
- Or check with school admin about exam schedule
Solution C: Wrong Class/Section Showing
- Tap class selector at top
- Confirm you're viewing correct class/section
- Different sections may have different exam schedules
Video Reference: "Offline Exam Timetable Guide"โ
PART 4: PAYMENT & BILLING ISSUES (NIGERIAN CONTEXT)โ
Issue 4.1: Payment Failed - Flutterwave Errorโ
Error Codes: E201, E202, E203
Before Contacting Support - Verification Checklistโ
- Card details are correct (name, number, expiry, CVV)
- Card is active and not blocked
- Sufficient funds in account
- Not exceeded daily transaction limit
- Internet connection is stable throughout payment
- Invoice amount is correct (in NGN - Nigerian Naira)
- Payment gateway shows "Online" status
Quick Fix (Most Common - 5 minutes)โ
Step 1: Verify Payment Gateway Status
- Before attempting payment, check: Is Flutterwave online?
- If payment page shows "Gateway unavailable" - wait 5 minutes
- Refresh and try again
Step 2: Retry Payment
- Dashboard โ Fees โ Select invoice
- Click "Pay Now" button
- Select Flutterwave as payment method
- Enter card details carefully:
- Cardholder Name: Exactly as on card
- Card Number: 16 digits
- Expiry: MM/YY format
- CVV: 3 digits on back of card
- Click "Pay"
Step 3: Check Your Bank
- Open your bank app
- Check if money was deducted
- If deducted: See Solution B (Duplicate charge)
- If NOT deducted: Payment genuinely failed, proceed to Solution A
Advanced Solutionsโ
Solution A: "Payment Declined" Error (Card Rejected)
Possible reasons:
- Card blocked: Call your bank and ask why
- Insufficient funds: Check account balance
- Exceeded daily limit: Bank may limit online transfers
- Card expired: Check expiry date (MM/YY on card)
- Fraud detection: Bank blocked suspicious transaction
What to do:
- Call your bank (24/7 hotline):
- GTBank: 0700-2255822
- Access Bank: 0700-6000000
- Zenith Bank: 0800-6000000
- First Bank: 01-279-6161
- UBA: 01-271-6789
- Others: Find on back of your ATM card
- Ask them to approve the 4SCH payment
- Try payment again after 10 minutes
- Use different card if available
- Try bank transfer instead (see Solution C)
Solution B: Money Deducted But Payment Shows "Pending"
This is a CRITICAL issue in Nigeria - requires immediate action:
What this means:
- Money left your account
- But 4SCH system didn't receive confirmation
- Happens due to network interruption during payment
What to do IMMEDIATELY:
- Don't try paying again! You'll be double-charged
- Check your bank account:
- Is money really gone? (Check transaction history)
- If yes, note: transaction ID, amount, date/time
- Contact Flutterwave support:
- Email: support@flutterwave.com
- Phone: +234 (0) 700-933-6000
- Provide: Transaction ID, amount, error screenshot
- Contact 4SCH support with:
- Your full name
- GR Number (if student)
- Invoice number
- Amount paid
- Transaction ID from bank
- Bank transaction date/time
- Screenshots of bank deduction AND pending payment on 4SCH
- 4SCH support will:
- Verify transaction with Flutterwave
- Manually reconcile payment
- Update invoice as paid within 24-48 hours
Timeline:
- Bank deduction: Immediate
- 4SCH verification: 2-4 hours
- Invoice marked paid: 24-48 hours
- Refund (if duplicate): 3-5 business days
Solution C: Use Bank Transfer Instead (Most Reliable)
If Flutterwave continues to fail:
- Go to invoice in 4SCH
- Look for "Bank Transfer" payment method
- Click to view bank details
- Transfer exact amount to school's bank account
- Upload proof of transfer (screenshot of bank confirmation)
- School admin approves, invoice marked paid
Advantages of bank transfer:
- More reliable than card
- No gateway issues
- Instant confirmation in your bank
- School gets funds directly
Solution D: Card Has Daily Limit
Nigerian banks often set daily limits:
- Check your daily limit:
- Contact your bank
- Check in bank mobile app (Account Settings)
- Typical limits: โฆ100,000 - โฆ1,000,000 per day
- Your invoice might exceed limit:
- Example: Invoice is โฆ150,000 but daily limit is โฆ100,000
- You can't pay in single transaction
- Solutions:
- Pay from a different account with higher limit
- Contact bank to increase daily limit (takes 1-2 days)
- Request parent/guardian with higher limit to pay
- Use bank transfer method (different limit)
Solution E: Flutterwave Gateway Timeout
Sometimes payment seems stuck or times out:
- Don't click "Pay" again if page is loading
- Wait 30 seconds for response
- Check your bank - Is money deducted?
- YES: See Solution B (Pending payment)
- NO: Continue below
- Close payment page - Use browser back button
- Go back to invoice - Check if payment went through
- YES: Close and refresh - should show paid
- NO: Wait 5 minutes, then retry
- If retrying: Use same card, system will detect duplicate
Diagnostic Flowchartโ
START: Payment failed?
โ
โโโ Error message shown?
โ โโโ "Payment Declined": โ Solution A (Call bank)
โ โโโ "Timeout": โ Solution E (Wait & retry)
โ โโโ "Pending": โ Solution B (Critical - contact support)
โ
โโโ Check bank account
โ โโโ Money deducted: โ Solution B (Verify with support)
โ โโโ Money still there: Continue
โ
โโโ Card details correct?
โ โโโ NO: Fix details and retry
โ โโโ YES: Continue
โ
โโโ Sufficient funds?
โ โโโ NO: Add money, then retry
โ โโโ YES: Continue
โ
โโโ Try different payment method
โ โโโ Bank Transfer: โ Solution C
โ โโโ Still cards: โ Solution A (Call bank)
โ
โโโ Still failing? Contact support with:
- Invoice number
- Amount
- Error message
- Bank transaction ID (if money deducted)
Video Reference: "Payment Processing Guide" (Nigerian Focus)
Issue 4.2: Missing Payment Receiptโ
Error Codes: E204 (if currency wrong)
Before Contacting Support - Verification Checklistโ
- Payment status shows "Paid" or "Completed"
- Invoice is marked as paid in 4SCH
- Invoice amount matches what you paid
- Payment was made within last 60 days
- Internet connection is stable
Quick Fixโ
- Go to Dashboard โ Fees โ Invoices
- Find the paid invoice
- Tap on invoice โ Look for "Download Receipt" button
- If visible: Tap to download PDF receipt
- Save/print receipt for your records
Advanced Solutionsโ
Solution A: Invoice Still Shows "Unpaid"
- Payment may still be processing (takes 2-24 hours)
- Check bank account: Is money really deducted?
- If deducted: See Issue 4.1 Solution B (Pending payment)
- If not deducted: Payment was declined, see Issue 4.1 Solution A
Solution B: Receipt Button Not Showing
- Payment may not have completed
- Wait 24 hours for reconciliation
- Then try downloading again
- If still not showing: Contact school admin
Solution C: Receipt Shows Wrong Amount
- Amount should match your payment
- If different: Contact 4SCH support with:
- Invoice number
- Amount paid (from bank)
- Receipt amount shown
- Bank transaction ID
Solution D: Need Receipt for Old Payment (>60 days)
- Go to Dashboard โ Fees โ Invoices
- Look for "Transaction History" or "Paid Invoices"
- Tap paid invoice from the date you need
- Download receipt
- If invoice not visible: Contact school admin for historical receipt
Video Reference: "Receipt Download Guide"โ
Issue 4.3: Multiple Invoices / Fee Structure Confusionโ
Nigerian School Context: Common fee structures include
- Tuition fees (per term)
- Registration/admission fee (annual or per session)
- Exam fees
- Transportation fees (optional)
- Uniform/books fees
- Activity/project fees
- School development levy
Before Contacting Support - Verification Checklistโ
- Reviewed all invoices on Fees dashboard
- Understand your school's fee structure
- Checked which invoices are "Pending" vs "Paid"
- Know your session/term/class details
Quick Fixโ
- Go to Dashboard โ Fees
- Review all invoices shown:
- Pending (red) = You must pay this
- Paid (green) = Already paid
- Overdue (orange) = Past deadline
- Check fee names - What do they cover?
- Contact teacher or school office to understand each fee
- Pay only invoices marked "Pending"
Advanced Solutionsโ
Solution A: Unsure Which Fees to Pay
- Go to Fees โ Download Fee Structure (if available)
- Or ask your class teacher
- Or call school office
- School should provide:
- List of all required fees
- When each is due
- Whether fees are compulsory or optional
Solution B: Fee Amount Seems Wrong
- Check fee structure document from school
- Compare with invoice:
- Should match exactly
- Common reasons for difference:
- Different classes have different fees
- Discounts applied (siblings, merit, etc.)
- You might be on a different fee scheme
- If still wrong: Contact school admin with:
- Your GR Number
- Invoice amount
- Amount you expected
- Fee structure from school
Solution C: Same Fee Showing Multiple Times
- Might be for different terms (Term 1, Term 2, Term 3)
- Or different sessions (Session 2024-2025, etc.)
- Check invoice descriptions
- Pay each one separately
- Each term may have its own invoice
Video Reference: "Fee Structure Explained"โ
PART 5: TRANSPORTATION ISSUESโ
Issue 5.1: Can't Enroll in Transportation Routeโ
Error Codes: E401
Before Contacting Support - Verification Checklistโ
- Transportation module is enabled at school
- Enrollment deadline hasn't passed
- Your class has available routes
- Internet connection is stable
- App version is latest
Quick Fixโ
- Go to Dashboard โ Transportation โ Available Routes
- Select a route that's available
- Tap "Enroll" button
- Follow enrollment steps
- Payment required: Go to Fees to pay transportation invoice
- After payment confirmed, enrollment is active
Advanced Solutionsโ
Solution A: No Routes Available
- Your school may not offer transportation
- Or all routes are full
- Contact school transport coordinator:
- Ask about available routes
- Ask about waitlist options
- Provide your location/pickup point preference
Solution B: "Cannot Enroll" Error
- Possible reasons:
- Route is full
- Enrollment deadline passed
- You're already enrolled in a route
- Check timetable for enrollment deadline
- Contact transport coordinator
Solution C: Transportation Fee Not Showing
- Enroll in route first
- Fee invoice appears within 1 hour
- Go to Dashboard โ Fees
- Look for "Transportation" invoice
- If not appearing after 1 hour: Contact admin
Solution D: Already Enrolled But Route Not Showing
- Go to Dashboard โ Transportation โ My Routes
- Should show your enrolled route
- If blank: Refresh the page
- If still not showing: Contact transport coordinator
Video Reference: "Transportation Enrollment Guide"โ
Issue 5.2: Can't See Live Route Tracking / GPS Offlineโ
Error Codes: E402
Before Contacting Support - Verification Checklistโ
- You're enrolled in a transportation route
- Route is active (check timetable)
- Internet connection is stable
- GPS/Location permission enabled for app
- App version is latest
- Device has location services enabled
Quick Fixโ
- Go to Dashboard โ Transportation โ Live Tracking
- You should see:
- Driver's location (blue dot)
- Vehicle movement (updates every 30 seconds)
- Your pickup point
- Estimated arrival time
- If not showing:
- Check internet connection (WiFi or 4G)
- Refresh the page
- Restart app
Advanced Solutionsโ
Solution A: GPS Showing "Offline"
- Driver has no internet/GPS connection
- Common in remote areas or areas with poor signal
- This is normal during travel in areas without 4G
- Vehicle will reconnect when signal returns
- You should still see last known location
Solution B: Location Permission Not Granted
- Android: Settings โ Apps โ 4SCH โ Permissions โ Location โ Allow
- iOS: Settings โ Privacy โ Location Services โ 4SCH โ Allow While Using App
- Restart app after granting permission
- Try tracking again
Solution C: Route Not Starting
- Route may not have started yet
- Check your pickup time in route details
- Driver starts route 30 minutes before first pickup
- Come to pickup point 5-10 minutes early
Solution D: Vehicle Location Not Updating
- Poor internet connection
- Move to area with better signal
- Close other apps using internet
- Restart app
- Try tracking again in 5 minutes
Video Reference: "Live Route Tracking Guide"โ
Issue 5.3: Transportation Payment Issuesโ
Error Codes: E201, E202 (same as general payment issues)
Before Contacting Support - Verification Checklistโ
- You're enrolled in transportation route
- Transportation invoice appeared in Fees
- Amount matches what school quoted
- Internet connection is stable during payment
- Payment method (card/bank transfer) is available
Quick Fixโ
- Go to Dashboard โ Fees
- Find "Transportation" invoice
- Tap "Pay Now"
- Choose payment method:
- Flutterwave (card payment) - See Issue 4.1 solutions
- Bank Transfer - Transfer to school's bank account
- Complete payment
- Invoice shows "Paid" after 2-24 hours
Advanced Solutionsโ
Solution A: Transportation Invoice Not Showing
- May take 1-2 hours after enrollment
- Refresh Fees page
- Close and reopen app
- If still not showing after 4 hours: Contact school admin
Solution B: Invoice Amount Wrong
- Check route details for quoted price
- Compare with invoice amount
- If different: Contact transport coordinator
- Possible reasons:
- Different routes have different prices
- Discounts applied (multiple vehicles, siblings, etc.)
- You might be on different pricing scheme
Solution C: Payment Declined (See Issue 4.1)
- Same solutions as general payment issues
- Call your bank if card declined
- Try bank transfer instead
Solution D: "Route Cancelled" After Payment
- Rare: School might cancel route
- Check if route still exists in available routes
- If cancelled: School should refund
- Contact transport coordinator immediately
Video Reference: "Transportation Payment Guide"โ
PART 6: GALLERY ISSUESโ
Issue 6.1: Can't Upload Photos to Galleryโ
Error Codes: E501
Before Contacting Support - Verification Checklistโ
- You have permission to upload (ask your teacher)
- Internet connection is stable (WiFi preferred)
- Photo file size is less than 10MB
- Photo format is JPEG, PNG, or supported format
- Device storage has at least 100MB free
- App version is latest
Quick Fix (Most Common - 3 minutes)โ
- Go to Dashboard โ Gallery
- Tap "Upload Photo" or "Add Image" button
- Select photo from phone:
- Take new photo, OR
- Choose from existing photos
- Wait for upload to complete (3-30 seconds depending on file size)
- Photo appears in gallery
Advanced Solutionsโ
Solution A: "File Too Large" Error
- Photo must be less than 10MB
- Example sizes:
- Modern phone photo: Usually 3-5MB (OK)
- Old camera photo: Might be 15-20MB (too large)
What to do:
- Use free compression app:
- Android: "Image Compressor" app
- iOS: Use built-in Photos app โ Edit โ Compress
- Or take new photo with phone camera (usually optimized)
- Try uploading again
Solution B: "Unsupported File Format" Error
- Only these formats allowed: JPEG, PNG, GIF, WebP
- NOT allowed: BMP, TIFF, RAW
- Check file extension (last 3-4 characters):
- โ .jpg or .jpeg = OK
- โ .png = OK
- โ .gif = OK
- โ .bmp = NOT OK
- โ .tiff = NOT OK
What to do:
- Open photo in phone's gallery
- Export/Save as JPEG or PNG
- Try uploading again
Solution C: Upload Stuck / "Pending"
- Upload may be taking too long (slow internet)
- Don't close app or turn off phone
- Wait up to 5 minutes
- If still pending:
- Close app completely
- Check WiFi connection
- Restart app
- Try again with smaller file
Solution D: "Permission Denied" Error
- You may not have permission to upload
- School may have restricted uploads
- Ask your class teacher for permission
- Teacher can enable uploads in Gallery settings
Video Reference: "Gallery Upload Guide"โ
Issue 6.2: Gallery Images Not Loading / Showing Blankโ
Error Codes: E502
Before Contacting Support - Verification Checklistโ
- Internet connection is stable
- App version is latest
- Device has at least 500MB free storage
- Not using restricted WiFi (school/public WiFi might block images)
Quick Fixโ
- Go to Dashboard โ Gallery
- Pull down to refresh the gallery
- Wait 5 seconds for images to load
- If blank:
- Close app completely
- Restart app
- Go back to Gallery
- Images should appear
Advanced Solutionsโ
Solution A: Images Load Very Slowly
- Slow internet connection
- Switch to WiFi if on 4G
- Move closer to WiFi router
- Wait up to 30 seconds for all images to load
- Close other apps using internet
Solution B: Some Images Missing / Deleted
- Admin or teacher may have deleted images
- Check if there's a "Deleted" or "Archived" folder
- Ask teacher what happened
- If you uploaded it: Ask teacher to restore
Solution C: Gallery is Empty
- No photos have been uploaded yet
- Wait for photos to be uploaded by school
- Or upload your own if permission granted
- Check different galleries (class, school, event, etc.)
Solution D: Images Showing "Failed to Load"
- Internet disconnected while loading
- Reconnect to WiFi/4G
- Refresh gallery page
- Try again
Solution E: Cache Issues (Storage)
- Clear app cache (doesn't delete your photos):
- Android: Settings โ Apps โ 4SCH โ Storage โ Clear Cache
- iOS: Settings โ General โ iPhone Storage โ 4SCH โ Offload App (then reinstall)
- Restart app
- Go back to Gallery
- Images should reload
Video Reference: "Gallery Viewing Guide"โ
PART 7: DASHBOARD & GENERAL ISSUESโ
Issue 7.1: Dashboard Not Loading / Blank Screenโ
Error Codes: E601
Before Contacting Support - Verification Checklistโ
- Internet connection is stable (WiFi or 4G)
- Device time is correct
- App version is latest
- Device storage has at least 500MB free
- Not behind restricted WiFi (public/school WiFi)
- No VPN or proxy enabled
Quick Fix (Most Common - 2 minutes)โ
- Check internet connection:
- WiFi: See WiFi icon connected
- 4G: See signal bars (3+ bars)
- Try pulling down to refresh dashboard
- If still blank: Close app completely
- Restart app:
- Android: Swipe from recent apps
- iOS: Swipe up from bottom
- Wait 10 seconds for app to launch
- Dashboard should load
Advanced Solutionsโ
Solution A: "No Internet Connection" Message
- Check WiFi connection:
- Android: Settings โ WiFi โ Turn ON
- iOS: Settings โ WiFi โ Turn ON
- Or check mobile data:
- Android: Settings โ SIM & Internet โ Mobile Data ON
- iOS: Settings โ Cellular โ Cellular Data ON
- Open any website to verify internet works
- Restart app
Solution B: Dashboard Loads But Data Is Old
- App cache might be showing old data
- Pull down to refresh to get latest data
- If still old:
- Close app
- Android: Settings โ Apps โ 4SCH โ Storage โ Clear Cache
- iOS: Offload app (Settings โ General โ iPhone Storage)
- Restart app
- Log in again
Solution C: Dashboard Loads Partially
- Some items load, some blank
- Indicates slow/unstable internet
- Try on better WiFi connection
- Or close other apps using internet
- Wait 10 seconds for all items to load
Solution D: Keeps Crashing When Opening
- App may be corrupted
- Uninstall and reinstall app:
- Android: Settings โ Apps โ 4SCH โ Uninstall
- iOS: Touch and hold app โ Remove App โ Delete App
- Wait 30 seconds
- Go to app store
- Search "4SCH"
- Reinstall
- Log in again
- All your data is on servers, not lost
Video Reference: "Dashboard Guide"โ
Issue 7.2: Can't See All Modules (Exams, Fees, Transportation, etc.)โ
Error Codes: Not applicable (permissions issue)
Before Contacting Support - Verification Checklistโ
- School admin has enabled modules
- Your role has permission to access module
- App version is latest
- Internet connection is stable
Quick Fixโ
- Go to Dashboard
- You should see menus like:
- Assignments
- Exams
- Fees
- Transportation
- Gallery
- Reports
- etc.
- If some are missing: See Solution A
Advanced Solutionsโ
Solution A: Module Completely Missing from Menu
- Module might be disabled by school
- OR your role doesn't have permission
What to do:
- Ask your school admin to:
- Check if module is enabled: Admin Console โ Settings โ Modules
- Check if your role has permission: Settings โ Roles & Permissions
- Example:
- Exams module disabled = "Exams" won't show
- Fees module disabled = "Fees" won't show
- Transportation disabled = "Transportation" won't show
Solution B: Module Shows But Empty/No Data
- Module enabled but no data for you
- Examples:
- "Exams" shows but no exams assigned
- "Fees" shows but no invoices
- "Transportation" shows but no routes
What to do:
- This is normal - module is enabled but you have no content
- Wait for teacher/admin to create content
- Then module will show your data
- Example: Wait for teacher to create exam, then it appears
Solution C: Want Module Enabled
- Ask school admin to enable module
- Or ask if it's been disabled temporarily
- Some schools disable during off-season (exam vacation, etc.)
Video Reference: "Dashboard Modules Guide"โ
PART 8: NETWORK & CONNECTIVITY ISSUESโ
Issue 8.1: App Keeps Disconnecting / "No Internet" Errorsโ
Before Contacting Support - Verification Checklistโ
- WiFi/Mobile data connection is active
- Signal strength is adequate (3+ bars for mobile, 3+ WiFi bars)
- Not using VPN or proxy
- Not in Airplane mode
- Not in low power mode (can affect connectivity)
- Device time is correct
Quick Fixโ
- Check WiFi/Mobile data:
- Android: Settings โ SIM & Internet
- iOS: Settings โ WiFi or Cellular
- If WiFi: Reconnect:
- Forget network
- Rejoin with password
- If Mobile data:
- Turn off, wait 10 seconds
- Turn back on
- Restart phone (not just app)
- Restart app
Advanced Solutionsโ
Solution A: WiFi Keeps Disconnecting
- Move closer to WiFi router (minimum 5 meters)
- Remove obstacles between phone and router:
- Metal objects
- Walls (especially concrete)
- Other devices
- Restart WiFi router:
- Turn off for 30 seconds
- Turn back on
- Wait 1 minute for full restart
- Reduce WiFi interference:
- Turn off other WiFi devices
- Move away from microwave (interferes with 2.4GHz)
- Update router firmware (if possible)
Solution B: Mobile Data Keeps Dropping
- Check signal strength:
- Android: Settings โ SIM & Internet โ Signal bars
- iOS: Look at signal dots (top left)
- Need at least 3 bars/dots
- Move to location with better signal:
- Go to window
- Go outside building
- Move to higher floor
- Disable and re-enable mobile data:
- Turn off for 10 seconds
- Turn back on
- Try 4G/LTE instead of 3G (faster, less disconnection)
- Contact your mobile provider if consistently poor signal
Solution C: Both WiFi and Mobile Data Unreliable
- Check device time: Must be correct (NTP sync)
- Disable VPN if enabled
- Check airplane mode: Must be OFF
- Restart phone completely (power off, 30 seconds, power on)
- Check router/network: Try on different WiFi or ask other users if their connection works
Solution D: Works on WiFi but Not on Mobile Data
- May be network provider issue
- Or network firewall blocking 4SCH
- Solutions:
- Use WiFi when available
- Contact mobile provider about firewall
- Try different mobile provider (if available)
- Use WiFi hotspot from other device
Video Reference: "Internet Connectivity Guide"โ
Issue 8.2: Slow Internet / App Very Slowโ
Before Contacting Support - Verification Checklistโ
- Internet connection is active
- Other apps/devices not consuming bandwidth
- Not using VPN
- Not running background updates
Quick Fixโ
- Check internet speed:
- Open speedtest.net on browser
- Test speed (takes 30 seconds)
- Minimum needed: 0.5 Mbps
- Recommended: 1+ Mbps
- If less than 0.5 Mbps: Connection too slow
- See Solution A below
- If 0.5+ Mbps: App should work OK
- Close other apps
- Restart 4SCH app
Advanced Solutionsโ
Solution A: Internet Speed Less Than 0.5 Mbps
- Connection is too slow for app
- Options:
- Move closer to WiFi router
- Switch to different WiFi network
- Use mobile data instead (if faster)
- Contact internet provider (WiFi issue)
- Contact mobile provider (mobile data issue)
Solution B: Speed OK But App Still Slow
- Close background apps:
- Android: Recent apps โ Swipe to close others
- iOS: Swipe up from bottom
- Clear app cache:
- Android: Settings โ Apps โ 4SCH โ Storage โ Clear Cache
- iOS: Offload app then reinstall
- Restart phone
- Disable auto-sync for other apps:
- Android: Settings โ Accounts โ Disable sync for Google Drive, Photos, etc.
- iOS: Settings โ iTunes & App Store โ Auto-Downloads OFF
Solution C: Slow on Mobile Data But Fast on WiFi
- Mobile data congestion (network too busy)
- Try during off-peak hours:
- Early morning: 5-8 AM
- Late evening: 11 PM - 6 AM
- Avoid peak: 12 PM - 4 PM, 6 PM - 10 PM
- Or use WiFi when available
Video Reference: "Speed Troubleshooting Guide"โ
PART 9: ROLE-SPECIFIC TROUBLESHOOTINGโ
For Studentsโ
Most Common Issues:
- Can't log in โ Issue 1.1
- Online exam problems โ Issues 2.1-2.4
- Offline exam results โ Issue 3.1
- Viewing grades/assignments โ Use Dashboard
- Network issues โ Issue 8.1
Student Workflow:
Login โ Dashboard โ
โโ Assignments (submit, view grades)
โโ Exams (take online exams, view results)
โโ Fees (view invoices, pay fees)
โโ Transportation (enroll, track vehicle)
โโ Gallery (view photos)
Key Reminders:
- Always use current device time (auto-sync ON)
- Start exams 10 minutes early
- Save work frequently
- Don't close app during exams
- Check internet before starting exam
For Parentsโ
Most Common Issues:
- Can't log in โ Issue 1.3
- Payment issues โ Issues 4.1-4.3
- View child's grades โ Dashboard โ Select child
- Transportation tracking โ Issue 5.2
- Receive notifications โ Check Notification Settings
Parent Workflow:
Login โ Dashboard โ
โโ Select Child (if multiple)
โโ View Assignments & Grades
โโ View Exams & Results
โโ Fees โ Pay invoices
โโ Transportation โ Enroll, track
โโ Gallery โ View class photos
Payment Tips:
- Keep bank contact numbers saved:
- GTBank: 0700-2255822
- Access Bank: 0700-6000000
- Take screenshots of payment confirmations
- Keep transaction IDs for reference
- Check bank account daily after payment
For Teachersโ
Most Common Issues:
- Can't log in โ Issue 1.3 (use email-based reset)
- Create/manage exams โ See online-exams guide
- Create assignments โ See assignments guide
- Mark attendance โ See attendance guide
- View reports โ See admin-dashboard-analytics guide
Teacher Workflow:
Login โ Dashboard โ
โโ Assignments (create, grade, provide feedback)
โโ Exams (create, add questions, publish results)
โโ Attendance (mark daily)
โโ Gradebook (enter marks, publish results)
โโ Reports (view student performance)
โโ Messaging (communicate with parents/students)
Key Reminders:
- Publish results before students see them
- Set exam time windows correctly
- Create enough questions for random assignment
- Mark attendance before deadline window closes
For School Adminโ
Most Common Issues:
- Can't log in โ Issue 1.3 (use email-based reset)
- Module not showing for users โ Issue 7.2
- User can't access course โ Check Roles & Permissions
- Payment gateway issues โ Contact Flutterwave support
- Data import errors โ See data-import-export guide
Admin Workflow:
Admin Console โ
โโ Settings (Configure modules, payment gateway, etc.)
โโ Users (Create, manage, reset passwords)
โโ Academic Setup (Classes, subjects, timetable)
โโ Roles & Permissions (Control access)
โโ Data Import (Bulk student/staff import)
โโ Reports (System analytics)
โโ Logs (Audit trail)
PART 10: BEFORE CONTACTING SUPPORT - MASTER CHECKLISTโ
For All Usersโ
Before you contact support, try these:
- Restart your device (power off, wait 30 seconds, power on)
- Restart the app (completely close, wait 10 seconds, reopen)
- Check internet connection (WiFi or mobile data active with signal)
- Clear app cache (not lose your data, just clears temporary files)
- Update app to latest version (check app store)
- Check error code against Error Codes Reference Table
- Try the Quick Fix for your specific issue
- Use the Diagnostic Flowchart provided for your issue
- Search FAQ for similar issues already answered
What Information to Provide to Supportโ
When contacting support, have this information ready:
Your Information:
- Your full name
- Your email address
- Your phone number
- Your School Code
- GR Number (if student)
- Device type (iPhone/Android) and model
- App version number
Issue Details:
- Error code (if shown)
- Error message (exact text or screenshot)
- When did this start? (date/time)
- What were you trying to do?
- What did you expect to happen?
- What actually happened?
- Screenshots of the error (very helpful)
- Steps to reproduce the issue
For Payment Issues (Critical):
- Invoice number
- Amount
- Payment method used
- Bank transaction ID
- Date/time of payment attempt
- Screenshots of:
- The error message
- Your bank deduction confirmation
- 4SCH payment status page
For Exam Issues:
- Exam name
- Exam date/time scheduled
- Your device time (screenshot of clock)
- Internet speed (from speedtest.net)
- Steps you took before error
- Screenshots of error message
Support Contact Informationโ
Email: support@4sch.com Phone: +234 (0) 700-933-6000 Website: 4sch.com Response time: Usually within 2-4 hours during business hours (Mon-Fri, 9 AM - 5 PM WAT)
What NOT to Doโ
- โ Don't try payment again if you got "pending" error (will be double-charged)
- โ Don't share your password with anyone, including support staff
- โ Don't click suspicious links claiming to reset your account
- โ Don't try to bypass school security features
- โ Don't delete app data while issue is ongoing (may lose evidence)
- โ Don't attempt exams on very slow internet (<0.5 Mbps)
- โ Don't ignore "Pending" payment status (takes action to resolve)
PART 11: QUICK REFERENCE BY MODULEโ
Online Exams:
- Can't access โ Issue 2.1
- Timer problems โ Issue 2.2
- Answers not submitting โ Issue 2.3
- Questions not loading โ Issue 2.4
Offline Exams:
- Results not showing โ Issue 3.1
- Timetable not showing โ Issue 3.2
Billing/Payments:
- Flutterwave failed โ Issue 4.1
- Missing receipt โ Issue 4.2
- Fee confusion โ Issue 4.3
Transportation:
- Can't enroll โ Issue 5.1
- GPS offline โ Issue 5.2
- Payment issues โ Issue 5.3
Gallery:
- Can't upload โ Issue 6.1
- Images not loading โ Issue 6.2
Dashboard:
- Not loading โ Issue 7.1
- Modules missing โ Issue 7.2
Network:
- Disconnecting โ Issue 8.1
- Slow speed โ Issue 8.2
PART 12: FREQUENTLY ENCOUNTERED ISSUES (26 Common Problems)โ
Authentication (5 issues)โ
- Forgot password โ Issue 1.2
- Wrong School Code format โ Issue 1.1 Solution B
- GR Number not matching โ Issue 1.2 Solution B
- Date of birth format wrong (dd/mm vs dd-mm) โ Issue 1.2
- Account locked after too many attempts โ Issue 1.1 Solution D
Online Exams (7 issues)โ
- Can't see exam in list โ Issue 2.1 Solution D
- "Exam not yet available" โ Issue 2.1 Solution A
- "Exam time expired" โ Issue 2.1 Solution B
- Timer shows wrong time โ Issue 2.2 Solution A
- "Network timeout" during exam โ Issue 2.3 Solution B
- Answer won't submit โ Issue 2.3 Solutions A-C
- "Not enough questions" error โ Issue 2.4 Solution A
Offline Exams (2 issues)โ
- Results not showing after exam โ Issue 3.1 Solution A
- Exam timetable completely empty โ Issue 3.2 Solution B
Payments (5 issues)โ
- "Payment Declined" - card rejected โ Issue 4.1 Solution A
- Money deducted but shows "Pending" โ Issue 4.1 Solution B (CRITICAL)
- Flutterwave timeout โ Issue 4.1 Solution E
- Daily card limit exceeded โ Issue 4.1 Solution D
- Can't see receipt after paying โ Issue 4.2 Solution A
Transportation (3 issues)โ
- GPS showing "Offline" โ Issue 5.2 Solution A
- "Cannot Enroll" error โ Issue 5.1 Solution B
- Transportation invoice not appearing โ Issue 5.3 Solution A
Gallery (2 issues)โ
- File too large to upload โ Issue 6.1 Solution A
- Images not loading in gallery โ Issue 6.2 Solution A
General (2 issues)โ
- Dashboard completely blank โ Issue 7.1 Solution A
- Module missing from menu โ Issue 7.2 Solution A
ADDITIONAL RESOURCESโ
Video Tutorials: See video tutorials section for step-by-step guides FAQ: Check FAQ for quick answers Contact Support: Contact form
Need more help? Contact support with your error code and the information from the checklist above.