- Error codes are returned as part of the accounts object
accounts.pay_distribution.statusreturns erroraccounts.pay_distribution.error_codeshows the error codeaccounts.pay_distribution.error_messageprovides additional information about the error
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.Error example in an account object:
account_disconnected
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s connection has expired and requires re-authentication.
Account object:
bank_and_card_update_failed
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
Argyle encountered a problem when updating bank account and card deposit settings. Our team has been notified and is investigating.
Account object:
card_update_failed
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
Argyle encountered a problem when updating user’s payout card settings. Our team has been notified and is investigating.
Account object:
confirmation_timeout
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user did not finish confirming the direct deposit switch.
Account object:
incompatible_auth
- API message
- User message
- Common causes
- Troubleshooting
This user’s employment platform does not support direct deposit switching with this user’s selected login method.
Account object:
incompatible_config
- API message
- User message
- Common causes
- Troubleshooting
The provided direct deposit switch configuration is not compatible with this user’s employment account.
Account object:
invalid_account_state
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s account connection failed, preventing direct deposit switching.
Account object:
invalid_mfa
- API message
- User message
- Common causes
- Troubleshooting
This user did not provide the correct multi-factor authentication response.
Account object:
mfa_attempts_exceeded
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user failed multi-factor authentication too many times, causing them to be unable to attempt further logins until multi-factor authentication method is reset.
Account object:
mfa_exhausted
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user failed multi-factor authentication too many times, requiring them to re-authenticate.
Account object:
mfa_not_configured
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user has not configured multi-factor authentication for their employment account, restricting access to the user’s employment data.
Account object:
mfa_timeout
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user did not complete multi-factor authentication.
Account object:
missing_allocation
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account does not have any allocation set up which is required to allocate the remainder.
Account object:
missing_allocation_type
- API message
- User message
- Common causes
- Troubleshooting
One or more of this account’s pay allocations is missing a type (percent/amount/remainder), preventing direct deposit switching.
Account object:
not_supported
- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account does not support direct deposit switching.
Account object:
not_supported_by_employer
- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account does not support direct deposit switching because the employer has disabled users from editing this information.
Account object:
physical_mfa_unsupported
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account uses a physical multi-factor authentication method that Argyle does not currently support.
Account object:
rejected_bank_account
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
The provided bank account was rejected by the user’s employment platform. Please provide a different bank account.
Account object:
rejected_card
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
The provided card cannot be used for direct deposit switching. Please provide a different card.
Account object:
rejected_routing_number
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
The provided routing number is considered invalid by this user’s employment account.
Account object:
service_unavailable
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment platform is experiencing downtime and is currently unable to process direct deposit switching.
Account object:
system_error
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
Argyle encountered a problem while updating user’s deposit settings. Our team has been notified and is investigating.
Account object:
unsupported_allocation_type
- API message
- User message
- Common causes
- Troubleshooting
This user’s deposit settings contain pay allocations of unsupported types preventing the direct deposit switch. Supported allocation types are percent, amount and remainder.
Account object:
unsupported_bank_accounts
- API message
- User message
- Common causes
- Troubleshooting
This user’s deposit settings contain pay allocations of unsupported bank account types like HSAs, preventing the direct deposit switch.
Account object:
unsupported_bank_account_country
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s deposit settings contain pay allocations of unsupported countries, preventing direct deposit switching.
Account object:
unsupported_mfa_method
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
This user’s employment account uses a multi-factor authentication method that Argyle does not currently support.
Account object:
waiting_period
This error triggers the
accounts.pay_distribution_failed webhook.- API message
- User message
- Common causes
- Troubleshooting
Direct deposit switching is temporarily unavailable due to employer requiring a waiting period after a recent direct deposit switch or initial account connection.