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 Attribute	Specific Attribute Value	Expected Outcome	Expected Outcome Description
Name	Unregistered Business	Rejected	The business has no Secretary of State filings. The Business returned will have no associated registrations.
Name	Similar Name Business	Review	The 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.
Address	123 Grand St., New York, NY 10013	Rejected	Unable to identify a match to the submitted Office Address. The submitted address is not found to match any address listed in Business records.
Address	223 Grand St., New York, NY 10013	Review	Identified a similar address. The submitted address is similar to an address that has been found.
Address	423 Grand St., New York, NY 10013	Review	Identified an approximate address. Identified an address within 0.2 miles of the submitted Office Address
Address	Include “cmra” in address_line1 or full_address (i.e 991 cmra st., New York, NY 10013”)	Review	Identified a CMRA address. Submitted Office Address is zoned by USPS as a Commercial Mail Receiving Agency
Address	Include “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”
Address	Include “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”
TIN	110000099	Rejected	TIN Name mismatch. The submitted TIN was found to be associated with a different entity name.
TIN	111222333	Rejected	TIN Name unknown. The submitted TIN’s status is unknown.
Bankruptcy	A business name containing the word bankruptcy	Rejected	The business will have a bankruptcy. The Business will have a bankruptcy attached.
Watchlist	A Business name or Person name containing the phrase watchlist hit.	Rejected	The business or person will have a watchlist hit on them
Industry Classification	Any website	Accepted	The business’ website will have an industry classification
Industry Classification	A website containing the words `highrisk`	Review	The business’ website will have an industry classification with a high risk result.
SOS Filings Domestic	Business Name = “Domestic Missing”	Rejected	Missing Domestic Secretary of State Filing: The business has no domestic filing
SOS Filings Domestic	Business Name = “Domestic Inactive”	Review	Domestic Secretary of State Filing is Inactive: Inactive domestic filing found
SOS Filings Domestic	Business Name = “Domestic Unknown”	Review	Unable to detect status of Domestic Filing: No domestic filing status provided
Liens Found	Business Name = “liens found”	Review	The liens search will return records for this business
Any	Any	Accepted	Verified. 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.

Test data

Each accordion contains a ready-to-use person creation request. All scenarios use the same verification request, shown at the end.

Jerri Hogarth — Review

{
  "first_name": "Jerri",
  "last_name": "Hogarth",
  "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": "hogarthandassoc@example.com",
  "phone_number": "+12125554549",
  "status": "ACTIVE",
  "is_customer": true
}

Foggy Nelstein — Accepted

{
  "first_name": "Foggy",
  "last_name": "Nelstein",
  "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": "nelsonandmurdock@example.com",
  "phone_number": "+19105553605",
  "status": "ACTIVE",
  "is_customer": true
}

Patsy Walker — Accepted

{
  "first_name": "Patsy",
  "last_name": "Walker",
  "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": "TWALKER@EXAMPLE.COM",
  "phone_number": "+12125552916",
  "status": "ACTIVE",
  "is_customer": true
}

Wilson Fisk — Accepted

{
  "first_name": "Wilson",
  "last_name": "Fisk",
  "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": "MR.FISK@EXAMPLE.COM",
  "phone_number": "+12125550921",
  "status": "ACTIVE",
  "is_customer": true
}

Staniel Rand — Review

{
  "first_name": "Staniel",
  "last_name": "Rand",
  "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": "d.s.rand@example.co",
  "phone_number": "+12125556698",
  "status": "ACTIVE",
  "is_customer": true
}

Jessica Jones — Accepted

{
  "first_name": "Jessica",
  "last_name": "Jones",
  "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": "jjones1010@example.com",
  "phone_number": "+12125550412",
  "status": "ACTIVE",
  "is_customer": true
}

Madam Gao — Review

{
  "first_name": "Madam",
  "last_name": "Gao",
  "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": "madam.g@example.com",
  "phone_number": "+12125556698",
  "status": "ACTIVE",
  "is_customer": true
}

Frank Castle — Accepted

{
  "first_name": "Frank",
  "last_name": "Castle",
  "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": "madam.g@example.com",
  "phone_number": "+12125556698",
  "status": "ACTIVE",
  "is_customer": true
}

