An error can occur due to wrong integration or due to any unexpected technical issue. These errors are returned as part of the post message. Here is a sample format:
{
"code":"E701",
"title":"INVALID_PARAMETER_OR_VALUE",
"message":"Invalid value for providerId",
"fnToCall":"errorHandler"
}
Deep-Linking Errors
When a deep-linking error occurs, a technical error page will be displayed to the user with exit options such as a Close button and the X or close icon in the header.
Suggested action: Fix the error by passing the eligible or valid parameter value for the deep-linking flow.
- E7XX and E8XX errors are deep-linking errors that occur when invalid parameters or values are passed while invoking the deep-linking flow.
Code Title Message Description E700 INVALID_PARAMETER_OR_VALUE Invalid value for flow An invalid flow parameter is provided while invoking the FastLink deep-link flow. E701 INVALID_PARAMETER_OR_VALUE Invalid value for providerId An invalid providerId is provided while invoking the FastLink deep-link flow. E702 INVALID_PARAMETER_OR_VALUE Invalid value for providerAccountId An invalid providerAccountId is provided while invoking the FastLink deep-link flow. E703 INVALID_PARAMETER_OR_VALUE Invalid value for accountId An invalid accountId is provided while invoking the FastLink deep-link flow. E704 INVALID_PARAMETER_OR_VALUE Invalid value for container An invalid container parameter is provided while invoking the FastLink deep-link flow. E705 INVALID_PARAMETER_OR_VALUE Invalid value for bankTransferCode An invalid bankTransferCode is provided while invoking the FastLink deep-link flow. E800 INVALID_PARAMETER_OR_VALUE Generic Application Error We're having technical difficulties while processing the deep-link flow. Contact Yodlee Client Services for details. E801 INVALID_PARAMETER_OR_VALUE Provider not supported The parameters provided while invoking the FastLink deep-link flow does not support the provider in the system. E802 INVALID_PARAMETER_OR_VALUE Invalid value for providerAccountId The parameters provided while invoking the FastLink deep-link flow does not support the provider account in the system. E803 INVALID_PARAMETER_OR_VALUE Operation not allowed for providerAccountId The invoked FastLink deep-link flow is not allowed for the providerAccountId. E804 INVALID_PARAMETER_OR_VALUE Invalid value for accountId An invalid value is provided while invoking the FastLink deep-linking flow. - The following deep-linking errors occur when an ineligible deep-linking flow is invoked:
Code Title Message Description E405 PARAMETER_VALUE_INELIGIBLE Balance refresh flow is not compatible with __CONFIG_NAME__. The invoked balance refresh deep-link flow is not compatible with the configName
. - The following deep-linking errors occur when a particular feature is not enabled:
Flow Invocation Errors
The E6XX errors are flow invocation errors that occur when an invalid configName
parameter or values is passed. A technical error page will be displayed to the user with exit options such as a Close button and the X or close icon in the header
Suggested action: Fix the error by passing the eligible or valid parameter value for the invoked flow.
Functional Errors
The E1XX errors are functional errors that occur as a valid functional behavior such as locale not supported, refresh not allowed, etc. A technical error page will be displayed to the user with exit options such as a Close button and the X or close icon in the header.
Suggested action: Implement the appropriate error handling process for such functional errors.
Technical Errors
The N1XX errors are technical errors that occur due to integration issues. A technical error page with the Close button will be displayed.
Suggested action: Implement the appropriate error handling process for such errors.
Login Errors
The N4XX errors occur during the login process due to authentication issues. A technical error page with the Close button will be displayed.
Suggested action: These errors occur due to authentication issues. Implement the appropriate error handling process for such errors.
Session Errors
The N5XX errors are errors such as session expired, invalid session, etc. A technical error page with the Close button will be displayed.
Suggested action: These errors occur due to session-related issues. Implement the appropriate error handling process for such errors.
Server Errors
The N7XX errors are related to backend server connectivity. A technical error page with the Close button will be displayed.
Suggested action: These errors occur due to unexpected server issues. Implement the appropriate error handling process for such errors.
User Experience Errors
During the account linking process, the errors that a user may encounter are provided as follows:
Yodlee API Additional Status | Error Title, Message, and UAR Button | Post Message | Callback |
---|---|---|---|
ACCOUNT_LOCKED | Header: Your Account is Locked Text: You're locked out of your account. Please visit <site_name> to fix. Primary UAR Button(s): Go to Site Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:pHPulMbN48SzIxjTy1fRCmrbuWY= reason:You're locked out of your account. Please visit <site_name> to fix. status:FAILED additionalStatus:ACCOUNT_LOCKED providerAccountId:11653329 fnToCall:accountStatus |
|
ADDL_AUTHENTICATION_REQUIRED | Header: Additional Information Required Text: Your security authentication timed out or a new security authentication is required. Please try again. Primary UAR Button(s): Try Again Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:UGpuwyrQqapuzJUX/WA6gjNCwvY= reason:Your security authentication timed out or a new security authentication is required. Please try again. status:FAILED additionalStatus:ADDL_AUTHENTICATION_REQUIRED providerAccountId:11653332 fnToCall:accountStatus |
|
BETA_SITE_DEV_IN_PROGRESS | Header: Site Support in Process Text: We're still in the process of building support for this site. Please try again later. Primary UAR Button(s): Link another account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:PclhLJi/7BGtEdcw7Cf5DXiHdWk= reason:We're still in the process of building support for this site. Please try again later. status:FAILED additionalStatus:BETA_SITE_DEV_IN_PROGRESS providerAccountId:11653337 fnToCall:accountStatus |
|
CREDENTIALS_UPDATE_NEEDED | Header: Action Required at <site_name> Text: Please visit <site_name> to update your account information or password. Primary UAR Button(s): Go to Site Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:rsQY24Oi2PjuHu+Cwfdb97eFHE0= reason:Please visit <site_name> to update your account information or password. status:FAILED additionalStatus:CREDENTIALS_UPDATE_NEEDED providerAccountId:11653341 fnToCall:accountStatus |
|
INCORRECT_CREDENTIALS | Header: Incorrect Credentials Text: The credentials you've entered are incorrect. Verify that CAPS LOCK is not on and that the desired financial institution was selected. Primary UAR Button(s): N/A (error Text in-line; user can click back button to select a different site) Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:5DthY3MN8Auz1qwJMiONIgdWdSE= reason:The credentials you've entered are incorrect. Verify that CAPS LOCK is not on and that the desired financial institution was selected. status:FAILED additionalStatus:INCORRECT_CREDENTIALS providerAccountId:11653343 fnToCall:accountStatus |
|
DATA_NOT_AVAILABLE | Header: Data is Unavailable Text: We're unable to find the requested account type for this site or you have closed the account. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): Visit Site |
providerId:16441 providerName:<site_name> requestId:ME2cKa0XSyo2nXUvJEbaXzEam4Q= reason:We're unable to find the requested account type for this site or you have closed the account. status:FAILED additionalStatus:DATA_NOT_AVAILABLE providerAccountId:11653343 fnToCall:accountStatus |
|
PROPERTY_VALUE_NOT_AVAILABLE | Header: Property Value is Unavailable Text: Please ensure the property information is correct or enter it manually. Primary UAR Button(s): In-line: user re-enters value under "calculate automatically" Secondary UAR Button(s): User selects "enter value manually" |
N/A (This is the IN LINE error in Real Estate Screen) | N/A (This is the IN LINE error in Real Estate Screen) |
INVALID_ADDL_INFO_PROVIDED | Header: Invalid Security Info Text: The information you provided is incorrect. Please try again or visit <site_name> to verify your details. Primary UAR Button(s): Try Again (sends user to verifying login; we re-enter username/password on user's behalf) Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:KSIPLuOPzgHJU2f77ZVt75haAc0= reason:The information you provided is incorrect. Please try again or visit <site_name> to verify your details. status:FAILED additionalStatus:INVALID_ADDL_INFO_PROVIDED providerAccountId:11653345 fnToCall:accountStatus |
|
REQUEST_TIME_OUT | Header: Unable to Link Account Text: We're experiencing trouble linking your account at this time. Would you like to link a different account? Primary UAR Button(s): Link Another Account Secondary UAR Button(s): Close |
providerId:16441 providerName:<site_name> requestId:wBtibwSDIRelEUfLA0AktWermn0= reason:We're experiencing trouble linking your account at this time. Would you like to link a different account? status:FAILED additionalStatus:REQUEST_TIME_OUT providerAccountId:11654539 fnToCall:accountStatus |
|
SITE_BLOCKING_ERROR | Header: Site is Blocked Text: We're unable to add your account because this site is blocked. Please contact <site_name>'s customer support to fix. Primary UAR Button(s): Go to Site Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:DWRSuP4YNfLwMv2rI+CWeYD55Fk= reason:We're unable to add your account because this site is blocked. Please contact <site_name>'s customer support to fix. status:FAILED additionalStatus:SITE_BLOCKING_ERROR providerAccountId:11653346 fnToCall:accountStatus |
|
UNEXPECTED_SITE_ERROR | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:wBtibwSDIRelEUfLA0AktWermn0= reason:We're unable to link your account at this time. Please try again later and contact <company name> support team if the issue persists. status:FAILED additionalStatus:UNEXPECTED_SITE_ERROR providerAccountId:11653349 fnToCall:accountStatus |
|
SITE_NOT_SUPPORTED | Header: Site Not Supported Text: We're unable to support this site. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:k9L+4Unjs+xzGxqt3O/Jy9A2wcw= reason:We're unable to support this site, but you can add your account details manually. status:FAILED additionalStatus:SITE_NOT_SUPPORTED providerAccountId:11653352 fnToCall:accountStatus |
|
DATASET_NOT_SUPPORTED | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Try Again Secondary UAR Button(s): Link Another Account |
This scenario will not occur. | This scenario will not occur. |
SITE_UNAVAILABLE | Header: Site is Down Text: We’re unable to link your account at this time. Please try again in 4-24 hours. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:LFB1buwj2YpeskZ8PA3bTLOhgWU= reason:We're unable to link your account at this time. Please try again in 4-24 hours. status:FAILED additionalStatus:SITE_UNAVAILABLE providerAccountId:11653353 fnToCall:accountStatus |
|
TECH_ERROR | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:tK8XGHWFW52GQIP+fdQ2iVSLqE0= reason:We're unable to link your account at this time. Please try again later and contact <company name> support team if the issue persists. status:FAILED additionalStatus:TECH_ERROR providerAccountId:11653354 fnToCall:accountStatus |
|
USER_ACTION_NEEDED_AT_SITE | Header: Action Required at <site_name> Text: Please visit <site_name> to update your account information or password. Primary UAR Button(s): Go to Site Secondary UAR Button(s): Link Another Account |
providerId:16441 providerName:<site_name> requestId:ajUliTX4oR4vQ3EJjOEe7sA7d8A= reason:Please visit <site_name> to update your account information or password. status:FAILED additionalStatus:USER_ACTION_NEEDED_AT_SITE providerAccountId:11653357 fnToCall:accountStatus |
|
SITE_SESSION_INVALIDATED | Header: Session Ended Text: The session has ended due to security reasons or you are already logged in. Please make sure you're logged out on other devices and try again. Primary UAR Button(s): Try Again (verifying stepper- using previous login credentials) Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:vkSOonIwQBIrvjzL8GmfuyTdHLk= reason:The session has ended due to security reasons or you are already logged in. Please make sure you're logged out on other devices and try again. status:FAILED additionalStatus:SITE_SESSION_INVALIDATED providerAccountId:11653358 fnToCall:accountStatus |
|
ENROLLMENT_REQUIRED_ FOR_DATASET |
Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Try Again Secondary UAR Button(s): Link Another Account |
This scenario may not occur as the configName is created using the Configuration Tool. |
This scenario may not occur as the configName is created using the Configuration Tool. |
DATA_RETRIEVAL_FAILED | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
|
|
PARTIAL_DATA_RETRIEVED | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <co-brand name> support team if the issue persists. Primary UAR Button(s): Try Again Secondary UAR Button(s): Link Another Account |
Not an error | Not an error |
NEW_AUTHENTICATION_REQUIRED | Header: New Authentication Required Text: This site's method of authentication has changed. Please follow the new sign-on process. Primary UAR Button(s): Edit Credentials -edit flow Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:8Pt91qRi5Gk3jVaDzMnLbY3i3NU= reason:This site's method of authentication has changed. Please follow the new sign-on process. status:FAILED additionalStatus:NEW_AUTHENTICATION_REQUIRED providerAccountId:11654679 fnToCall:accountStatus |
|
N/A | Header: Invalid Security Information Primary UAR Button(s): Submit Secondary UAR Button(s): Send New Code Cancel |
providerId:16442 providerName:<site_name> requestId:pARwxt+WkXieUGeUorAAUFRFWUA= reason:User canceled the linking process. status:ACTION_ABANDONED providerAccountId:11919686 |
|
N/A | Header: Unable to Complete Your Request Text: You've exceeded the number of attempts allowed to enter your authentication code. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): Close |
providerId:16442 providerName:<site_name> requestId:pARwxt+WkXieUGeUorAAUFRFWUA= isMFAError:true reason:You've exceeded the number of attempts allowed to enter your authentication code. status:FAILED additionalStatus:EXCEEDED_INVALID_ADDL_INFO_PROVIDED providerAccountId:11919686 |
|
N/A | Header: Technical Error Text: We're facing a technical issue. Please contact _COMPANY_NAME_ support team or try again later. Primary UAR Button(s): Close Secondary UAR Button(s): N/A |
||
N/A | Header: No Eligible Verification Accounts Text: You do not have any accounts eligible for verification with this site. Verification eligibility is determined by _COMPANY_NAME_ based on the type of data available for this account. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
providerId:16441 providerName:<site_name> requestId:xcEDLSCGQFx1ZEyx3imfiXKfPV4= reason:You do not have any accounts eligible for verification with this site. Verification eligibility is determined by <Company_Name> based on the type of data available for this account. status:FAILED additionalStatus:NO_ACCOUNTS_FOR_VERIFICATION providerAccountId:11391112 |
|
Open Banking Errors
Errors that a user may encounter during the Open Banking FastLink flow. The following table includes information around the message shown to the user, applicable locale, and the post message information:
Yodlee API Additional Status | Error Title, Message, and UAR Button | Locale (US/UK/AU) |
Post Message |
---|---|---|---|
INCORRECT_OAUTH_TOKEN | Header: Connection Upgrade Required Text: The consent you provided to access account information at <site_name> has some issues. Click Update to re-authorize permissions. Primary UAR Button(s): Update Secondary UAR Button(s): Close |
US and AU |
|
TECH_ERROR | Header: Technical Error Text: We're unable to link your account at this time. Please try again later and contact <site_name> support team if the issue persists. Primary UAR Button(s): Link Another Account Secondary UAR Button(s): N/A |
All |
|
MIGRATION_IN_PROGRESS | Header: Account Connection Upgrade Text: Upgrading your account connection is taking more time than expected. Please check your account status later. Primary UAR Button(s): Ok Secondary UAR Button(s): N/A |
US and AU |
|
N/A | Header: Unable to Link with Open Banking Text: We are unable to link your account because the flow at the bank site was incomplete. Please try again later. Primary UAR Button(s): Close Secondary UAR Button(s): Link Another Account |
All |
|
N/A | Header: Account Connection Upgrade Text: Upgrading your account connection seems to have a temporary issue. Please try again later. Primary UAR Button(s): Close Secondary UAR Button(s): N/A |
US and AU |
|