Video Identificazione Live

L’API Video Identificazione permette di verificare in modo facile, veloce e soprattutto sicuro l’identità degli utenti a distanza, in accordo con le normative europee. Tramite questa API è possibile erogare qualsiasi tipologia di servizio o prodotto in tempi brevi, senza doversi recare fisicamente presso un ufficio pubblico e riducendo nettamente il rischio di frodi.

Ad oggi su Openapi sono disponibili 3 diversi servizi di video riconoscimento per l’Italia:

In tutti i casi si prevede la verifica dei documenti caricati presso CRIMNET, la piattaforma centralizzata del Ministero degli Interni e del Ministero della Giustizia, che accerta l’assenza di denuncia, furto, smarrimento su questi.

Tutto il processo di identificazione è codificato da Banca d’Italia nella disposizione in materia di Adeguata Verifica della clientela per contrastare il riciclaggio e il finanziamento del terrorismo.

Video identificazione Live

La terza modalità di identificazione, definita Live, è la più utilizzata e consente alle persone di portare a termine autonomamente la procedura di video riconoscimento, in qualsiasi momento della giornata. L'utente viene supportato in tempo reale da un operatore durante tutta la procedura di riconoscimento e la verifica dell'accuratezza dei dati.

Il servizio è identificato dall'endpoint https://videoid.openapi.com/IT-live

ESEMPIO RICHIESTA

POST /IT-live

La procedura di video riconoscimento è molto flessibile e può essere strutturata in base alle esigenze dell’integratore. L'unico campo obbligatorio in fase di richiesta è l'indirizzo email del richiedente.

Già in questa fase è possibile, ma non obbligatorio, passare anche i seguenti dati:

Queste stesse informazioni possono essere ottenute direttamente nello step successivo, durante il processo di identificazione dell’utente.

L’API permette di personalizzare l’esperienza dell’utente mentre effettua la procedura video. Nello specifico si possono customizzare:

In fase di richiesta è possibile anche impostare il formato delll’output della documentazione. Potrebbe trattarsi di:

Tutti i dati sono disponibili anche in formato json.

{
        "callback": {
          "url": "https://mycallback.site/",
          "method": "POST",
          "field": "data",
          "headers": {
            "session_id": "oiwejdf89453urf945jfg"
          }
        },
        "mail": "[email protected]",
        "user": {
          "firstName": "Franco",
          "lastName": "Rossi",
          "gender": "M",
          "birthCountry": "Italia",
          "birthDate": "1977-11-06",
          "birthPlace": "Roma",
          "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 identificazione",
          "logo": "https://www.website.it/logo.png",
          "favicon": "https://www.website.it/favicon.png",
          "backgroundColor": "#cecece",
          "textColor": "#000000",
          "footer": "Company Spa, P.IVA 11111111111"
        }
      }

ESEMPIO RISPOSTA

POST /IT-live

La risposta include i seguenti dati:

{
      "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
    }

Una volta ottenuto il link sarà possibile inviarlo all’utente di cui è necessaria l’identificazione.

Sarà l’integratore a trovare la soluzione più idonea per inviare il link (ad esempio tramite SMS - integrando l’apposito servizio di Openapi - oppure tramite email o mostrandolo direttamente a schermo).

Gli step che l’utente seguirà dopo aver cliccato il link sono predefiniti e prevedono questi passaggi:

La procedura live viene sottoposta a verifica umana secondo linee guide Etsi.

I documenti utilizzabili ai fini dell'identificazione sono:

Per verificare lo stato di una richiesta bisogna effettuare una richiesta API all’endoint GET /IT-identity-verifications/{id}{type} (l’id è quello ottenuto precedentemente).

La risposta conterrà sia il link di quello specifico video riconoscimento, sia le informazioni sullo status della procedura (es. ‘ko’, ‘validation’, ‘running’), sia la motivazione di quest’ultimo.

Quando il processo avrà dato esito positivo, sarà possibile accedere all’audit di processo e marca temporale che ne attesta a livello legale data ed ora dell’esecuzione.

Accesso ai dati

ESEMPIO RICHIESTA

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

In caso di esito positivo (OK), è poi possibile accedere ai dati e alle risorse per i successivi 30 giorni attraverso i parametri:

Con il parametro type si può indicare il formato desiderato per i dati ottenuti durante il processo di video riconoscimento:

ESEMPIO RISPOSTA

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

Questo è un esempio di risposta nel caso si selezioni il type /data:

In qualsiasi momento è possibile ottenere anche l’elenco delle richieste effettuate con informazioni sullo status della procedura, la motivazione dello status e l’id richiesta.

I servizi di video riconoscimento sono attualmente utilizzabili per l'identificazione di cittadini italiani, a prescindere dalla loro residenza, se in possesso di uno dei documenti indicati precedentemente ed in corso di validità. In caso di esito negativo durante il processo è possibile accedere ad informazioni sulla causa del rifiuto, consentendo correzioni o azioni appropriate.

La procedura di riconoscimento tramite video è particolarmente utile per attività di digital onboarding, operazioni commerciali, attivazione SIM, finanziarie e bancarie (ad esempio durante il processo di registrazione presso un istituto bancario).