Video Identificazione Automatica

L’API Video Identificazione consente di verificare l’identità degli utenti a distanza, in maniera facile e veloce, garantendo allo stesso tempo la massima sicurezza e la completa compliance con le normative europee.

L'integrazione di questa API permette di erogare direttamente online qualsiasi tipologia di servizio o prodotto che preveda l’obbligo della verifica dell’identità dell’utente, senza che ci si debba recare in luoghi fisici come uffici e studio. Inoltre, consente di ridurre notevolmente i tempi di erogazione ed il rischio di frodi.

Openapi offre attualmente 3 diversi servizi di video riconoscimento per l’Italia:

Tutte le modalità di video riconoscimento prevedono la verifica dei documenti caricati presso CRIMNET, la piattaforma centralizzata del Ministero degli Interni e del Ministero della Giustizia, e quindi l’assenza di denuncia, furto, smarrimento su questi.

L’intero 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 Automatica

La modalità Automatica di riconoscimento si differenzia dalle altre due perché permette agli utenti di completare autonomamente l’intera procedura di video riconoscimento, in qualsiasi momento della giornata.

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

ESEMPIO RICHIESTA

POST /IT-automatic

Il processo di video riconoscimento è estremamente flessibile e può essere strutturato in base alle esigenze dell’integratore. L'unico campo obbligatorio in fase di richiesta è l'indirizzo email del richiedente.

È possibile, ma non obbligatorio, passare anche le seguenti informazioni già in questa fase:

Gli stessi dati potranno essere direttamente ottenuti nello step successivo, ovvero durante il processo di identificazione dell’utente.

L’API consente di customizzare l’esperienza dell’utente mentre effettua la procedura video; in particolare sarà possibile personalizzare:

In fase di richiesta si può anche impostare il formato delll’output della documentazione. Può trattarsi di:

È possibile ottenere anche tutti i dati 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-automatic

La risposta include i seguenti dati:

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

In questo caso 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). Il percorso di identificazione, cioè gli step che l’utente seguirà dopo aver cliccato il link, è predefinito e prevede i seguenti passaggi:

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

I documenti utilizzabili ai fini dell'identificazione sono:

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

La risposta contiene 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.

Una volta che che la procedura verrà completata con 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:

È possibile ottenere in qualsiasi momento 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, come accennato sopra, è 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).