Skip to main content

Authentication Issues

Login Problems

Cause: The email format is invalid.Solution:
  1. Verify your email follows the correct format: [email protected]
  2. Check for:
    • Extra spaces before or after the email
    • Missing @ symbol
    • Invalid domain extension
  3. Valid email regex pattern used by Finanzapp:
    ^[^\s@]+@[^\s@]+\.[^\s@]+$
    
Example valid emails:Example invalid emails:
  • user@example ✗ (missing domain extension)
  • @example.com ✗ (missing username)
  • user @example.com ✗ (contains space)
Cause: The email field is empty.Solution:
  • Enter your registered email address in the email field
  • The field cannot be blank or contain only spaces
  • The form validates input in real-time
All fields marked as required must be filled before submission. Look for the red error styling on empty fields.
Cause: Password doesn’t meet security requirements.Password Requirements:
  • ✓ Minimum 8 characters
  • ✓ At least 1 uppercase letter (A-Z)
  • ✓ At least 1 number (0-9)
Validation Pattern:
^(?=.*[A-Z])(?=.*\d).{8,}$
Valid Examples:
  • MyPass123
  • Secure2024
  • Finance1App
Invalid Examples:
  • password ✗ (no uppercase, no number)
  • Password ✗ (no number)
  • PASS123 ✗ (less than 8 characters)
  • mypass123 ✗ (no uppercase)
The password field shows real-time validation. A red border indicates the password doesn’t meet requirements.
Cause: Credentials don’t match our records.Solutions:
  1. Verify your email address
    • Ensure you’re using the email you registered with
    • Check for typos
  2. Check your password
    • Passwords are case-sensitive
    • Verify Caps Lock is not enabled
    • Try typing it in a text editor first to verify
  3. Reset your password
    • Visit the password reset page
    • Enter your email address
    • Follow the reset link sent to your inbox
  4. Account doesn’t exist
After multiple failed login attempts, your account may be temporarily locked for security (brute force protection).
Cause: Brute force protection activated.What this means:
  • Finanzapp has security measures to prevent unauthorized access
  • Multiple failed login attempts trigger a temporary lock
Solution:
  1. Wait 15-30 minutes before trying again
  2. Use the password reset feature if you’ve forgotten your password
  3. Contact support if the issue persists: [email protected]
Do not repeatedly attempt to login with incorrect credentials as this will extend the lockout period.

Registration Issues

Cause: Password and confirmation password don’t match.Solution:
  1. Retype both password fields carefully
  2. Ensure both fields contain identical text
  3. Check for:
    • Extra spaces
    • Different capitalization
    • Typos in either field
The confirmation password field shows real-time validation with a red border when passwords don’t match.
Cause: Terms and conditions checkbox not checked.Solution:
Registration cannot proceed without accepting the terms and conditions. This is a legal requirement.
Cause: Server-side registration error.Possible reasons:
  • Email already registered
  • reCAPTCHA verification failed
  • Server connection issue
  • Database error
Solutions:
  1. Check if account exists
    • Try logging in with your credentials
    • Use the password reset if you forgot your password
  2. Verify reCAPTCHA
    • Ensure JavaScript is enabled in your browser
    • Check your internet connection
    • Try a different browser
  3. Try again later
    • Server may be temporarily unavailable
    • Clear browser cache and cookies
    • Wait a few minutes and retry
  4. Contact support

Password Reset Issues

Cause: Email delivery issues.Solutions:
  1. Check spam/junk folder
  2. Verify email address
    • Ensure you entered the correct email
    • Use the same email you registered with
  3. Wait a few minutes
    • Email delivery can take 5-10 minutes
    • Don’t request multiple reset links immediately
  4. Check email filters
    • Whitelist @finanzapp.es domain
    • Disable aggressive spam filters temporarily
  5. Try alternative email
    • Some email providers block automated emails
    • Contact support if you need to update your email
The reset link expires after a certain period for security. Request a new link if yours has expired.
Cause: Server couldn’t send reset email.Solutions:
  1. Verify the email address is correct
  2. Check if the account exists with that email
  3. Wait 5 minutes and try again
  4. Contact support: [email protected]
