W2 DVFC 047 ​

About the service ​

W2 DVFC 047 is a digitized and AML-compliant (Anti-money laundering) method of automated identity verification that uses AI technology to reliably identify users.

DVFC offers a simple process to reliably identify users.

1. Create a session. (This will include submitting basic textual data of the user you are attempting to identify, which will generate a session url)
2. Submitting physical documents. (i.e. Passport, Id, etc.)
3. Information is processed.
4. Result is returned via our webhook and stored in the results section on the case. Click Here to view potential responses returned.

Product Code: W2_DVFC_047

Does this service leave a credit search Footprint? No

Create ​

The section below describes how to create a session.

How to use ​

To call the endpoint you will need to perform a HTTP POST request to the URL:

Request ​

The following properties pertain for creation of an session.

Notes ​

DayOfBirth, MonthOfBirth and YearOfBirth are optional parameters, but if a date is provided then all three fields must be populated, (i.e. 08/2025 - Not Accepted, 12/08/2025 - Accepted).

CaseId or ClientReference must be provided to use this endpoint. If a CaseId is not provided then a case will automatically be created upon the creation of a session, but a ClientReference must be provided. If a CaseId is provided then your session information will be created and linked to your existing Case.

ConfCode is optional however a default configuration will be used when no ConfCode is provided. Please consult about the use of this during onboarding. The configuration available is explained in the Custom Configuration section.

Example Request ​

{
  "dayOfBirth": 23,
  "monthOfBirth": 5,
  "yearOfBirth": 1987,
  "email":"[email protected]",
  "firstname":"Erika",
  "gender":"FEMALE",
  "lastname":"Musterman",
  "mobilephone":"+441763109660",
  "nationality":"GB",
  "zipcode":"W1U",
  "preferredLang":"en",
  "clientReference": "o199i-2idjjj3x",
  "caseId": "581ebe6d-9b1b-4b92-a057-e4d5cbb34012",
  "confCode": "custom-conf-p-selfie-01"
}

Example Response ​

{
    "CustomerIdentificationUrl": "https://{example_url}/session/{sessionId}",
    "CaseId": "581ebe6d-9b1b-4b92-a057-e4d5cbb34012",
    "SessionId": "{sessionId}"
}

Custom Configuration ​

The following customizations are available when creating a DVFC 047 session:

Each DocsToCapture is a seperate document definition and can contain multiple accepted documents or verification types. DocsToCapture has the following properties:

Notes ​

The CustomerIdentificationUrl provided upon successful creation of a session has an expiry time of 1 day. The session is needed only for the submission of information, so once the information is submitted for identification, it is no longer required and the result of the identification can be monitored from the Case to which it's attached.

However, if you have not started or completed the submition of information and your session expires you simply need to call the create endpoint with the existing case id (whether it was created as part of the original submission or whether it is an existing Case which you provided), and a new CustomerIdentificationUrl will be supplied.

Get Full Result ​

The section below describes how to get a full result for a session.

How to use ​

To call the endpoint you will need to perform a HTTP GET request to the URL:

Response ​

The following properties pertain for results retrieval of a session.

Example Response ​

{
  "onboardingResults": {
    "status": "CREATED",
    "errorCause": {
      "code": "NETWORK_ERROR",
      "details": "string"
    },
    "documentsCaptured": [
      {
        "documentsCaptured": [
          "string"
        ],
        "type": "string",
        "source": "WIDGET_CAMERA",
        "qualityIssues": true
      }
    ]
  },
  "fileAnalysisResults": {
    "creationDate": "string",
    "verdict": {
      "causeOfRejection": "DATA_NOT_MATCH",
      "errorCauseMessage": "string",
      "status": "SUCCESS"
    },
    "analysisReport": {
      "checksPerformed": [
        {
          "title": "string",
          "status": "NONE",
          "documentsAnalysed": [
            "string"
          ],
          "checksPerformed": [
            {
              "name": "string",
              "resonMessages": [
                "string"
              ],
              "status": "NONE",
              "subChecks": [
                "string"
              ]
            }
          ],
          "documentsOCR": [
            {
              "category": "string",
              "label": "string",
              "value": "string"
            }
          ]
        }
      ]
    }
  }
}

Response Breakdown ​

OnboardingCaptureResult ​

OnboardingCaptureResult - OnboardingEndErrorCause ​

OnboardingCaptureResult - CapturedDocuments ​

FileAnalysisResult ​

FileAnalysisResult - AnalysisReport ​

FileAnalysisResult - Analysis Report - DocumentVerificationCheck ​

FileAnalysisResult - Analysis Report - DocumentVerificationCheck - AnalysisCheck ​

FileAnalysisResult - Analysis Report - DocumentVerificationCheck - DocumentOCR ​