Scanning Enhanced

Instantly scan an identity document for verification purposes.

What is the difference between basic and enhanced?

Veratad offers two levels of document scanning service basic and enhanced. Please see the table below for a list of features to decide which service level fits your business best.

DCAMSPLUS5.0.Enhanced

POST https://docs.idresponse.com/process/comprehensive/gateway

Send a POST request with target parameters along with the document image(s) to receive the verification result.

Request Body

{
    "output": {
        "documents": {
            "FirstName": "LOUISA",
            "LastName": "SAMPLE",
            "MiddleName": "ANNA",
            "FullAddress": "109 S FOSTER RD, BATON ROUGE, LA, 70808-0000",
            "Address": "109 S FOSTER RD",
            "City": "BATON ROUGE",
            "State": "LA",
            "Zip": "70808-0000",
            "DateOfBirth": "19720629",
            "Height": "5-08",
            "Sex": "F",
            "EyeColor": "BRN",
            "DocumentNumber": "003009381",
            "IssueDate": "20140714",
            "ExpirationDate": "20300629",
            "CountryCode": "USA", // (ISO Alpha 2 or 3)
            "DocumentType": "DRIVERS LICENSE" // other values are PASSPORT, IDENTITY CARD and UNKNOWN
        }
    },
    "meta": {
        "confirmation": 97147321,
        "reference": "12345",
        "service": "DCAMSPLUS5.0.Enhanced",
        "timestamp": "2020-07-27 13:11:55",
        "company": "Company ABC, INC",
        "user": "user@company.com"
    },
    "result": {
        "action": "PASS",
        "detail": "ALL CHECKS PASSED",
        "issues": []
    }
}

Sample Request Body

{
  "user": "user@company.com",
  "pass": "PASSWORD",
  "service": "DCAMSPLUS5.0.Enhanced",
  "reference": "12345",
  "rules": "DCAMS5_0_Enhanced_RuleSet_NAME_DOB",
  "target": {
    "document": { // this object will accept any identity document i.e. driving license, identity card or passport.
      "front": "base64 encoded image ",
      "back": "base64 encoded image" // the back is an optional field
      "selfie": "base64 encoded image" // only when using DCAMSPLUS5.0.Enahcned.Selfie as the service
    },
    "age": "21+",
    "fn": "John",
    "ln": "Smith",
    "dob": "19870621",
    "test_key": "dcams_enhanced_pass"
  }
}

Action and Detail Responses

The following are all values that will be returned in the result object of the initial response.

Issues Responses

When a transaction returns as REVIEW then there will be a list of issues. This list can include any of the below values. For this service the REVIEW action will only return if you are not using the base rule set.

Base Rule Set

DCAMSPLUS5.0.Enhanced will process with the default base ruleset unless a below rule set value is supplied:

The base ruleset will return a PASS when:

  • The document has passed all verification checks

  • The document is not expired

  • The Date of Birth on the document meets the age requirement

The base ruleset will return a REVIEW when:

  • The base rule set is not used

  • One or more of the target attributes do not match the document.

The base ruleset will return a FAIL when:

  • The document is not valid

  • The document is expired

  • The Date of Birth on the document does not meet the age requirement

  • The service could not be completed

Additional Rule Sets

You can set a new rule set.

If you do not see a rule set that you would like to use -- please just ask. We can always create a new rule set for your business purpose.

Test Keys

Use the test_key attribute to test the service. When the test_key is provided the system will return a known canned response (regardless of the image submitted) and these transactions are free of charge.

If you are using one of the matching rule sets and want to force a REVIEW then use the dcams_enhanced_pass case and change the input target attributes to something other than the target returned.

For example, the test case's first name is LOUISA, so to get a FIRST NAME DOES NOT MATCH THE DOCUMENT issue just change the target's first name to something other than LOUISA.

Helpful Information

  • The total payload may not exceed 10 MB in size.

  • The minimum image size is 400 pixels on each side of the document

  • For the best results ensure:

    • The image is not blurry

    • There is no glare

    • The document takes up at least 80% of the image

    • The edges are not cut off

    • The document is on a flat surface

Last updated