United States
Identity verification via trusted and verified data sources in the United States. This service will also return a KBA quiz for verification.
post
https://production.idresponse.com
/process/comprehensive/gateway
IDMatchPLUS5.0.MULTI
Use the test_key attribute to test the service. When the test_key is provided the system will dynamically drop the live data sources and use the testing database. These transactions are free of charge. To access live data do not send this attribute. The below sample request is one of the available test cases. To access more click the link below.
This is the initial query to get the quiz. See below example of how to submit the answers for final scoring and evaluation.
{
"user": "USERNAME",
"pass": "PASSWORD",
"service": "IDMatchPLUS5.0.MULTI",
"rules": "A_RULESET_ID",
"reference": "12345 {A UNIQUE ID}",
"target":{
"fn":"Barbara",
"ln": "Miller",
"addr": "123 Main St",
"city": "Stratford",
"state": "CT",
"zip": "06614",
"dob": "19740821",
"ssn": "854125698",
"phone": "2015106000",
"email": "[email protected]",
"age": "21+",
"test_key": "general_identity"
}
}
Once your user has answered the questions, send those answers back to the system for scoring and a final evaluation.
post
https://production.idresponse.com
/process/continue
Submit Answers
{
"answers": {
"state3": ["NEW YORK"],
"mothers_maiden0": ["None of the above"],
"phone1": ["(206) 393-4478"],
"county2": ["FAIRFIELD"]
},
"token": "1bauxkpczhdiyy3vqm15ais8ue12u7zw"
}
The following are all values that will be returned in the result object of the response.
Action | Detail | Description |
FAIL | NO MATCH | No matching identity found in the data sources |
FAIL | AGE NOT VERIFIED | Target found, but no DOB information available |
FAIL | TARGET IS DECEASED | Target found as a deceased identity |
FAIL | POSSIBLE MINOR | Target found, but a minor age detected |
REVIEW | TRANSACTION REQUIRES FURTHER ATTENTION | Target found and not deceased, but at least one identity attribute provided does not match. This will also populate the "issues" object with a list of the identity attributes that did not match. See full list below. |
PENDING | MORE INFORMATION IS REQUIRED | Target was found is not deceased and meets the age requirement, but they have not yet answered the quiz. |
PASS | ALL CHECKS PASSED | Target was found is not deceased and meets the age requirement |
When a transaction returns as REVIEW or PENDING then there will be a list of issues. This list can include any of the below values.
Issue | Description |
ADDRESS CHECK FAILED | The address provided does not match any on file |
DATE OF BIRTH CHECK FAILED | The Date of Birth provided does not match any on file |
YEAR OF BIRTH CHECK FAILED | The Year of Birth provided does not match any on file |
MONTH OF BIRTH CHECK FAILED | The Month of Birth provided does not match any on file |
DAY OF BIRTH CHECK FAILED | The Day of Birth provided does not match any on file |
SSN CHECK FAILED | The SSN provided does not match any on file |
MULTIPLE SSNS FOUND | The identity located has more than one SSN associated |
PHONE CHECK FAILED | The Phone Number provided does not match any on file |
EMAIL CHECK FAILED | The Email Address provided does not match any on file |
AGE CHECK FAILED | The target does not meet the minimum age requirement |
POSSIBLE MINOR | A DOB detected that indicates the user may be under your age requirement |
QUESTION CHECK FAILED | The user did not answer at least 3/4 questions correct |
IDMatch+PLUS will process with the default base ruleset:
The base ruleset will return a PASS when:
- A match is found
- The target is not deceased
- The target has provided all valid identity attributes
- The user has answered at least 3/4 questions correct
The base ruleset will return a REVIEW when:
- A match is found
- The target is not deceased
- The target's identity attributes do not all match or they failed the quiz
The base ruleset will return a PENDING when:
- A match found
- The target is not deceased
- Questions are returned, but not answered yet
The base ruleset will return a FAIL when:
- A match is not found or
- The target is deceased
In this case no questions will be provided.
Each token is only valid for 90 seconds with this service. See the error responses to get information on what happens if a token is bad or expired.
Last modified 2yr ago