Link errors: common causes and troubleshooting.
When a user encounters an error in Link, they are shown an error screen that displays suggestions for resolving the particular issue. For easier troubleshooting, we recommend you include the
onError callback in your Link initialization.
onError callback returns:
1LinkError ( 2 "userId": String, // ID of the user 3 "errorType": String (enum), // Error name 4 "errorMessage": String, // User message 5 "errorDetails": String // Error details 6)
The Callback experience type was selected for "If no results" when customizing a Link Flow, but the
onCantFindItemClicked callback was not included in the Link initialization.
Adding a debit card failed because the third party system (Unit) failed to respond when retrieving the card's details.
The user's selected employer or payroll provider does not support deposit switching.
Link was initialized with an expired user token, or the user token expired during the Link session.
An unexpected error occurred. We are looking into it.
dds_config is not compatible with the selected employer or payroll system. Incompatibility may be due to some systems allowing only
amount allocations, others only
percent allocations, while others limit the maximum number of allowed allocations (
accountId was used for direct login to an existing account when initializing Link.
ddsConfig provided when initializing Link for a deposit switch is invalid.
The user token provided in the Link initialization was not valid.