How do I handle the DEPRECATED account status?
The status DEPRECATED (outdated) can appear when we can no longer map an account. This can happen when:
there have been changes to an account by the bank that prevent us from mapping the respective account. Usually, finAPI can detect changes and update the account, e.g. when the account name changes, but there can be cases where we can no longer identify the account based on the new data from the bank.
the account has been closed.
Licensed mandators or Web Form V1 mandators
In this case, please perform an update for this bank connection and set the importNewAccounts: true
flag.
Web Form V2 mandators
In this case, please perform an update for this bank connection and set the importNewAccountsMode: CONDITIONAL
flag.
For Sparkassen banks, a new consent must be requested to retrieve new accounts.
With importNewAccountsMode: FORCED
, the existing consent is deleted, and a new consent is requested.
If you only set importNewAccountsMode: CONDITIONAL
for Sparkassen you will not be provided with new accounts.
You can see which banks require "importNewAccountsMode: FORCED" in the BankConnection under bankInterfaces[].aisConsent.supportsImportNewAccounts
.
If supportsImportNewAccounts: false
is delivered then you must set importNewAccountsMode: FORCED
.
If supportsImportNewAccounts: true
is delivered, it is sufficient to set importNewAccountsMode: CONDITIONAL
.