Use the Secure ID Verification Simulator

Develop and test using the simulator before using the service in a production environment with live data.

When your Sudo Platform instance is configured and Secure ID Verification is enabled, the service may be enabled in one of two modes, each of which will verify identities using different data sources.

Verification ModeDescription

Simulator

Well-known inputs of identity data for testing purposes, producing predictable results.

Live

All identity verification is performed using live data sources. In this mode, there is no simulator data.

Simulator Mode

In simulator mode, different combinations of known data can be provided to the verifyIdentity API to extract specific results. The table below lists the data that can be provided to the Secure ID Verification service operating in simulator mode.

ScenarioFirst NameLast NameAddressCityStatePostal CodeCountryDate of Birth (yyyy-mm-dd)Verified?

Valid identity

John

Smith

222333 Peachtree Place

Atlanta

GA

30318

USA

1975-02-28

Yes

Valid identity

John

Smith

222333 Peachtree Place

(omitted)

(omitted)

30318

USA

1975-02-28

Yes

Incorrect street name

John

Smith

222333 Magnolia

Atlanta

GA

30318

USA

1975-02-28

No

Incorrect street number and street name

John

Smith

2240 Magnolia

Atlanta

GA

30318

USA

1975-02-28

No

Incorrect street number

John

Smith

2240 Peachtree Place

Atlanta

GA

30318

USA

1975-02-28

No

Incorrect ZIP code

John

Smith

222333 Peachtree Place

Atlanta

GA

30316

USA

1975-02-28

No

Incorrect state

John

Smith

222333 Peachtree Place

Atlanta

AL

30318

USA

1975-02-28

No

Newer address available

John

Smith

3612 Any St

Atlanta

GA

30318

USA

1975-02-28

No

Address is typically not residential (hotel, hospital)

John

Smith

8888 Any St

Atlanta

GA

30318

USA

1975-02-28

No

Incorrect year of birth

John

Smith

222333 Peachtree Place

Atlanta

GA

30318

USA

1970-02-28

No

Incorrect month of birth

John

Smith

222333 Peachtree Place

Atlanta

GA

30318

USA

1975-03-28

No

Person is deceased

James

Williams

5555 Mountain Rd

Rockmart

GA

30153

USA

1975-03-28

No

Almost all of these tests can also be run where the test data omits the city and state, i.e. sets them to undefined. The exception is the invalid state test case.

All other combinations of input data will result in identity verification failure.

ID Document Test Images

Each of the SDKs provide test data that can be used to test ID document verification with the simulator. ID document images are provided in a variety of image formats supported by the Secure ID Verification service.

The test ID document images can be used directly with the Secure ID Verification SDKs. In the case of developing and testing mobile or web applications, the images can also be loaded into the device's photos app or file system and accessed from those locations, so long as there is no more than minimal changes to the image quality.

In environments where a face image is required as part of ID document verification processing, the SDKs also provides images that represent where the face image is a match for the ID document, and where the face image is not a match for the ID document.

Live Mode

The Secure ID Verification service will initially be configured in Simulator mode so that familiarization and development can commence. Live, production environments are configured separately, with no co-mingling of simulator based verification and live data based verification. A new Secure ID Verification instance configured in live mode will be available only after review with the Sudo Platform team, ensuring that the data protection responsibilities shared between you and the Sudo Platform are clear and understood.

Last updated