Troubleshooting a Plaid error involves several steps. Here are some general steps you can follow:
-
Identify the Error: The first step in troubleshooting is to identify the error. Plaid provides detailed error messages that can help you understand what went wrong. You can find a comprehensive breakdown of all Plaid error codes in the Plaid Docs.
-
Understand the Error: Once you've identified the error, try to understand what it means. The error message will usually give you a good idea of what's causing the problem.
-
Check the Documentation: Plaid has extensive documentation that can help you understand and resolve errors. You can find information about common errors and their causes in the Plaid implementation handbook and specific troubleshooting steps for all errors in the Plaid Docs.
-
Troubleshooting Steps: Depending on the error, there may be specific troubleshooting steps you can follow. For example, if a user is experiencing connectivity issues, you might ask them to try again later. If an Item is duplicated, you can follow the instructions on preventing duplicate Items. If accounts are missing, you might need to prompt the user to enter the update mode flow or ensure that the
/link/token/createcall is configured correctly. -
Contact Support: If you're still having trouble after following the troubleshooting steps, you can open a case with our Support Team. In order to assist, you'll need to provide a relevant identifier (access_token, institution_id, and either link_session_id or request_id) so we can investigate the error further.
The Plaid Dashboard provides some useful tools to be able to troubleshoot your issues further. Please review our documentation on Dashboard tools for more information.