DocuPass Live Mobile Introduction

DocuPass Live Mobile is our latest identity verification app that allows you to to verify your user without writing lengthy codes, it features newest live document scanning technology directly through mobile phone camera stream, along with instant face verification and liveness check. The DocuPass Live Mobile module greatly improves user experience comparing to the Mobile module by reducing the overall time required to finish the verification process.

DocuPass Live Mobile does not require end-user to install any app on their phone, users can start verifying themselves by scanning QR code or using an URL. The module can also be embedded into native iOS or Android App using in-app-browser components to provide even better user experience.

Creating Verification Request

You need to create a verification request for every user requiring identity verification, to do so, submit a POST request to:

https://api.idanalyzer.com/docupass/create

The API supports both x-www-form-urlencoded and application/json POST payload, it is up to you to decide the format but be sure to set the correct Content-Type header in your request.

Required Parameters

Optional Parameters

Sample Code

$url = "https://api.idanalyzer.com/docupass/create";
$apikey = "Your API Key";
$companyname = "Your Company";
$type = 3;
$callbackurl = "https://mywebsite.com/callback.php";
$customid = "testid123";

$fields = array('callbackurl' => $callbackurl, 'customid' => $customid, 'companyname' => $companyname, 'type' =>  $type, 'apikey' => $apikey);
$resource = curl_init();
curl_setopt($resource, CURLOPT_URL, $url);
curl_setopt($resource, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($resource, CURLOPT_POST, 1);
curl_setopt($resource, CURLOPT_POSTFIELDS, $fields);
$result = json_decode(curl_exec($resource),true);
curl_close($resource);

if(!array_key_exists('error', $result)){
	//success
	print_r($result);
}else{
	//failed
	echo("Error #" . $result['error']['code'] . " " . $result['error']['message']);
}

import requests

apikey = "Your API Key"
companyname = "Your Company"
type = 3
callbackurl = "https://mywebsite.com/callback.php"
customid = "testid123"

payload = {'callbackurl': callbackurl, 'customid': customid, 'companyname': companyname, 'type':  type, 'apikey': apikey}
r = requests.post("https://api.idanalyzer.com/docupass/create", data=payload)
result = r.json()
if "error" in result:
    #failed
    print("Error #" + str(result['error']['code']) + " " + result['error']['message'])
else:
    #success
    print(result['result'])

Reading Response

If all the parameters are valid, API will return a JSON response:

{
    "reference": "AFNWUQG9C2X",
    "type": 3,
    "customid": "testid123",
    "url": "https://docupass.app/AFNWUQG9C2X",
    "qrcode": "https://api.idanalyzer.com/qr/AFNWUQG9C2X.png",
    "base_url": "https://docupass.app",
    "html": "<h3>Scan QR Code below to start identity verification.</h3><p><img src=\"https://api.idanalyzer.com/qr/AFNWUQG9C2X.png\" alt=\"QR Code\"/></p><p>Or visit <strong>https://docupass.app</strong> on your mobile phone and enter reference code:</p><h3>AFNWUQG9C2</h3>"
}

Instructing Your Users

There are two ways for your users to begin a mobile identity verification:

1. Display the QR Code image for your user to scan

2. Ask your user to navigate to the base_url and enter the reference code

As seem from the sample html code returned by our API below, it is possible to present both methods and it would be up to your user to decide if they are going to scan the QR code or manually enter the address and reference code.

<h3>Scan QR Code below to start identity verification.</h3>
<p><img src=\"https://api.idanalyzer.com/qr/AFNWUQG9C2.png\" alt=\"QR Code\"/></p>
<p>Or visit <strong>https://docupass.app</strong> on your mobile phone and enter reference code:</p>
<h3>AFNWUQG9C2</h3>

View Demo

Embedding into Native Apps

It is possible to embed DocuPass lve mobile modules into your native mobile applications.

For iOS 14 or earlier, it is not possible to embed this module into WKWebView due to lack of support for GetUserMedia API, therefore you should open verification URL with Safari. Nevertheless, full support is available after iOS 14 Beta 2.

For Android, create a WebView and navigate to the URL given by DocuPass API.

You can add both successredir and failedredir parameter when creating verification requests, and listen for URL changes in your WebView. This way your app knows verification has been completed without having to poll your server for results.

Processing Callback

DocuPass API will send a callback to your server whenever user completes identity verification, you have to either implement a script to process the callback, or manually inspect verification results in vault.

DocuPass Callback Guide