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.

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}

RECAPTCHA_BAD

The provided challenge response was denied.
Sample 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.

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}