# Scanning Basic
## What is the difference between basic and enhanced?
Please see the table below for a list of features to decide which option fits your business best.
| Feature | basic | enhanced |
| ---------------------------------------- | ----- | -------- |
| Data Extraction | yes | yes |
| Expiration Check | yes | yes |
| Age Check | yes | yes |
| Target Data Matching | yes | yes |
| Automatically Recognizes Document Type | no | yes |
| Automatically Recognizes Document Region | no | yes |
| Enhanced Security Checks | no | yes |
| Selfie Matching | no | yes |
| Expanded International Coverage | no | yes |
## DCAMSPLUS5.0
`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
| Name | Type | Description |
| ----------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user\* | string | Your account's API username |
| pass\* | string | Your account's API password |
| service\* | string | The service name (DCAMSPLUS5.0) |
| rules | string | The rule set name (if left empty then the base rule set will be used) |
| reference | string | A unique identifier for your customer |
| target | object | The individual being sent for verification |
| fn | string | The target's first name |
| ln | object | The target's last name |
| addr | string | The target's street address (line 1 and line 2) |
| city | string | the target's city |
| state | string | The target's state |
| zip | string | The target's zip |
| dob | string | The target's Date of Birth (YYYYMMDD format) |
| license | object | The target's document images and other parameters.*This is not required if you send the passport object* |
| front\* | string | The target's front document image |
| back | string | The target's back document image |
| state | string | The document's state.Only applicable for US documents. If included it can speed up processing times. |
| region | string | The document's region. If this is left empty then United States will be assumed. To verify a document outside of the United States you must include this attribute. Acceptable values are:Asia
Australia
Africa
Canada
Europe
Oceania
South America
United States
|
| passport | object | The target's passport image.*Only required if you are not sending the license object* |
| age | string | The age to check (must be sent like "age+" i.e. "18+", "21+" etc.) |
| test\_key | string | The test key value that you are using to test |
{% tabs %}
{% tab title="200 Transaction processed and result returned" %}
```javascript
{
"output": {
"documents": { //this is the test case data in the system. So, when you use the test_key dcams_pass this si what will be returned.
"FirstName": "LOUISA",
"LastName": "SAMPLE",
"MiddleName": "ANNA",
"Address": "109 S FOSTER RD",
"City": "BATON ROUGE",
"State": "LA",
"Zip": "70808",
"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
"Confidence": 100
}
},
"meta": {
"confirmation": 96095474,
"reference": "12345",
"service": "DCAMSPLUS5.0",
"timestamp": "2020-07-08 14:49:19",
"company": "Company ABC, Inc.",
"user": "user@company.com"
},
"result": {
"action": "PASS",
"detail": "ALL CHECKS PASSED",
"issues": []
}
}
```
{% endtab %}
{% endtabs %}
## Sample Request Body
```javascript
{
"user": "user@company.com",
"pass": "PASSWORD",
"service": "DCAMSPLUS5.0",
"reference": "12345",
"rules": "additional matching rules",
"target": {
"license": { // this object will accept any identity document except a passport i.e. driving license or identity card.
"front": "base64 encoded image file",
"back": "base64 encoded image file",
"state": "CT",
"region": "United States"
},
"passport":{
"front": "base64 encoded image file"
},
"age": "21+",
"fn": "John",
"ln": "Smith",
"dob": "19870621",
"test_key": "dcams_pass"
}
}
```
{% hint style="info" %}
If you send both the `license` and `passport` objects the system will prefer the `license` and ignore the `passport.`If you want to verify a passport please remove the `license` object and only send the `passport` object.
{% endhint %}
## 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.
| test\_key | description |
| -------------------- | ---------------------------------- |
| dcams\_pass | Will return a `PASS` action result |
| dcams\_fail\_expired | Will return a `FAIL` action result |
{% hint style="info" %}
If you are using one of the matching rule sets and want to force a REVIEW then use the `dcams_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.
{% endhint %}
## Action and Detail Responses
The following are all values that will be returned in the result object of the response.
| action | detail | description |
| ------ | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| FAIL | NOT A VALID DOCUMENT | We can not detect the image as a valid identity document |
| FAIL | DOCUMENT NOT VERIFIED | We have detected an identity document, but the confidence level is below the threshold |
| FAIL | DOCUMENT IS EXPIRED | The document's expiration date is in the past |
| FAIL | DOCUMENT AGE CHECK FAILED | The Date of Birth on the document does not meet the minimum age requirement |
| REVIEW | TRANSACTION REQUIRES FURTHER ATTENTION | One of the matching rules was not met (this only happens when using an additional rule set) |
| PASS | ALL CHECKS PASSED | The document is valid, is not expired, the Date of Birth meets the minimum age requirement and additional matching rules all passed. |
## Issues Responses
{% hint style="info" %}
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.
{% endhint %}
| Issue | Description |
| -------------------------------------- | -------------------------------------------------------------------------------- |
| FIRST NAME DOES NOT MATCH THE DOCUMENT | The target's first name does not match the first name discovered on the document |
| LAST NAME DOES NOT MATCH THE DOCUMENT | The target's last name does not match the last name discovered on the document |
| DOB DOES NOT MATCH THE DOCUMENT | The target's DOB does not match the DOB discovered on the document |
| ADDRESS DOES NOT MATCH THE DOCUMENT | The target's address does not match the address discovered on the document |
| STATE DOES NOT MATCH THE DOCUMENT | The target's state does not match the state discovered on the document |
## Rules
DCAMSPLUS5.0 will process with the default base ruleset unless a below rule set value is supplied:
{% hint style="success" %}
The base ruleset will return a PASS when:
* The document is valid
* The document is not expired
* The Date of Birth on the document meets the age requirement
{% endhint %}
{% hint style="warning" %}
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.
{% endhint %}
{% hint style="danger" %}
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
{% endhint %}
## Additional Rule Sets
You can set a new rule set.
| Rule Set Name | Description |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| DCAMS5\_0\_RuleSet\_NAME\_DOB | Base Ruleset + Name and DOB on target must match the document |
| DCAMS5\_0\_RuleSet\_NAME | Base Ruleset + Name on target must match the document |
| DCAMS5\_0\_RuleSet\_NAME\_ADDR | Base Ruleset + Name and Address on target must match the document |
| DCAMS5\_0\_RuleSet\_NAME\_STATE | Base Ruleset + Name and State on target must match the document |
| DCAMS5\_0\_RuleSet\_NAME\_STATE\_DOB | Base Ruleset + Name, State and Date of Birth on target must match the document |
| DCAMS5\_0\_RuleSet\_NAME\_ADDR\_DOB | Base Ruleset + Name, Address and Date of Birth on target must match the document |
{% hint style="success" %}
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.
{% endhint %}
## 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