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:

FieldInput
EmailAny 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 nameLeslie
Last nameKnope
Address one123 Main St.
CityPawnee
Postal code46001
CountryUnited States
StateIndiana
Date of birth01/18/1975
CitizenshipUnited States
SSN123-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

FieldInput
EmailAny 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 nameLeslie
Last nameCarnahan
Address one3545 Carriage Court
CityLake Isabella
Postal code93240
CountryUnited States
StateCalifornia
Date of birth07/07/1961
CitizenshipUnited States
SSN618-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

FieldInput
EmailAny 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 nameEthan
Last nameAdams
Address one362 Lords Way
CityMemphis
Postal code38118
CountryUnited States
StateTennessee
Date of birth08/22/1971
CitizenshipUnited States
SSN758-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

FieldInput
EmailAny 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 nameCarrie
Last nameLee
Address one142 Mount Tabor
CityWhite Plains
Postal code10601
CountryUnited States
StateNew York
Date of birth11/12/1943
CitizenshipUnited States
SSN130-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

FieldInput
EmailAny 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 nameWillie
Last nameRose
Address one4629 Baker Avenue
CityPlano
Postal code75074
CountryUnited States
StateTexas
Date of birth10/01/1964
CitizenshipUnited States
SSN462-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

FieldInput
EmailAny 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 nameEarl
Last nameFletcher
Address one2743 Green Avenue
CityFremont
Postal code94536
CountryUnited States
StateCalifornia
Date of birth02/19/1966
CitizenshipUnited States
SSN610-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

FieldInput
EmailAny 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 nameShirley
Last nameHolden
Address one1985 Sugarfoot Lane
CityLafayette
Postal code47906
CountryUnited States
StateIndiana
Date of birth08/20/1966
CitizenshipUnited States
SSN303-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

FieldInput
EmailAny 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 nameArthur
Last nameMitchell
Address one3952 Oliverio Drive
CityWichita
Postal code67202
CountryUnited States
StateKansas
Date of birth03/28/1961
CitizenshipUnited States
SSN510-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

FieldInput
EmailAny 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 nameBetty
Last nameAlbers
Address one4217 Broadcast Drive
CityBaileys Crossroads
Postal code22041
CountryUnited States
StateVirginia
Date of birth09/01/1959
CitizenshipUnited States
SSN698-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

FieldInput
EmailAny 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 nameDiane
Last nameHudson
Address one2466 Eagle Street
CityHazelwood
Postal code63042
CountryUnited States
StateIllinois
Date of birth03/20/1984
CitizenshipUnited States
SSN351-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

FieldInput
EmailAny 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 nameKevin
Last nameMcElroy
Address one3559 Hawks Nest Lane
CityStlouis
Postal code63101
CountryUnited States
StateMissouri
Date of birth10/13/1973
CitizenshipUnited States
SSN497-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 production

In 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:

FieldInput
EmailAny 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 nameLeslie
Last nameKnope
Address one123 Main St.
CityPawnee
Postal code46001
CountrySwitzerland
StateAargau
Date of birth01/18/1975
CitizenshipSwitzerland

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.


Did this page help you?