Account Connection Errors

Common causes and troubleshooting.

Overview#

Account connection errors occur when a user is actively attempting to connect a payroll account through Link.

To monitor for account connection errors:

  1. Subscribe to the accounts.failed webhook.

  2. Subscribe to the accounts.updated webhook and use the optional config parameter to receive an account object in the webhook's delivery payload.

  3. When you receive the accounts.failed webhook or are encountering account connection issues, check the account object in payload of the accounts.updated webhook. If the status value of the connection object is error, proceed to the troubleshooting steps below.

    The accounts.updated webhook is always sent when the accounts.failed webhook is sent.

Account connection errors#

account_disabled#

An account may be disabled or taken offline for a variety of reasons, such as account inactivity.

account_inaccessible#

The account unexpectedly cannot be accessed by Argyle. We have automatically been notified and will investigate.

account_incomplete#

The accounts.failed webhook is sent when this error occurs.

The user has not finished setting up an account within their payroll system.

account_nonunique#

The accounts.failed webhook is sent when this error occurs.

The personal details provided by the user during the Login help process of certain Items was a match for multiple account records stored by the payroll platform, resulting in an error.

account_not_found#

The accounts.failed webhook is sent when this error occurs.

The personal details provided by the user during the Login help process of certain Items did not match an account record stored by the payroll platform.

auth_required#

An account has become disconnected and needs to be re-authenticated.

connection_unavailable#

The accounts.failed webhook is sent when this error occurs.

A new connection attempt was unsuccessful because the account was unavailable.

credentials_managed_by_organization#

The accounts.failed webhook is sent when this error occurs.

The credentials provided by the user during the Login help process of certain Items could not be adjusted in a self-service way because their credentials are centrally managed by their organization's IT department for security reasons.

expired_credentials#

The accounts.failed webhook is sent when this error occurs.

Some payroll platforms require users to periodically update their login credentials.

full_auth_required#

This error is manually set by Argyle after investigating a previous error.

invalid_account_type#

The accounts.failed webhook is sent when this error occurs.

The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.

invalid_auth#

The accounts.failed webhook is sent when this error occurs.

The user entered invalid login credentials to their payroll system, or was unable to successfully complete its multi-factor authentication (MFA) process.

invalid_credentials#

The accounts.failed webhook is sent when this error occurs.

The user may have entered login credentials for the employer or payroll provider that are not related to their payroll credentials.

invalid_login_method#

The accounts.failed webhook is sent when this error occurs.

This platform currently supports login methods for this payroll account that are different than the one attempted by the user when trying to connect.

invalid_login_url#

The accounts.failed webhook is sent when this error occurs.

Some payroll platforms will successfully authenticate users when they use valid login credentials but throw an error because the wrong employer or payroll provider was selected.

invalid_mfa#

This user did not provide the correct multi-factor authentication (MFA) response that was requested by the platform.

login_attempts_exceeded#

The accounts.failed webhook is sent when this error occurs.

The platform temporarily disabled login attempts for this payroll account due to entering invalid credentials too many times.

mfa_attempts_exceeded#

The accounts.failed webhook is sent when this error occurs.

The platform permanently disabled login attempts for this payroll account due to entering an invalid MFA too many times. It only can be resolved by the user resetting MFA directly on the payroll system.

mfa_cancelled_by_the_user#

The user exited the MFA screen during an account connection.

mfa_exhausted#

The accounts.failed webhook is sent when this error occurs.

The platform requires a full re-authentication for this payroll account due to unsuccessfully completing MFA multiple times.

mfa_not_configured#

The accounts.failed webhook is sent when this error occurs.

The payroll platform requires multi-factor authentication (MFA) to access payroll data.

mfa_timeout#

The accounts.failed webhook is sent when this error occurs.

The user did not complete MFA within the given time period.

ongoing_refresh_disabled#

The accounts.updated webhook is sent when this error occurs.

Ongoing refresh was manually disabled via the API for this account.

physical_mfa_unsupported#

The accounts.failed webhook is sent when this error occurs.

The user attempted to use a physical multi-factor authentication method that Argyle does not support.

platform_temporarily_unavailable#

The accounts.failed webhook is sent when this error occurs.

The account's underlying payroll system is experiencing connection issues. New connections are temporarily unavailable.

service_unavailable#

The accounts.failed webhook is sent when this error occurs.

The payroll system may be offline due to planned maintenance or is experiencing service interruptions.

session_limit_reached#

The accounts.failed webhook is sent when this error occurs.

Some platforms impose limits on the number of active sessions. If a user has reached this limit by being logged into the platform on another device or window, Argyle will not initiate a new connection to avoid disconnecting the user from their other active sessions.

system_error#

The accounts.failed webhook is sent when this error occurs.

An unexpected error occurred, such as an invalid session or unavailable service.

tos_required#

The accounts.failed webhook is sent when this error occurs.

The payroll system requires the user to accept the Terms of Service to allow access to the payroll account or its data.

trial_connections_exhausted#

This account could not be connected because you've reached your limit for free account connections in Argyle's trial mode.

trial_period_expired#

The accounts.failed webhook is sent when this error occurs.

This user's payroll account was a trial account on the payroll system's platform, and is currently disabled because the trial period has expired.

unsupported_auth_type#

The accounts.failed webhook is sent when this error occurs.

Argyle does not support the user's attempted single sign-on (SSO) method for this particular payroll system.

unsupported_business_account#

The accounts.failed webhook is sent when this error occurs.

The user submitted business account credentials instead of their personal credentials needed to access their payroll account.

unsupported_language#

The accounts.failed webhook is sent when this error occurs.

The user's payroll system contains data or documents that are in a language not currently supported by Argyle.

unsupported_mfa_method#

The accounts.failed webhook is sent when this error occurs.

The user's payroll system uses an MFA method that Argyle does not currently support.

user_action_timeout#

The user failed to select their current employer or create a new password within the given time period required to connect an account during the Login help process for certain Items.

Updating Argyle status...
© 2024 Argyle Systems Inc.argyle.com