Link web
Guide to troubleshooting Link errors on the web
Most errors returned by Link are an SDK-specific representation of an API error. For troubleshooting help, see the guidance for the specific API error.
In addition, there is one Link-specific error that does not correspond to an API error:
institution-poor-health-error
The user is trying to link to an institution with poor Plaid connectivity health.
Sample user-facing error message
We're currently experiencing connectivity issues with this bank: You can try again later or find another bank to continueLink user experience
Your user will see a warning pane before they enter their credentials, telling them that adding the account may fail and suggesting that they link a different account.
Common causes
- The institution is experiencing a temporary disruption of connectivity to Plaid.
Troubleshooting steps
If the problem persists, file a Plaid support ticket.
1http code 4002{3 "error_type": "",4 "error_code": "institution-poor-health-error",5 "error_message": null,6 "display_message": null,7 "request_id": "HNTDNrA8F1shFEW"8}
Was this helpful?
oauth-error
Returned when the OAuth login session for a user either times out or errors out
Sample user-facing error message
An error has occurred linking your account:Link user experience
Your user will be shown an error message indicating that their account was not successfully linked and will be prompted to retry their login attempt.
Common causes
- Your user did not complete their OAuth login attempt within 10 minutes.
- Plaid is experiencing internal system issues.
Troubleshooting steps
1http code 4002{3 "error_type": "",4 "error_code": "oauth-error",5 "error_message": null,6 "display_message": null,7 "request_id": "HNTDNrA8F1shFEW"8}