Test verification sessions
Recommendations and helpful tips for testing the KYC experience in the zerohash SDK.
This guide can assist with testing different scenarios in both cert and prod environments. Be sure you have Webhooks enabled before testing.
Testing guidelines are split into US and non-US residents, as they follow different requirements for onboarding with zerohash. Paths to gain participant status of approvedand of rejectedare outlined.
Certification testing
Non-document capture
If testing for someone whose country = United States and citizenship = United States, then you will only interact with the zerohash SDK.
Result = approved
Fill out the forms in the zerohash SDK with the following information:
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 234-567-8909 |
| First name | Leslie |
| Last name | Knope |
| Address one | 123 Main St. |
| City | Pawnee |
| Postal code | 46001 |
| Country | United States |
| State | Indiana |
| Date of birth | 01/18/1975 |
| Citizenship | United States |
| SSN | 123-45-6789 |
Alternatively, use any of the following test users. Enter each user's details exactly as shown. Each one returns an approved result in cert. The JSON under each user uses the field names and formats from Create customer, so you can copy it into a request. Add any other fields your platform requires.
Test user 1: Leslie Carnahan
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 760-379-3177 |
| First name | Leslie |
| Last name | Carnahan |
| Address one | 3545 Carriage Court |
| City | Lake Isabella |
| Postal code | 93240 |
| Country | United States |
| State | California |
| Date of birth | 07/07/1961 |
| Citizenship | United States |
| SSN | 618-80-5220 |
{
"first_name": "Leslie",
"last_name": "Carnahan",
"email": "[email protected]",
"phone_number": "+17603793177",
"date_of_birth": "1961-07-07",
"address_one": "3545 Carriage Court",
"city": "Lake Isabella",
"zip": "93240",
"postal_code": "93240",
"jurisdiction_code": "US-CA",
"tax_id": "618805220",
"citizenship_code": "US"
}Test user 2: Ethan Adams
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 731-602-6422 |
| First name | Ethan |
| Last name | Adams |
| Address one | 362 Lords Way |
| City | Memphis |
| Postal code | 38118 |
| Country | United States |
| State | Tennessee |
| Date of birth | 08/22/1971 |
| Citizenship | United States |
| SSN | 758-01-5800 |
{
"first_name": "Ethan",
"last_name": "Adams",
"email": "[email protected]",
"phone_number": "+17316026422",
"date_of_birth": "1971-08-22",
"address_one": "362 Lords Way",
"city": "Memphis",
"zip": "38118",
"postal_code": "38118",
"jurisdiction_code": "US-TN",
"tax_id": "758015800",
"citizenship_code": "US"
}Test user 3: Carrie Lee
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 914-549-0089 |
| First name | Carrie |
| Last name | Lee |
| Address one | 142 Mount Tabor |
| City | White Plains |
| Postal code | 10601 |
| Country | United States |
| State | New York |
| Date of birth | 11/12/1943 |
| Citizenship | United States |
| SSN | 130-22-4552 |
{
"first_name": "Carrie",
"last_name": "Lee",
"email": "[email protected]",
"phone_number": "+19145490089",
"date_of_birth": "1943-11-12",
"address_one": "142 Mount Tabor",
"city": "White Plains",
"zip": "10601",
"postal_code": "10601",
"jurisdiction_code": "US-NY",
"tax_id": "130224552",
"citizenship_code": "US"
}Test user 4: Willie Rose
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 817-824-1972 |
| First name | Willie |
| Last name | Rose |
| Address one | 4629 Baker Avenue |
| City | Plano |
| Postal code | 75074 |
| Country | United States |
| State | Texas |
| Date of birth | 10/01/1964 |
| Citizenship | United States |
| SSN | 462-19-3062 |
{
"first_name": "Willie",
"last_name": "Rose",
"email": "[email protected]",
"phone_number": "+18178241972",
"date_of_birth": "1964-10-01",
"address_one": "4629 Baker Avenue",
"city": "Plano",
"zip": "75074",
"postal_code": "75074",
"jurisdiction_code": "US-TX",
"tax_id": "462193062",
"citizenship_code": "US"
}Test user 5: Earl Fletcher
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 510-791-7693 |
| First name | Earl |
| Last name | Fletcher |
| Address one | 2743 Green Avenue |
| City | Fremont |
| Postal code | 94536 |
| Country | United States |
| State | California |
| Date of birth | 02/19/1966 |
| Citizenship | United States |
| SSN | 610-98-2625 |
{
"first_name": "Earl",
"last_name": "Fletcher",
"email": "[email protected]",
"phone_number": "+15107917693",
"date_of_birth": "1966-02-19",
"address_one": "2743 Green Avenue",
"city": "Fremont",
"zip": "94536",
"postal_code": "94536",
"jurisdiction_code": "US-CA",
"tax_id": "610982625",
"citizenship_code": "US"
}Test user 6: Shirley Holden
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 765-497-6539 |
| First name | Shirley |
| Last name | Holden |
| Address one | 1985 Sugarfoot Lane |
| City | Lafayette |
| Postal code | 47906 |
| Country | United States |
| State | Indiana |
| Date of birth | 08/20/1966 |
| Citizenship | United States |
| SSN | 303-13-4159 |
{
"first_name": "Shirley",
"last_name": "Holden",
"email": "[email protected]",
"phone_number": "+17654976539",
"date_of_birth": "1966-08-20",
"address_one": "1985 Sugarfoot Lane",
"city": "Lafayette",
"zip": "47906",
"postal_code": "47906",
"jurisdiction_code": "US-IN",
"tax_id": "303134159",
"citizenship_code": "US"
}Test user 7: Arthur Mitchell
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 620-644-2126 |
| First name | Arthur |
| Last name | Mitchell |
| Address one | 3952 Oliverio Drive |
| City | Wichita |
| Postal code | 67202 |
| Country | United States |
| State | Kansas |
| Date of birth | 03/28/1961 |
| Citizenship | United States |
| SSN | 510-10-3600 |
{
"first_name": "Arthur",
"last_name": "Mitchell",
"email": "[email protected]",
"phone_number": "+16206442126",
"date_of_birth": "1961-03-28",
"address_one": "3952 Oliverio Drive",
"city": "Wichita",
"zip": "67202",
"postal_code": "67202",
"jurisdiction_code": "US-KS",
"tax_id": "510103600",
"citizenship_code": "US"
}Test user 8: Betty Albers
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 703-977-9718 |
| First name | Betty |
| Last name | Albers |
| Address one | 4217 Broadcast Drive |
| City | Baileys Crossroads |
| Postal code | 22041 |
| Country | United States |
| State | Virginia |
| Date of birth | 09/01/1959 |
| Citizenship | United States |
| SSN | 698-03-7879 |
{
"first_name": "Betty",
"last_name": "Albers",
"email": "[email protected]",
"phone_number": "+17039779718",
"date_of_birth": "1959-09-01",
"address_one": "4217 Broadcast Drive",
"city": "Baileys Crossroads",
"zip": "22041",
"postal_code": "22041",
"jurisdiction_code": "US-VA",
"tax_id": "698037879",
"citizenship_code": "US"
}Test user 9: Diane Hudson
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 618-406-0067 |
| First name | Diane |
| Last name | Hudson |
| Address one | 2466 Eagle Street |
| City | Hazelwood |
| Postal code | 63042 |
| Country | United States |
| State | Illinois |
| Date of birth | 03/20/1984 |
| Citizenship | United States |
| SSN | 351-24-3033 |
{
"first_name": "Diane",
"last_name": "Hudson",
"email": "[email protected]",
"phone_number": "+16184060067",
"date_of_birth": "1984-03-20",
"address_one": "2466 Eagle Street",
"city": "Hazelwood",
"zip": "63042",
"postal_code": "63042",
"jurisdiction_code": "US-IL",
"tax_id": "351243033",
"citizenship_code": "US"
}Test user 10: Kevin McElroy
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 314-712-0672 |
| First name | Kevin |
| Last name | McElroy |
| Address one | 3559 Hawks Nest Lane |
| City | Stlouis |
| Postal code | 63101 |
| Country | United States |
| State | Missouri |
| Date of birth | 10/13/1973 |
| Citizenship | United States |
| SSN | 497-28-0220 |
{
"first_name": "Kevin",
"last_name": "McElroy",
"email": "[email protected]",
"phone_number": "+13147120672",
"date_of_birth": "1973-10-13",
"address_one": "3559 Hawks Nest Lane",
"city": "Stlouis",
"zip": "63101",
"postal_code": "63101",
"jurisdiction_code": "US-MO",
"tax_id": "497280220",
"citizenship_code": "US"
}Result = rejected
Fill out the forms in the zerohash SDK with country = United States and citizenship = United States, and use any variation of other fields (e.g. different name, different date of birth, etc.).
You will be requested to upload a copy ID to complete the onboarding flow. This can be a picture of anything like your keyboard for example. The verification session will attempt to match the inputted data with hardcoded PII from Leslie Knope (instead of extracting from the document), and thus fail if you use any other name, date of birth etc. Please do not use a picture of your actual passport in the test environment.
You get 3 attempts to pass document verification, after which the rejected result screen shows.
Note for productionIn production, PII checks may be inconclusive for a United States person and lead to the participant being asked to provide document verification and a liveness check. We call this a fallback scenario, which can improve approval odds.
Document capture
Result = approved
Fill out the forms in the zerohash SDK with the following information:
| Field | Input |
|---|---|
| Any actual email (e.g. [email protected] ) Note: Email uniqueness required so you can use +1, +2, etc. to simulate | |
| Phone number | +1 234-567-8909 |
| First name | Leslie |
| Last name | Knope |
| Address one | 123 Main St. |
| City | Pawnee |
| Postal code | 46001 |
| Country | Switzerland |
| State | Aargau |
| Date of birth | 01/18/1975 |
| Citizenship | Switzerland |
For document capture you have to take a picture of something that looks like an actual photo ID. If it does not fit the format, e.g., a picture of the wall or desk, the document check will fail. You get 3 attempts to pass document verification in one session.
Result = rejected
Fill out the forms in the zerohash SDK with country = United States and citizenship ≠ United States (we recommend Ireland or Switzerland) and use any variation of other fields (e.g. different name, different date of birth, etc.).
You will be requested to upload a copy ID to complete the onboarding flow. This can be a picture of anything like your keyboard for example. The verification session will attempt to match the inputted data with hardcoded PII from Leslie Knope (instead of extracting from the document), and thus fail if you use any other name, date of birth etc. Please do not use a picture of your actual passport in the test environment.
You get 3 attempts to pass document verification, after which the rejected result screen shows.
Liveness checks
Selfie checks are not run in cert, only in prod.
Production testing
There is no guarantee of getting an “approved” result in prod, even if using your actual information. Data is evaluated and verified across personally identifiable information (PII), device risk profiling, email profiling, phone number profiling, document and liveness authenticity checks, and more.
If aiming to test in production with actual user data, remember that email uniqueness is required.
If you run into issues, please report the expected and actual result to zerohash.
Updated 11 days ago