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 Zero Hash. 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 Zero Hash SDK.

Result = approved

Fill out the forms in the Zero Hash SDK with the following information:

Result = rejected

Fill out the forms in the Zero Hash 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 Zero Hash SDK with the following information:

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 Zero Hash 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 Zero Hash.