Plaid logo
Docs
ALL DOCS

Identity Verification

  • Introduction to Identity Verification
  • Webhooks
  • Link callbacks
  • Testing in Sandbox
  • Input validation rules
  • Risk checks
  • Managing failed verifications
  • Metrics and reporting
Plaid logo
Docs
Close search modal
Ask Bill!
Ask Bill!
Hi! I'm Bill! You can ask me all about the Plaid API. Try asking questions like:
  • Which countries does Investments support?
  • How do I set up a webhook for IDV?
  • How do I set up Link on the web?
Note: Bill isn't perfect. He's just a robot platypus that reads our docs for fun. You should treat his answers with the same healthy skepticism you might treat any other answer on the internet. This chat may be logged for quality and training purposes. Please don't send Bill any PII -- he's scared of intimacy. All chats with Bill are subject to Plaid's Privacy Policy.
Plaid.com
Log in
Get API Keys
Open nav

Operational guide

Operational guidance for Identity Verification, including how to manage failed verifications

Overview

The most common reason for Identity Verification failures is bad actors and attempted fraud. However, sometimes a genuine user may fail a check due to various reasons, such as accidentally entering incorrect information, a lack of records available to confirm their identity, or issues with their identity documents. This page discusses common reasons why legitimate users may fail checks and how you can handle these issues.

Common causes for Data Source Verification failures

No match

Causes include:

  • Recent personal information changes, such as a change of address or a legal name change
  • If you are providing any user information via the API rather than Link, it must use the correct format. For example, if you send DOB as month/day/year rather than in ISO format, it will cause date of birth mismatches. See Input validation rules.
No data

Causes include:

  • Phone number appears less consistently in data sources than other fields, and is most likely to result in "no data"
  • Recent immigrants and younger end users are less likely to have data on file
  • Countries other than the US have less complete records and are less likely to have data source matches

Common causes for Documentary Verification failures

  • Expired documents will fail Documentary Verification, even if they are genuine
  • Documents that do not match the name and date of birth entered will fail

Common causes for Risk Check failures

See Risk Checks for more information.

Common causes for Selfie Check failures

Causes generally involve low-quality images, which can be caused by:

  • Poor quality camera, such as one found on a very old, low-end device
  • Insufficient lighting
  • Improper framing (head cut off or not facing camera)
  • Excessive glare from glasses
  • Motion blur while taking photo

Plaid provides guidance in Link to help users take appropriate selfies.

Managing failures

If you have reason to believe that the end user's information is correct, you can override a failure via the Dashboard by clicking the Override Result button on the verification detail page in the Dashboard.

To allow a user to retry a verification, you can issue a retry. For instructions on the process, see Retries.

Reporting issues

If at any point you believe that the Identity Verification result was incorrect, you can use the Report a Problem button in the Identity Verification Dashboard to inform Plaid. If you require a response, file a ticket via the Dashboard instead.

Developer community
GitHub
GitHub
Stack Overflow
Stack Overflow
YouTube
YouTube
Discord
Discord
Plaid uses cookies & third-party tools for our website, advertising & marketing, user data collection, session recording & online instructions. Manage your preferenceshere.
Company Logo

Website Data Collection Preferences

Plaid uses data collected by cookies and JavaScript libraries to improve your browsing experience, analyze site traffic, deliver personalized advertisements, and increase the overall performance of our site. This table outlines how we use this data by category. Click on the different category headings to find out more and change the default settings. You cannot opt-out of our First Party Strictly Necessary Cookies as they are deployed in order to ensure the proper functioning of our website (such as prompting the cookie banner and remembering your settings, to log into your account, to redirect you when you log out, etc.). By using our website, you're agreeing to the use of cookies as described in our Cookie Policy.
Cookie Policy

Manage Consent Preferences

Strictly Necessary Cookies

Always Active

These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.

Functional Cookies

These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.

Targeting Cookies

These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising.

Cookie List

Search Icon
label
Consent Leg.Interest
label
label
label
Powered by Onetrust