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

When re-initializing Link, make sure to use the same nonce that was used to originally initialize Link for that Item.

API error response
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

When re-initializing Link, make sure to use the same link_token that was used to originally initialize Link for that Item.

API error response
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

When re-initializing Link, make sure to use a unique OAuth state ID for each Link instance.

When re-initializing Link, make sure to correctly set the receivedRedirectUri as described in the re-initializing Link section of the OAuth Guide. Plaid will automatically extract the OAuth state ID from the receivedRedirectUri.

API error response
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

File a Plaid Support ticket.

API error response
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}