Testing Auth flows
Testing Instant Match and micro-deposit flows
Sandbox configuration
To test in the Sandbox environment, you need to set the Link configuration environment to "sandbox"
:
1Plaid.create({2 // ...3 env: 'sandbox',4});
You will also want to direct any backend API requests to the sandbox URL:
1https://sandbox.plaid.com
Testing Instant Match
Test credentials
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Institution Name | Houndstooth Bank (ins_109512 ) | –– |
Username | user_good | –– |
Password | pass_good | –– |
Account Selection | Plaid Savings (****1111) | –– |
Routing number | 021000021 | Any other routing number |
Account number | 1111222233331111 | Any other account number |
Entering the Link flow
- Search for “Houndstooth Bank” in Link.
- Use the input data in the table above to simulate the desired outcome.
Testing Instant Micro-deposits
You can also test this flow in Sandbox with no code by using the Link Demo.
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Institution name | Windowpane Bank (ins_135858 ) | –– |
Routing number | 333333334 | Any other value (if testing upgrade path) |
Account number | 1111222233330000 | –– |
Deposit code | ABC | Any other value |
Entering the primary Link flow
- Search for "Windowpane Bank" in Link.
- When prompted, use the input data in the table above to simulate the desired outcome.
- For all other fields, you can use any values.
Testing the upgrade path from Same Day Micro-deposits to Instant Micro-deposits
- If you have enabled Same Day Micro-deposits, enter gibberish into the search bar to ensure no institutions will be found, then click on Link with account numbers.
- If you have configured Same Day Micro-deposits with Auth Type Select, choose "Manually" from the menu.
- When prompted, enter the input data in the table above. For all other fields, you can use any values.
- Note that, unlike the primary Instant Micro-deposits flow, the routing and account number entries will be on separate panes.
Testing Database Match
You can also test this flow in Sandbox with no code by using the Link Demo.
Test credentials
To simulate a database_matched
result:
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233331111 | –– |
Name | John Smith | –– |
To simulate no match and proceed with Same Day Micro-deposits:
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233332222 | –– |
Name | John Smith | –– |
Entering the Link flow
- If you have enabled Database Match, enter gibberish into the search bar to ensure no institutions will be found, then click on Link with account numbers.
- If you have configured Database Match with Auth Type Select, choose "Manually" from the menu.
- Use the input data in the table above to simulate different outcomes.
Testing Database Insights
You can also test this flow in Sandbox with no code by using the Link Demo.
Test credentials
To simulate a database_insights_pass
result:
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233331111 | –– |
Name | John Smith | –– |
To simulate a database_insights_pass_with_caution
result:
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233333333 | –– |
Name | John Smith | –– |
To simulate a database_insights_fail result:
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233332222 | –– |
Name | John Smith | –– |
Entering the Link flow
- If you have configured Database Insights with Auth Type Select, choose "Manually" from the menu.
- If you have configured Database Insights with Embedded Search, choose "Connect Manually".
- If you have enabled Database Insights without either of the above options, enter gibberish into the search bar to ensure no institutions will be found, then click on "Link with account numbers".
- Use input data from the table above to simulate various outcomes.
Testing Automated Micro-deposits
You can also test this flow in Sandbox with no code by using the Link Demo.
Test credentials
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Institution Name | Houndstooth Bank (ins_109512 ) | –– |
Username | user_good | –– |
Password | microdeposits_good | –– |
Account Selection | Plaid Checking (****0000) | –– |
Routing number | 021000021 | Any other routing number |
Account number | 1111222233330000 | Any other account number |
Entering the Link flow
- Search for “Houndstooth Bank” in Link.
- Use the input data in the table above to simulate the desired outcome.
The micro-deposit verification will automatically succeed after twenty-four hours. To test a failed micro-deposit, or to skip the twenty-four hour waiting period, use the /sandbox/item/set_verification_status
endpoint to manually control the Item's micro-deposit verification status.
Testing Same Day Micro-deposits
You can also test this flow with no code by using the Link Demo.
Test credentials
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 110000000 | –– |
Account number | 1111222233330000 | –– |
Deposit code | ABC | Any other value |
Initiating micro-deposits in Link
- If you have configured Same Day Micro-deposits with Auth Type Select, choose "Manually" from the menu
- If you have enabled Same Day Micro-deposits without Auto Type Select, enter gibberish into the search bar to ensure no institutions will be found, then click on "Link with account numbers".
- Use the input data in the table above to simulate the desired outcome.
Verifying micro-deposits in Link
- Call
/item/public_token/exchange
with yourpublic_token
from the Link session in previous step to receive anaccess_token
. - Call
/link/token/create
and provide theaccess_token
from the previous step to receive alink_token
. - Open Link with your
link_token
. - In the deposit code field, enter
ABC
Testing micro-deposit events
Micro-deposits that are generated in Sandbox will never be posted by default.
In order to generate a posted event that you can see when you query /bank_transfer/event/sync
, you can use the /sandbox/bank_transfer/simulate
endpoint.
Simulating a posted event in Sandbox does not generate a webhook. You will need to call /sandbox/bank_transfer/fire_webhook
each time you want a
webhook to be published for testing.
Testing Identity Match with Same Day micro-deposit Items
Sandbox input | Successful credentials | Erroneous credentials |
---|---|---|
Routing number | 011401533 | 110000000 |
Account number | 1111222233330000 | 1111222233330000 |
Deposit code | ABC | ABC |
- Complete the Same Day Micro-deposits flow as detailed above
- Call
/identity/match
using any variation of data in order to test the matching algorithm - The identity data of the test user is as follows:
Field | Sandbox identity |
---|---|
Name | Alberta Bobbeth Charleson |
accountholder0@example.com | |
Phone | 1112223333 |
Street | 2992 Cameron Road |
City | Malakoff |
Region | NY |
Country | US |
Postal Code | 14236 |