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 continue
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 400
2{
3 "error_type": "",
4 "error_code": "institution-poor-health-error",
5 "error_message": null,
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}

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 400
2{
3 "error_type": "",
4 "error_code": "oauth-error",
5 "error_message": null,
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}