Support Auth for all US financial institutions
Overview
Instant Auth covers approximately 95% of users' eligible bank accounts.For the remaining ~5%, Plaid offers users the ability toconnect their accounts through a combination of verifying micro-deposits and accountcredentials.
Our video tutorial also provides a comprehensive guide to adding Auth using all the flows
To support Auth for all of your users, this guide will show you how to build the following Auth flows:
- Instant Auth: User enters their credentials and is authenticated immediately. This is the default flow. No extra steps are necessary to enable Instant Auth if you have already integrated Auth into your app.
- Instant Match (US only): User enters their credentials, account number, and routing number. Plaid matches user input and authenticates immediately. No extra steps are necessary to enable Instant Match if you have already integrated Auth into your app; it will appear automatically as long as
country_codes
is set to['US']
. - 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. Beginning November 1, 2023, no extra steps will be necessary to enable Instant Micro-deposits; it will be automatically enabled as long as
country_codes
is set to['US']
andauth
is the only product in theproducts
array. - 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.
Plaid will attempt to use the flows in the order of preference listed above. For example, the Automated Micro-deposits flow will only be used if both Instant Match and Instant Auth are unavailable for a given institution.
Accounts verified with account numbers (using 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 and Transfer not with any other Plaid products (such as Balance or Signal) with the partial exception of Identity Match.
For each of these flows, Plaid will automatically prompt the user for the appropriate information. If a usercannot find their financial institution when searching, Plaid Link will prompt them tolink with account numbers, where they can enter the Instant Micro-deposits or Same Day Micro-deposits flow.
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.
Each section in this guide is broken down into steps and supporting code samples.
Database Match (coming soon)
For returning users, Database Match can verify account details provided in Link without micro-deposits, reducing friction for accounts that can't be verified via Instant Auth or Instant Match.
Database Match is ideal for use cases where additional products like Balance, Signal, or Transactions aren’t required. Database Match does not confirm the user's access to the account, but confirms the presence of the account as previously authenticated in the Plaid network.
Database Match can be enabled after a user has indicated they want to continue down a manual flow, prior to micro-deposits, or on the embedded search module.
To apply for the Database Match beta, complete the Database Match beta application.
Next steps
Instant Auth, Instant Match, and Instant Micro-deposits
Support the most common Auth flows
View guideAutomated Micro-deposits
Integrate the automated micro-deposit flow
View guideSame Day Micro-deposits
Integrate the manual micro-deposit flow
View guideMicro-deposit events
Learn how to use Bank Transfers webhooks to receive micro-deposit status updates
View guideAs a seasoned expert in financial technology and authentication processes, I bring a wealth of knowledge and hands-on experience in developing secure and efficient systems for user authentication. My expertise extends to the intricacies of Plaid, a leading platform in the financial technology space, and its various authentication flows designed to support a wide array of US financial institutions.
The information presented in the article outlines the comprehensive approach taken by Plaid to ensure authentication support for all users, covering approximately 95% of eligible bank accounts with Instant Auth. For the remaining ~5%, Plaid offers alternative methods such as connecting accounts through micro-deposits and account credentials verification.
Let's delve into the key concepts and authentication flows discussed in the article:
-
Instant Auth:
- This is the default flow where users enter their credentials and are authenticated immediately.
- No extra steps are necessary if Auth is already integrated into the app.
-
Instant Match (US only):
- Users enter credentials, account number, and routing number for immediate authentication.
- It appears automatically if country_codes is set to ['US'] and Auth is integrated.
-
Automated Micro-deposits (US only):
- Users provide credentials, account number, and routing number.
- Plaid makes a micro-deposit and verifies it automatically in one to two business days.
-
Instant Micro-deposits (US only):
- Users enter account and routing numbers.
- Plaid makes an RTP or FedNow micro-deposit, and users manually verify the code in as little as 5 seconds.
-
Same Day Micro-deposits (US only):
- Users enter account and routing numbers.
- Plaid makes a Same Day ACH micro-deposit, and users manually verify the code in as little as one business day.
-
Flow Preference:
- Plaid attempts to use flows in the order of preference listed above, choosing the most efficient method available.
-
Account Verification:
- Accounts verified with Instant Micro-deposits or Same-Day Micro-deposits have no active data connections with a financial institution.
- They can only be used with Auth and Transfer, with a partial exception for Identity Match.
-
Checking Institution Support:
- Use /institutions/get with options.include_auth_metadata set to true to check which Auth flows a given institution supports.
- Alternatively, check the Institution Status page in the Plaid Dashboard for this information.
-
Database Match (coming soon):
- Database Match verifies account details without micro-deposits for returning users.
- Ideal for cases where additional products like Balance, Signal, or Transactions aren't required.
-
Next Steps:
- Guides are provided for each Auth flow: Instant Auth, Instant Match, Automated Micro-deposits, Same Day Micro-deposits, and Micro-deposit events.
- Additionally, Database Match, a feature for returning users, is outlined as a forthcoming development.
In conclusion, this comprehensive guide equips developers with the knowledge and tools to implement robust authentication processes for users across various US financial institutions using Plaid's diverse set of authentication flows.