Colleen Wing — Review

{
  "first_name": "Colleen",
  "last_name": "Wing",
  "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": "madam.g@example.com",
  "phone_number": "+15035557811",
  "status": "ACTIVE",
  "is_customer": true
}

Jane Doe — Review

{
  "first_name": "Jane",
  "last_name": "Doe",
  "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": "test@example.com",
  "phone_number": "+14786011896",
  "status": "ACTIVE",
  "is_customer": true
}

Verification request — identical for every scenario.

{
  "person_id": "{{person_id}}",
  "customer_ip_address": "24.21.33.212",
  "customer_consent": true
}

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

Username	Password	Pin	MFA Code	Answer	Scenario
user_good	pass_good	credential_good			Successful Linking via Instant Auth
user_good	mfa_device		1234		Successful Linking via Instant Auth with MFA Code
user_good	mfa_selections			Yes	Successful Linking via Instant Auth with MFA Selections
user_good	mfaquestions_			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_good	mfaselections			answer_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_good	error_COUNTRY_NOT_SUPPORTED				Error Scenario where the country is not supported
user_good	error_INSTITUTION_DOWN				Error scenario where the institution is down and the accounts cannot be gathered
user_good	error_INSTITUTION_NOT_RESPONDING				Error scenario where the institution is not responding and the accounts cannot be gathered
user_good	error_INSTITUTION_NO_LONGER_SUPPORTED				Error scenario where the institution is longer supported so accounts cannot be linked
user_good	error_INSUFFICIENT_CREDENTIALS				Error scenario where the user hasn’t provided sufficient credentials and the accounts cannot be linked
user_good	error_INTERNAL_SERVER_ERROR				Error scenario where there’s been an internal server error at Plaid
user_good	error_INVALID_CREDENTIALS				Error scenario where the user has entered invalid credentials
user_good	error_INVALID_MFA				Error scenario where the user has entered invalid MFA responses
user_good	error_INVALID_SEND_METHOD
user_good	error_ITEM_LOCKED
user_good	error_ITEM_NOT_SUPPORTED
user_good	error_MFA_NOT_SUPPORTED
user_good	error_NO_ACCOUNTS				Error scenario where there are no valid accounts to pull back from the institution
user_good	error_PAYMENT_INVALID_RECIPIENT
user_good	error_PRODUCTS_NOT_SUPPORTED				Error scenario where the requested products are not supported by the institution being linked
user_good	error_USER_SETUP_REQUIRED

Instant Match Testing Scenarios

Username	Password	Account	Routing Number	Account Number	Institution	Scenario
user_good	pass_good	Plaid (****1111)	11401533	1111222233331111	Houndstooth Bank	Successful Linking via Instant Match
user_good	pass_good	Plaid (****1111)	21000021	1111222233331111	Houndstooth Bank	Successful Linking via Instant Match

Micro Deposit Testing Scenarios

Username	Password	Account	Routing Number	Account Number	Institution	Micro Deposit Amount 1	Micro Deposit Amount 2	Scenario
N/A	N/A	Checking	110000000	1111222233330000	N/A	$0.01	$0.02	Micro Deposits for Checking Account
N/A	N/A	Savings	110000000	1111222233330000	N/A	$0.01	$0.02	Micro Deposits for Savings Account

Overview

Onboard a Personal Customer

Onboard a Business Customer

Create Accounts

Link External Accounts

Link External Cards

Issue Cards

Move Money

Get Transactions

Dispute Transactions

Platform Tools

Use Cases

Sandbox Test Cases

KYB Test Scenarios

KYC Test Scenarios

Test data

Plaid Test Scenarios

Instant Auth Testing Testing Scenarios

Instant Match Testing Scenarios

Micro Deposit Testing Scenarios

​KYB Test Scenarios

​KYC Test Scenarios

​Test data

​Plaid Test Scenarios

​Instant Auth Testing Testing Scenarios

​Instant Match Testing Scenarios

​Micro Deposit Testing Scenarios

KYB Test Scenarios

KYC Test Scenarios

Test data

Plaid Test Scenarios

Instant Auth Testing Testing Scenarios

Instant Match Testing Scenarios

Micro Deposit Testing Scenarios