Selfie Video Identification - Italy

The Video Identification API allows the identity of users to be verified remotely, in an easy and fast manner while ensuring maximum security and full compliance with European regulations.

Integrating this API enables you to provide any type of service or product requiring user identity verification directly online, without needing to visit physical locations such as offices and studios. Additionally, it significantly reduces delivery times and the risk of fraud.

Currently, Openapi offers 3 different video recognition services for Italy:

In all three cases, automatic and real-time verification of the uploaded documents with CRIMNET is provided, the centralized platform of the Ministry of the Interior and the Ministry of Justice that checks for theft or loss reports. Additionally, all methods follow the steps codified by the Bank of Italy in the provision regarding Customer Due Diligence to combat money laundering and terrorism financing.

Selfie Video Identification

With the Selfie method, users can autonomously carry out the entire video recognition procedure at any time of the day. The verification process is carried out by back office operators, asynchronously.

The service is identified by the endpoint https://videoid.openapi.com/IT-selfie

REQUEST EXAMPLE

POST /IT-selfie

The video recognition procedure is very flexible and can be structured according to the integrator's needs. The only mandatory field during the request is the applicant's email address. At this stage, it is possible, but not mandatory, to also provide the following data:

These same details can be obtained directly in the next step, during the user identification process.

The API allows for customizing the user experience while performing the video procedure. Specifically, you can customize:

During the request, you can also set the format of the documentation output. It can be:

All data is also available in JSON format.

{
    "callback": {
      "url": "https://mycallback.site/",
      "method": "POST",
      "field": "data",
      "headers": {
        "session_id": "oiwejdf89453urf945jfg"
      }
    },
    "mail": "[email protected]",
    "user": {
      "firstName": "Franco",
      "lastName": "Rossi",
      "gender": "M",
      "birthCountry": "Italy",
      "birthDate": "1977-11-06",
      "birthPlace": "Rome",
      "taxCode": "RSSMRA02D16A662G"
    },
    "healthCard": {
      "required": true,
      "checkExpire": true
    },
    "phoneNumber": {
      "required": true,
      "editable": true,
      "number": "3331234567"
    },
    "policy": {
      "url": "https://www.company.it/privacy-policy/"
    },
    "redirectUrls": {
      "success": "https://example.com/success",
      "failure": "https://example.com/failure"
    },
    "output": {
      "imagesAsPdf": false
    },
    "layout": {
      "title": "Video Identification",
      "logo": "https://www.website.it/logo.png",
      "favicon": "https://www.website.it/favicon.png",
      "backgroundColor": "#cecece",
      "textColor": "#000000",
      "footer": "Company Spa, VAT 11111111111"
    }
  }

RESPONSE EXAMPLE

POST /IT-selfie

The response includes the following data:

{
  "data": {
    "id": "aaaaaaaa-1111-2222-dddd-123456789",
    "link": "https://sit-openapi.certid.it/aaaaaaaa-1111-2222-dddd-12345678",
    "message": "The link for the automated Video Identification service.",
    "status": "running",
    "owner": "[email protected]"
  },
  "success": true,
  "message": "",
  "error": null
}

Once the link is obtained, it will be possible to send it to the user who needs identification.

The integrator will find the most suitable solution to send the link (for example via SMS - integrating the appropriate Openapi service - or via email or directly displaying it on screen).

The steps the user will follow after clicking the link are predefined and include the following steps:

The selfie procedure is subjected to human verification according to Etsi guidelines.

Documents usable for identification purposes are:

To check the status of a request, an API request must be made to the endpoint GET /IT-identity-verifications/{id}{type} (where the id is the one obtained previously).

The response will contain both the link to that specific video recognition and information about the status of the procedure (e.g., 'ko', 'validation', 'running'), as well as the reason for the status.

When the process is successful, it will be possible to access the process audit and timestamp which legally certifies the date and time of execution.

Access to data

REQUEST EXAMPLE

GET /IT-identity-verifications/{id}{type}

In case of a positive outcome (OK), it is then possible to access the data and resources for the next 30 days through the parameters:

With the type parameter, you can specify the desired format for the data obtained during the video recognition process:

RESPONSE EXAMPLE

GET /IT-identity-verifications/{id}{type}

This is an example of a response when selecting the type /data:

At any time, you can also obtain the list of requests made with information about the status of the procedure, the reason for the status, and the request ID.

Video recognition services are currently available for the identification of Italian citizens, regardless of their residence, provided they hold one of the previously mentioned documents and that it is valid. In case of a negative outcome during the process, it is possible to access information on the cause of the rejection, allowing for corrections or appropriate actions.

The video recognition procedure is particularly useful for digital onboarding activities, commercial operations, SIM activation, financial and banking operations (e.g., during the registration process at a banking institution).