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.
Client-Side
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.

1
2
3
4
5
6
7
8
http code 400
{
"error_type": "",
"error_code": "institution-poor-health-error",
"error_message": null,
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

oauth-error

Returned when the OAuth login session for a user either times out or errors out
Client-Side
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
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "",
"error_code": "oauth-error",
"error_message": null,
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}