Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Ballwictb/Finanzapp/llms.txt

Use this file to discover all available pages before exploring further.

​
Getting Started with Finanzapp

Finanzapp offers multiple ways to access your account securely. You can create a traditional account with email and password, or use Google OAuth for quick access.

​
Registration

Create your Finanzapp account to start managing your finances.
1

Navigate to the Registration Page

Click the Register button in the header or visit the registration page directly.
2

Choose Your Registration Method

You have two options:

​
Option 1: Sign up with Google

Click the Sign up with Google button at the top of the form. You’ll be redirected to Google’s authentication page to authorize Finanzapp.
When you register with Google, your profile information is automatically populated, and you can start using Finanzapp immediately.

​
Option 2: Register with Email

Fill out the registration form with the following fields:
  • Full Name: Enter your complete name
  • Email: Provide a valid email address
  • Password: Must meet security requirements
  • Confirm Password: Re-enter your password
Password Requirements: Your password must have at least 8 characters, include one uppercase letter, and contain at least one number. This is validated by the system in registerValidation.js:56-58.
3

Accept Terms and Conditions

Check the Terms and Conditions checkbox. This is required to create an account.Optionally, you can also check the box to receive notifications about new features and updates.
4

Submit the Form

Click the Register button to create your account.The form is validated both on the client side (app/register.php:122-160) and server side before account creation.

​
Registration Validation

Finanzapp validates your registration data in real-time:
The system checks if your email follows the correct format using a regular expression pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/ (defined in validationUtils.js:19-22).Error Message: “Introduce un email válido”
Passwords are validated using the pattern: /^(?=.*[A-Z])(?=.*\d).{8,}$/ (defined in validationUtils.js:25-28).This ensures:
  • Minimum 8 characters
  • At least one uppercase letter
  • At least one number
Error Message: “La contraseña debe tener al menos 8 caracteres, una mayúscula y un número”
The system verifies that both password fields match exactly (registerValidation.js:61-64).Error Message: “Las contraseñas no coinciden”
You must accept the terms and conditions to proceed (registerValidation.js:40-43).Error Message: “Debe aceptar los términos y condiciones”

​
What Happens After Registration

Once your registration is successful:
  1. Your account is created in the database
  2. You’ll see a success notification: “Registro exitoso”
  3. You’re automatically logged into your account
  4. You’re redirected to the dashboard to start using Finanzapp

​
Login

Access your existing Finanzapp account.
1

Navigate to the Login Page

Click the Login button in the header or go directly to the login page.
2

Choose Your Login Method

​
Option 1: Sign in with Google

If you registered with Google, click the Sign in with Google button. You’ll be authenticated through Google’s secure OAuth flow.
Google authentication is handled by app/login.php:179-198 and processes your credentials through Google’s API.

​
Option 2: Login with Email and Password

Enter your credentials:
  • Email: The email address you used during registration
  • Password: Your account password
3

Complete reCAPTCHA Verification

For security purposes, complete the reCAPTCHA challenge displayed on the form (app/login.php:134).
4

Submit the Form

Click the Login button to access your account.

​
Login Validation

The login form validates your credentials:
  • Email validation: Checks for proper email format (loginValidation.js:38-44)
  • Password validation: Ensures the password meets requirements (loginValidation.js:46-52)
Common Error Messages:
  • “El campo email es obligatorio” - Email field is required
  • “Introduce un email válido” - Invalid email format
  • “El campo contraseña es obligatorio” - Password field is required
  • “Email o contraseña incorrectas” - Invalid credentials

​
Successful Login

After successful authentication:
  1. You’ll see a success notification: “Inicio de sesión exitoso” (loginValidation.js:67)
  2. Your session is established
  3. You’re redirected to your personalized dashboard
Forgot Password? If you can’t remember your password, click the “Forgot Password” link on the login page to reset it.

​
Password Reset

If you’ve forgotten your password, Finanzapp makes it easy to reset it securely.
1

Request Password Reset

On the login page, click the “Forgot Password” link (app/login.php:143-146).You’ll be taken to the password reset request page.
2

