Plaid logo
Docs
ALL DOCS

Errors

  • Overview
  • Item errors
  • Institution errors
  • API errors
  • Assets errors
  • Payment errors
  • Transactions 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
  • Microdeposits errors
  • Partner errors
Plaid logo
Docs
Plaid.com
Get API keys
Open nav

ReCAPTCHA Errors

Guide to troubleshooting reCAPTCHA errors

RECAPTCHA_REQUIRED

The request was flagged by Plaid's fraud system, and requires additional verification to ensure they are not a bot.
Link user experience

Your user will be prompted to solve a Google reCAPTCHA challenge in the Link Recaptcha pane. If they solve the challenge successfully, the user's request is resubmitted and they are directed to the next Item creation step.

Common causes
  • Plaid's fraud system detects abusive traffic and considers a variety of parameters throughout Item creation requests. When a request is considered risky or possibly fraudulent, Link presents a reCAPTCHA for the user to solve.
Troubleshooting steps

Link will automatically guide your user through reCAPTCHA verification. As a general rule, we recommend instrumenting basic fraud monitoring to detect and protect your website from spam and abuse.

If your user cannot verify their session, please submit a Support ticket with the following identifiers: link_session_id or request_id.

Copy
1http code 400
2{
3 "error_type": "RECAPTCHA_ERROR",
4 "error_code": "RECAPTCHA_REQUIRED",
5 "error_message": "This request requires additional verification. Please resubmit the request after completing the challenge",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?

RECAPTCHA_BAD

The provided challenge response was denied.
User-facing error message
Please try connecting a different account: There was a problem processing your request. Your account could not be connected at this time
Link user experience

If after several failed attempts your user is still unable to solve the reCAPTCHA challenge, the RECAPTCHA_BAD error is returned and they are directed to the InstitutionSelect pane to connect a new account.

Common causes
  • The user was unable to successfully solve the presented reCAPTCHA problem after several attempts.
  • The current session is a bot or other malicious software.
Troubleshooting steps

If your user cannot verify their session, please submit a Support ticket with the following identifiers: link_session_id or request_id.

Copy
1http code 400
2{
3 "error_type": "RECAPTCHA_ERROR",
4 "error_code": "RECAPTCHA_BAD",
5 "error_message": "The provided challenge response was denied. Please try again",
6 "display_message": null,
7 "request_id": "HNTDNrA8F1shFEW"
8}
Was this helpful?
Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Twitter
Twitter
Discord
Discord