Testing all Auth flows

Learn how to test all four Auth flows in the Plaid Sandbox

Sandbox configuration

To test in the Sandbox environment, you need to set the Link configuration environment to "sandbox":

1
2
3
4
Plaid.create({
// ...
env: 'sandbox',
});

You will also want to direct any backend API requests to the sandbox URL:

1
https://sandbox.plaid.com

Not all Plaid Developer accounts are enabled for Instant Match, Automated Micro-deposits, or Same Day Micro-deposits by default. Your account must be enabled for these features in order to test them in Sandbox. To enable these features or check your status, contact your account manager or submit a product access ticket.

Testing Instant Match

Test credentials
Sandbox inputSuccessful credentialsErroneous credentials
Institution NameHoundstooth Bank (ins_109512)––
Usernameuser_good––
Passwordpass_good––
Account SelectionPlaid Savings (****1111)––
Routing number021000021 or 011401533Any other routing number
Account number1111222233331111Any other account number
Testing the Link flow
  • Search for “Houndstooth Bank” in Link.
  • Enter user_good and pass_good in the Credential pane.
  • Select the second account that is returned: Plaid Savings (****1111).
  • In the Routing number input, enter: 021000021 or 011401533
  • In the Account number input, enter: 1111222233331111
  • Link will display the success view – click continue to trigger the onSuccess callback with a public_token.

Testing Automated Micro-deposits

Note that micro-deposit-based flows cannot be tested in the Development environment. To test this flow, use either Sandbox (using the instructions below) or Production.

Test credentials
Sandbox inputSuccessful credentialsErroneous credentials
Institution NameHoundstooth Bank (ins_109512)––
Usernameuser_good––
Passwordmicrodeposits_good––
Account SelectionPlaid Checking (****0000)––
Routing number021000021 or 011401533Any other routing number
Account number1111222233330000Any other account number
Testing the Link flow
  • Search for “Houndstooth Bank” in Link.
  • Enter user_good and microdeposits_good in the Credential pane.
  • Select the first account that is returned: Plaid Checking (****0000)
  • In the Routing number input, enter: 021000021 or 011401533
  • In the Account number input, enter: 1111222233330000
  • Enter your legal first and last name.
  • Select personal as the account type.
  • Link will display the Automated Micro-deposit success view – click continue to trigger the onSuccess callback with a public_token.

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

Note that micro-deposit-based flows cannot be tested in the Development environment. To test this flow, use either Sandbox (using the instructions below) or Production.

Test credentials
Sandbox inputSuccessful credentialsErroneous credentials
Routing number110000000Any other routing number
Account number1111222233330000Any other account number
Deposit amount #1$0.01Any other value
Deposit amount #2$0.02Any other value
Initiating micro-deposits in Link
  • Search for an institution that is not yet supported: “XYZ”, click on connect your bank manually.
  • Select “checking” or “savings” as the account type.
  • In the Routing number input, enter: 110000000
  • In the Account number input, enter: 1111222233330000
  • Link will display the success view – click continue to trigger the onSuccess callback with a public_token.
Verifying micro-deposits in Link
  • Call /item/public_token/exchange with your public_token from the previous step to receive an access_token.
  • Call /link/token/create and provide the access_token from the previous step to receive a link_token.
  • Open Link with your link_token.
  • In the first deposit input, enter $0.01
  • In the second deposit input, enter $0.02
  • You have successfully verified your micro-deposits – click continue to close Link successfully.