OAuth Errors

Guide to troubleshooting OAuth errors

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
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "OAUTH_ERROR",
"error_code": "INCORRECT_OAUTH_NONCE",
"error_message": "nonce does not match",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

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
1
2
3
4
5
6
7
8
http code 400
{
"error_type": "OAUTH_ERROR",
"error_code": "INCORRECT_LINK_TOKEN",
"error_message": "link token does not match original link token",
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}

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
1
2
3
4
5
6
7
8
http code 208
{
"error_type": "OAUTH_ERROR",
"error_code": "OAUTH_STATE_ID_ALREADY_PROCESSED",
"error_message": null,
"display_message": null,
"request_id": "HNTDNrA8F1shFEW"
}