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.
Link 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
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}