InvalidCredentials

🛑

Disconnected

InvalidCredentials occurs when the provider rejects the login attempt due to incorrect credentials, such as an invalid username or password. This status is determined during the authentication phase, before any data retrieval begins.

Implications:

• The session terminates immediately without progressing past the login stage.
• No data is retrieved.
• The session is considered unsuccessful, and no retry will occur automatically.

Expected Developer Action:

• Prompt the user to verify and update their login credentials for the provider.
• Allow the user to reinitiate the connection after correcting the credentials.
• Consider implementing in-app validation UI or guidance for common formatting issues (e.g., account number vs. username confusion).
• Some providers may not differentiate between invalid usernames and passwords, so error messaging should remain general (e.g., "Incorrect login information").

Possible Previous Statuses:

• Connecting

Possible Next Statuses:

• None - InvalidCredentials is a terminal failure status; the session ends as soon as the provider rejects the login.