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 Mode | Description |
---|---|
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.
Scenario | First Name | Last Name | Address | City | State | Postal Code | Country | Date 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