Plaid logo
Docs
ALL DOCS

Auth

  • Introduction to Auth
  • Add Auth to your app
  • Money movement partnerships
  • Increasing pay-by-bank adoption
  • Additional Auth flows
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:
    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

    Additional verification flows

    Support Auth for more US financial institutions and users

    Overview

    Instant Auth covers approximately 95% of users' eligible bank accounts. For the remaining ~5%, or users who choose not to use instant credential verification, Plaid offers users the ability to verify their accounts through an optimized set of database validation and micro-deposit flows.

    Our video tutorial also provides a comprehensive guide to adding Auth using micro-deposits

    The following flows are enabled in your app by default once you have integrated Auth:

    • Instant Auth: User enters their credentials and is authenticated immediately. This is the default flow.
    • Instant Match (US only): User enters their credentials, account number, and routing number. Plaid matches user input against masked values and authenticates immediately.

    To increase conversion, you can enable the following additional Auth flows:

    • Database Auth (US only): User enters account and routing numbers. Plaid attempts to match this data against known-good account and routing numbers recognized on the Plaid network.
    • Automated Micro-deposits (US only): User enters their credentials, account number, and routing number. Plaid makes a micro-deposit and automatically verifies the deposit in as little as one to two business days.
    • Instant Micro-deposits (US only): User enters account and routing numbers. Plaid makes a RTP or FedNow micro-deposit and the user manually verifies the code in as little as 5 seconds.
    • Same Day Micro-deposits (US only): User enters account and routing numbers. Plaid makes a Same Day ACH micro-deposit and the user manually verifies the code in as little as one business day.

    Accounts verified via Database Auth, Instant Micro-deposits, or Same-Day Micro-deposits do not have active data connections with a financial institution. These accounts and their associated Items can only be used with Auth and Transfer, not with any other Plaid products (such as Balance or Transactions), with the partial exception of Identity Match and Signal.

    Because of this limitation, accounts verified via these flows may be more vulnerable to fraud or return risk. Consider your level of risk exposure and current anti-fraud measures before enabling these methods. For more details, see Anti-fraud best practices.

    Entry points

    To learn more about when Plaid presents Database Auth, Instant Micro-deposits, or Same-Day Micro-deposits as options, and to customize the Link user experience around these flows, see Configuring entry points.

    Integration instructions

    Most additional Auth flows can be enabled in the Account Verification Dashboard with no additional integration work, as long as the following requirements are met:

    • The country_codes array in /link/token/create is set to ["US"]. Additional Auth flows are not available if other countries are selected.
    • The products array does not contain any products other than auth or transfer. Any other products you want to use must be configured in the additional_consented_products, required_if_supported_products, or optional_products arrays and will be used on a best-effort basis.

    Same-Day Micro-deposits requires additional integration work, as you will need to present a Link UI where the end user can verify the micro-deposit description. For more details, see Same-Day micro-deposits.

    Database Auth, if used in the advanced mode where fallback rules are not configured in the Dashboard, requires additional integration work. For more details, see Database Auth.

    Example of some configuration options available in the Account Verification Dashboard

    Institution coverage

    To see which Auth flows a given institution supports, you can call /institutions/get with options.include_auth_metadata set to true. The results will be returned in the auth_metadata.supported_methods object in the response. Alternatively, you can see this information on the Institution Status page in the Plaid Dashboard. The Same Day Micro-deposits and Database Auth flows will not appear in these results, as they do not depend on institution capabilities and are available at all institutions.

    Was this helpful?
    Developer community
    GitHub
    GitHub
    Stack Overflow
    Stack Overflow
    YouTube
    YouTube
    Discord
    Discord