Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Transfer errors
  • Income errors
  • Sandbox errors
  • Invalid Request errors
  • Invalid Input errors
  • Invalid Result errors
  • Rate Limit Exceeded errors
  • Link web errors
  • Recaptcha errors
  • OAuth errors
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

OAuth Errors

Guide to troubleshooting OAuth errors

For information on troubleshooting OAuth errors in Link not related to a specific error code, see Link troubleshooting and troubleshooting common OAuth problems.

INCORRECT_OAUTH_NONCE

An incorrect OAuth nonce was supplied when re-initializing Link.
Server-Side
Common causes
  • During the OAuth flow, Link must be initialized, the user must be handed off to the institution's OAuth authorization page, and then Link must be re-initialized for the user to complete Link flow. This error can occur if a different nonce is supplied during the re-initialization process than was originally supplied to Link for the first initialization step.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "OAUTH_ERROR",
4 "error_code": "INCORRECT_OAUTH_NONCE",
5 "error_message": "nonce does not match",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

INCORRECT_LINK_TOKEN

An incorrect Link token was supplied when re-initializing Link.
Server-Side
Common causes
  • During the OAuth flow, Link must be initialized, the user must be handed off to the institution's OAuth authorization page, and then Link must be re-initialized for the user to complete Link flow. This error can occur if a different link_token is supplied during the re-initialization process than was originally supplied to Link for the first initialization step.
Troubleshooting steps
Copy
1http code 400
2{
3 "error_type": "OAUTH_ERROR",
4 "error_code": "INCORRECT_LINK_TOKEN",
5 "error_message": "link token does not match original link token",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

OAUTH_STATE_ID_ALREADY_PROCESSED

The OAuth state has already been processed.
Server-SideorClient-Side
Common causes
  • During the OAuth flow, Link must be initialized, the user must be handed off to the institution's OAuth authorization page, and then Link must be re-initialized for the user to complete Link flow. This error can occur if the OAuth state ID used during re-initialization of Link has already been used.
Troubleshooting steps
Copy
1http code 208
2{
3 "error_type": "OAUTH_ERROR",
4 "error_code": "OAUTH_STATE_ID_ALREADY_PROCESSED",
5 "error_message": null,
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

OAUTH_STATE_ID_NOT_FOUND

The OAuth state id could not be found.
Server-Side
Common causes
  • An internal Plaid error occurred.
Troubleshooting steps
Copy
1http code 404
2{
3 "error_type": "OAUTH_ERROR",
4 "error_code": "OAUTH_STATE_ID_NOT_FOUND",
5 "error_message": "the provided oauth_state_id wasn't found",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?
Developer community
Github logo
Github logo
StackOverflow logo
StackOverflow logo
Twitter logo
Twitter logo