Common causes:
  • Invalid or non-existent email address
  • Email service temporarily unavailable
  • Server configuration issue
Cause: Unexpected server error.Solutions:
  1. Refresh the page and try again
  2. Clear browser cache:
    • Chrome: Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
    • Firefox: Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
  3. Try a different browser
  4. Check internet connection
  5. Wait 10-15 minutes and retry
If the problem persists:

Contact Form Issues

Cause: Privacy policy checkbox not checked.Solution:
  • Read the Privacy Policy
  • Check the privacy policy checkbox before submitting
  • This is required to comply with GDPR
Cause: Contact form rate limiting (cooldown period).What this means:
  • Finanzapp limits contact form submissions to prevent spam
  • After submitting, you must wait 5 minutes before sending another message
  • The countdown shows remaining time
Solution:
  • Wait for the countdown to complete
  • The button will automatically enable when ready
  • If you need urgent assistance, email directly: [email protected]
Technical details (from email.js:27):
// 5 minute cooldown between submissions
if (lastSent && now - parseInt(lastSent) < 5 * 60 * 1000) {
  const remaining = Math.ceil((5 * 60 * 1000 - (now - parseInt(lastSent))) / 1000);
  startCooldown(remaining);
  return;
}
The cooldown is stored in localStorage and persists even if you refresh the page.
Cause: EmailJS integration issue.Solutions:
  1. Check form validation
    • Ensure all required fields are filled:
      • Name
      • Email (valid format)
      • Subject
      • Message
    • Privacy policy checkbox is checked
  2. Verify email address
    • Must be a valid email format
    • Check for typos
  3. Check browser console
    • Press F12 to open Developer Tools
    • Look for JavaScript errors in the Console tab
    • Screenshot any errors and send to support
  4. Alternative contact methods:
If you see “Mensaje enviado correctamente” but don’t receive a confirmation, check your spam folder for the auto-reply with your ticket number (format: TKT-YYMMDDHHMMSS-XXXX).

Browser & Performance Issues

Possible causes:
  • Slow internet connection
  • Browser cache issues
  • Too many browser tabs/extensions
  • Server load
Solutions:
  1. Check internet speed
  2. Clear browser cache
    • Chrome: Settings → Privacy → Clear browsing data
    • Firefox: Options → Privacy → Clear Data
    • Select “Cached images and files”
  3. Disable browser extensions
    • Ad blockers may interfere with reCAPTCHA
    • Try incognito/private mode
  4. Try different browser
    • Chrome (recommended)
    • Firefox
    • Edge
  5. Check server status
Cause: Chart.js loading or data issue.Solutions:
  1. Refresh the page (Ctrl+F5 or Cmd+Shift+R)
  2. Check JavaScript is enabled
    • Charts require JavaScript
    • Browser settings → Enable JavaScript
  3. Verify data exists
    • Charts may be empty if you have no data
    • Add some savings or investment records first
  4. Browser compatibility
    • Use a modern browser (last 2 versions)
    • Update to latest browser version
  5. Check console for errors
    • Press F12
    • Look for Chart.js or canvas errors
Finanzapp uses Chart.js for interactive visualizations. Ensure your browser supports HTML5 Canvas.
Cause: CSS or viewport configuration.Solutions:
  1. Force refresh
    • Mobile: Clear browser cache in app settings
    • Pull down to refresh on most mobile browsers
  2. Rotate device
    • Try both portrait and landscape
    • Some features optimize for landscape
  3. Check zoom level
    • Ensure browser zoom is at 100%
    • Pinch to reset zoom on mobile
  4. Update mobile browser
    • Use latest version of Chrome/Safari/Firefox
    • Built-in browser apps may not be fully supported
  5. Clear app data (mobile)
    • Android: Settings → Apps → Browser → Clear Data
    • iOS: Settings → Safari → Clear History and Data
Finanzapp is fully responsive and optimized for mobile, tablet, and desktop. If issues persist, include your device model and browser version when contacting support.
Cause: Notyf toast library or browser notification permissions.Notification Types:
  • Success messages (green, top-right)
  • Error messages (red, top-right)
  • Duration: 3 seconds
