Sandbox Test Cases

KYB Test Scenarios

These test cases are intended to be used with the KYC/KYB Verification guide to demonstrate multiple possible flows.

Specific Test AttributeSpecific Attribute ValueExpected OutcomeExpected Outcome Description
NameUnregistered BusinessRejectedThe business has no Secretary of State filings. The Business returned will have no associated registrations.
NameSimilar Name BusinessReviewThe business has a Secretary of State filing with a similar name to the submitted business name. The "name" review task indicates that a similar name was found to the submitted name.
Address123 Grand St., New York, NY 10013RejectedUnable to identify a match to the submitted Office Address. The submitted address is not found to match any address listed in Business records.
Address223 Grand St., New York, NY 10013ReviewIdentified a similar address. The submitted address is similar to an address that has been found.
Address423 Grand St., New York, NY 10013ReviewIdentified an approximate address. Identified an address within 0.2 miles of the submitted Office Address
AddressInclude "cmra" in address_line1 or full_address (i.e 991 cmra st., New York, NY 10013")ReviewIdentified a CMRA address. Submitted Office Address is zoned by USPS as a Commercial Mail Receiving Agency
AddressInclude "registered agent" in address_line1 or full_address (i.e 991 registered agent st., New York, NY 10013")Review"Identified a Registered Agent address:
Submitted Office Address is actually the address of a Registered Agent, not the actual business"
AddressInclude "undeliverable" in address_line1 or full_address (i.e 991 st. undeliverable, New York, NY 10013"Rejected"Identified an Undeliverable address:
The USPS is unable to deliver mail to the submitted Office Address"
TIN110000099RejectedTIN Name mismatch. The submitted TIN was found to be associated with a different entity name.
TIN111222333RejectedTIN Name unknown. The submitted TIN's status is unknown.
BankruptcyA business name containing the word bankruptcyRejectedThe business will have a bankruptcy. The Business will have a bankruptcy attached.
WatchlistA Business name or Person name containing the phrase watchlist hit.RejectedThe business or person will have a watchlist hit on them
Industry ClassificationAny websiteAcceptedThe business' website will have an industry classification
Industry ClassificationA website containing the words highriskReviewThe business' website will have an industry classification with a high risk result.
SOS Filings DomesticBusiness Name = "Domestic Missing"RejectedMissing Domestic Secretary of State Filing: The business has no domestic filing
SOS Filings DomesticBusiness Name = "Domestic Inactive"ReviewDomestic Secretary of State Filing is Inactive: Inactive domestic filing found
SOS Filings DomesticBusiness Name = "Domestic Unknown"ReviewUnable to detect status of Domestic Filing: No domestic filing status provided
Liens FoundBusiness Name = "liens found"ReviewThe liens search will return records for this business
AnyAnyAcceptedVerified. If none of the above inputs match, the Business will fallback to verifying all information. Given most inputs then, you can expect to receive a Review object with successful tasks.

KYC Test Scenarios

These test cases are intended to be used with the KYC/KYB Verification guide to demonstrate multiple possible flows.

Person Creation RequestVerification RequestExpected OutcomeActual Outcome
{ "last_name": "Hogarth", "first_name" :"Jerri", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "12620 PADDINGTON AVE", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10001", "country_code": "US" }, "dob": "1976-08-09", "ssn": "293-00-1642", "email": "[email protected]", "phone_number": "+12125554549", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }ReviewReview
{ "last_name": "NELSTEIN", "first_name" :"FOGGY", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "1456 Holman Rd Apt 192", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10001", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+19105553605", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }AcceptedAccepted
{ "last_name": "WALKER", "first_name" :"PATSY", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "3092 HUDSON ST 7TH FL", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10014", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+12125552916", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }AcceptedAccepted
{ "last_name": "FISK", "first_name" :"WILSON", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "3116 S 4TH ST", "address_line_2": "", "city": "Brooklyn", "state": "NY", "postal_code": "11211", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+12125550921", "status" : "ACTIVE","is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }AcceptedAccepted
{ "last_name": "RAND", "first_name" :"STANIEL", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "82 CORPORATION AVE", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10013", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+12125556698", "status" : "ACTIVE","is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }ReviewReview
{ "last_name": "JONES", "first_name" :"JESSICA", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "5035 W 43RD ST", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10036", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+12125550412", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }AcceptedAccepted
{ "last_name": "GAO", "first_name" :"MADAM", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "130 IRONSIDE ST.", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10001", "country_code": "US" }, "dob": "1981-01-29", "ssn": "600-00-2071", "email": "[email protected]", "phone_number": "+12125556698", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }ReviewReview
{ "last_name": "CASTLE", "first_name" :"FRANK", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "2243 W 43RD ST", "address_line_2": "", "city": "New York", "state": "NY", "postal_code": "10036", "country_code": "US" }, "dob": "1973-09-22", "ssn": "234-00-0168", "email": "[email protected]", "phone_number": "+12125556698", "status" : "ACTIVE","is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }AcceptedAccepted
{ "last_name": "WING", "first_name" :"COLLEEN", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "2922 HUNTINGTON DRIVE", "address_line_2": "", "city": "Forest Grove", "state": "OR", "postal_code": "97123", "country_code": "US" }, "dob": "1987-11-11", "ssn": "732-00-4625", "email": "[email protected]", "phone_number": "+15035557811", "status" : "ACTIVE", "is_customer":true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }ReviewReview
{ "last_name": "Doe", "first_name" :"Jane", "legal_address": { "default_address_flg": true, "type": "home", "address_line_1": "831 SW Zachary Walks Crest E", "address_line_2": "", "city": "Lake Patriciabury", "state": "TN", "postal_code": "83192", "country_code": "US" }, "dob": "2001-08-04", "ssn": "585-50-6107", "email": "[email protected]", "phone_number": "+14786011896", "status" : "ACTIVE", "is_customer": true }{ "person_id": "{{person_id}}", "customer_ip_address": "24.21.33.212", "customer_consent": true }ReviewReview

Plaid Test Scenarios

These test cases are intended to be used with the external accounts guide to demonstrate multiple possible flows.

Instant Auth Testing Testing Scenarios

UsernamePasswordPinMFA CodeAnswerInstitutionScenario
user_goodpass_goodcredential_goodSuccessful Linking via Instant Auth
user_goodmfa_device1234Successful Linking via Instant Auth with MFA Code
user_goodmfa_selectionsYesSuccessful Linking via Instant Auth with MFA Selections
user_goodmfaquestions_answer"Successful Linking via Instant Auth with MFA Questions
n-rounds of m-questions per round, where 0 <= i, j < 9
answer, for j-th question in i-th round."
user_goodmfaselectionsanswer_1_1_0"Successful Linking via Instant Auth with Multiple MFA Selections
n-rounds of m-questions with o-answers per question
0 < n, m < 10 and 2 <= o < 10
answer_0, for m-th question in n-th round"
user_gooderror_COUNTRY_NOT_SUPPORTEDError Scenario where the country is not supported
user_gooderror_INSTITUTION_DOWNError scenario where the institution is down and the accounts cannot be gathered
user_gooderror_INSTITUTION_NOT_RESPONDINGError scenario where the institution is not responding and the accounts cannot be gathered
user_gooderror_INSTITUTION_NO_LONGER_SUPPORTEDError scenario where the institution is longer supported so accounts cannot be linked
user_gooderror_INSUFFICIENT_CREDENTIALSError scenario where the user hasn't provided sufficient credentials and the accounts cannot be linked
user_gooderror_INTERNAL_SERVER_ERRORError scenario where there's been an internal server error at Plaid
user_gooderror_INVALID_CREDENTIALSError scenario where the user has entered invalid credentials
user_gooderror_INVALID_MFAError scenario where the user has entered invalid MFA responses
user_gooderror_INVALID_SEND_METHOD
user_gooderror_ITEM_LOCKED
user_gooderror_ITEM_NOT_SUPPORTED
user_gooderror_MFA_NOT_SUPPORTED
user_gooderror_NO_ACCOUNTSError scenario where there are no valid accounts to pull back from the institution
user_gooderror_PAYMENT_INVALID_RECIPIENT
user_gooderror_PRODUCTS_NOT_SUPPORTEDError scenario where the requested products are not supported by the institution being linked
user_gooderror_USER_SETUP_REQUIRED

Instant Match Testing Scenarios

UsernamePasswordAccountRouting NumberAccount NumberInstitutionScenario
user_goodpass_goodPlaid (****1111)114015331111222233331111Houndstooth BankSuccessful Linking via Instant Match
user_goodpass_goodPlaid (****1111)210000211111222233331111Houndstooth BankSuccessful Linking via Instant Match

Micro Deposit Testing Scenarios

UsernamePasswordAccountRouting NumberAccount NumberInstitutionMicro Deposit Amount 1Micro Deposit Amount 2Scenario
N/AN/AChecking1100000001111222233330000N/A$0.01$0.02Micro Deposits for Checking Account
N/AN/ASavings1100000001111222233330000N/A$0.01$0.02Micro Deposits for Savings Account