Pay Distribution Errors

Errors that occur during the pay distribution update flow.

Overview

Some error messages shown to the user have placeholders for [Link item name] and [Company name]. In such cases, for the screens samples below, they were replaced by Starbox and GoodLoans, respectively.

The tag Webhook indicates if the error triggers the related webhook.

confirmation_timeoutWebhook

API error_message

This user did not finish setting up their new pay distribution.

Message to the user

Common causes

Troubleshooting steps

incompatible_config

API error_message

The pay allocation details that have been submitted are not supported by this user's employment account.

Message to the user

Common causes

Troubleshooting steps

invalid_mfaWebhook

API error_message

This user did not provide the correct multi-factor authentication response.

Message to the users

Common causes

Troubleshooting steps

mfa_exhaustedWebhook

API error_message

This user failed multi-factor authentication too many times, requiring them to re-authenticate.

Message to the users

Common causes

Troubleshooting steps

mfa_not_configuredWebhook

API error_message

This user has not configured multi-factor authentication for their employment account, restricting access to the user's employment data.

Message to the users

Common causes

Troubleshooting steps

mfa_timeoutWebhook

API error_message

This user did not complete multi-factor authentication.

Message to the users

Common causes

Troubleshooting steps

missing_allocation_type

API error_message

One or more of this account's pay allocations is missing a type (percent/amount/remainder), causing Argyle to be unable to update the user's pay distribution information.

Message to the user

Common causes

Troubleshooting steps

not_supported

API error_message

This user's employment account does not support updating pay distribution information.

Message to the user

Common causes

Troubleshooting steps

not_supported_by_employer

API error_message

This user's employment account does not support changes to pay distribution information. This may be because the employer has disabled users from editing this information.

Message to the user

Common causes

Troubleshooting steps

rejected_bank_accountWebhook

API error_message

The provided bank account cannot be used for pay distribution update. Please provide a different bank account.

Message to the user

Common causes

Troubleshooting steps

rejected_routing_numberWebhook

API error_message

The provided routing number is considered invalid by this user's employment account.

Message to the user

Common causes

Troubleshooting steps

service_unavailableWebhook

API error_message

This user's employment platform is experiencing downtime and is currently unable to process updates to pay allocations.

Message to the user

Common causes

Troubleshooting steps

system_errorWebhook

API error_message

Argyle encountered a problem when reading or updating pay distribution information. Our team has been notified and is investigating.

Message to the user

Common causes

Troubleshooting steps

unsupported_allocation_type

API error_message

One or more of this account's pay allocations is not currently supported, causing Argyle to be unable to update the user's pay distribution information. Supported allocation types are percent, amount and remainder.

Message to the user

Common causes

Troubleshooting steps

unsupported_bank_accounts

API error_message

This user's employment account includes pay allocations to bank account types that Argyle does not yet support, like HSAs.

Message to the user

Common causes

Troubleshooting steps

unsupported_mfa_methodWebhook

API error_message

This user's employment account uses a multi-factor authentication method that Argyle does not currently support.

Message to the users

Common causes

Troubleshooting steps

waiting_periodWebhook

API error_message

Pay distribution update is temporarily unavailable. This can happen when an employer requires a waiting period after recent pay distribution updates or after initial account creation.

Message to the user

Common causes

Troubleshooting steps