Solutions:
  1. Check browser permissions
    • Allow notifications for finanzapp.es
    • Browser settings → Site permissions → Notifications
  2. Disable ad blockers
    • Some blockers hide toast notifications
    • Whitelist finanzapp.es
  3. Check z-index conflicts
    • Other browser extensions may overlay notifications
    • Try incognito mode
  4. JavaScript errors
    • Open console (F12)
    • Look for Notyf initialization errors
Technical reference (validationUtils.js:1-16):
const notyf = new Notyf({
  duration: 3000,
  position: { x: 'right', y: 'top' },
  types: [
    { type: 'error', background: '#ff4444' },
    { type: 'success', background: '#00C851' }
  ]
});

Data & Export Issues

Cause: Export function error or no data available.Solutions:
  1. Verify data exists
    • Check you have records to export
    • Empty accounts have nothing to export
  2. Check export format
    • CSV: Works in all browsers
    • PDF: May require popup permission
    • Excel: Check browser download settings
  3. Browser permissions
    • Allow downloads for finanzapp.es
    • Check popup blocker settings
  4. Download folder
    • Verify browser download location
    • Check available disk space
  5. Try different format
    • If PDF fails, try CSV
    • CSV is the most reliable format
Cause: Automated categorization algorithm limitation.What you can do:
  1. Manual recategorization
    • Edit the transaction
    • Select correct category from dropdown
    • Save changes
  2. Improve future categorization
    • Add keywords or rules (if feature available)
    • Provide feedback to improve algorithm
  3. Report patterns
Smart categorization learns from patterns but may require manual adjustment initially.
Cause: API connection or rate limit issue.Solutions:
  1. Refresh the page
    • Prices should update automatically
    • Manual refresh forces update
  2. Check internet connection
    • Real-time prices require active connection
    • Reconnect if connection dropped
  3. API rate limits
    • Too many requests may temporarily limit updates
    • Wait a few minutes and refresh
  4. Verify API status
    • Third-party crypto APIs may have downtime
    • Check if other sites show same delay
Cryptocurrency prices are provided by third-party APIs. Delays or outages may occur during high volatility or API maintenance.

Security Concerns

What to do:For frontend/visual issues:
  1. Open an issue on GitHub
  2. Use the bug report template
  3. Provide detailed reproduction steps
For backend/API security issues:
  1. DO NOT publicly disclose the vulnerability
  2. Email immediately: [email protected]
  3. Include:
    • Detailed description
    • Reproduction steps
    • Potential impact
    • Your contact information (optional)
Responsible disclosure is appreciated. Please allow the team time to fix critical issues before public disclosure.
If you notice:
  • Unauthorized logins
  • Unexpected transactions
  • Changed account settings
  • Suspicious emails claiming to be Finanzapp
Immediate actions:
  1. Change password immediately
  2. Contact security team
  3. Review account activity
    • Check transaction history
    • Verify personal information unchanged
  4. Enable additional security
    • Use a password manager
    • Don’t reuse passwords
Finanzapp will NEVER ask for your password via email. Any such request is a phishing attempt.

Still Need Help?

View FAQ

Common questions about features and functionality

Contact Support

Get personalized help from the team

GitHub Issues

Report bugs and request features

Email Support

Direct email support

Error Code Reference

Quick reference for common error messages:
Error MessageCauseSolution
El campo email es obligatorioEmpty email fieldEnter your email address
Introduce un email válidoInvalid email formatUse format: [email protected]
El campo contraseña es obligatorioEmpty password fieldEnter your password
La contraseña debe tener...Weak passwordUse 8+ chars, 1 uppercase, 1 number
Las contraseñas no coincidenPassword mismatchRetype both password fields
Email o contraseña incorrectasWrong credentialsVerify email/password or reset
Debe aceptar los términosUnchecked terms boxCheck the terms checkbox
Debe aceptar la política de privacidadUnchecked privacy boxCheck the privacy checkbox
Registro fallidoServer-side errorTry again or contact support
No se pudo enviar el correoEmail delivery failedVerify email or contact support
Error inesperadoUnexpected errorRefresh page or try later
Espera XsRate limit cooldownWait for countdown to finish
Error messages are displayed as toast notifications in the top-right corner. They appear in red for errors and green for success messages.

Build docs developers (and LLMs) love