Enter Your Email

Provide the email address associated with your Finanzapp account.The system validates that:
  • The email field is not empty
  • The email format is valid (resetValidation.js:33-39)
3

Submit the Request

Click the Submit button to request a password reset email.The form sends your request to sendResetLink.php (resetValidation.js:45).
4

Check Your Email

You’ll receive a confirmation message: “Correo de restablecimiento enviado” (resetValidation.js:54).Check your email inbox for a password reset link. This link contains a unique token to verify your identity.
5

Click the Reset Link

Open the email from Finanzapp and click the password reset link. This will take you to the password change page with your reset token.
6

Set Your New Password

On the password reset page (app/resetPassword.php), enter:
  • New Password: Your new password (must meet security requirements)
  • Confirm Password: Re-enter your new password
The token from the email is automatically included in the form (resetPassword.php:48).
7

Submit New Password

Click the Submit button to change your password.The system validates:
  • Password is not empty (passwordChange.js:28-34)
  • Password meets requirements (8+ characters, uppercase letter, number)
  • Both password fields match (passwordChange.js:39-42)

​
Password Reset Validation

When requesting a reset:
  • Email must be in valid format
  • Email must exist in the system
Success Message: “Correo de restablecimiento enviado”Error Message: “No se pudo enviar el correo”
When setting a new password:
  • Must be at least 8 characters
  • Must include one uppercase letter
  • Must include one number
  • Both fields must match
Success Message: “Contraseña restablecida con éxito” (passwordChange.js:61)Error Messages:
  • “El campo contraseña es obligatorio”
  • “La contraseña no cumple los requisitos”
  • “Las contraseñas no coinciden”

​
After Password Reset

Once your password is successfully reset:
  1. You’ll see a success notification
  2. You can return to the login page
  3. Use your new password to log into your account
Security Note: Password reset links expire after a certain time period for security. If your link has expired, you’ll need to request a new one.

​
Google OAuth Authentication

Finanzapp integrates with Google OAuth for seamless authentication.

​
How Google OAuth Works

1

Click Google Sign-in Button

On either the registration or login page, click the “Sign in with Google” or “Sign up with Google” button.
2

Google Authentication

You’ll see a Google popup window asking you to:
  • Select your Google account
  • Review the permissions Finanzapp is requesting
  • Authorize the connection
3

Account Creation or Login

Based on whether you have an existing account:New User: Your account is automatically created using your Google profile information (name, email, profile picture).Existing User: You’re logged into your existing Finanzapp account.This is handled by the callback functions in app/login.php:179-198 and app/auth/google-callback.php.
4

Redirect to Dashboard

After successful authentication, you’re redirected to your Finanzapp dashboard (login.php:196).

​
Google OAuth Benefits

Quick Access: No need to remember another passwordSecure: OAuth 2.0 is an industry-standard authentication protocolProfile Sync: Your Google profile information is automatically usedSingle Sign-On: If you’re already logged into Google, authentication is instant

​
Google OAuth Technical Details

Finanzapp uses Google’s Identity Services:
  • Client ID: Configured in both login and register pages
  • Context: signin for login, signup for registration
  • UX Mode: Popup for login, redirect for registration
  • Callback: Handles the credential response and user authentication
When you authenticate with Google, Finanzapp only accesses:
  • Your name
  • Your email address
  • Your profile picture (optional)
Finanzapp does not access:
  • Your Google Drive files
  • Your Gmail messages
  • Your Google Calendar
  • Any other Google services

​
Account Security Best Practices

Keep Your Account Secure:
  • Use a strong, unique password
  • Don’t share your password with anyone
  • Log out when using shared computers
  • Keep your email account secure (it’s used for password resets)
  • Review your account settings regularly
Need Help? If you’re having trouble accessing your account, contact Finanzapp support through the contact page.

Dashboard

Learn how to navigate and customize your dashboard

Transaction Management

Learn how to manage your financial transactions

Build docs developers (and LLMs) love

Get started for freeTalk to us