Verifica Identità

Video Identificazione in modalità Automatica o con Operatore

La soluzione perfetta per l'attività di digital onboarding, adeguata verifica e per contrattualistica a distanza

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Verifica Identità

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.

Scegli il tipo di video riconoscimento ed ottieni il link

Richiedi il tipo di videoriconoscimento in base alle tue esigenze:
/automatic/selfie/live,  Nel payload della tua richiesta compila le sezioni:
  • "user"
    Può essere impostato a NULL se l'utente va riconosciuto da zero o configurato per effettuare una verifica di identità es:
                      {
                        "firstName": "Franco",
                        "lastName": "Rossi",
                        "gender": "M",
                        "birthCountry": "Italia",
                        "birthDate": "1977-11-06",
                        "birthPlace": "Roma",
                        "taxCode": "RSSMRA02D16A662G"
                      }
                    
  • "healthCard"
    Determina se acquisire o meno le foto della tessera sanitaria. Se "required" è impostato a true, sarà possibile attivare un ulteriore controllo ("checkExpire") per verificare la scadenza della tessera sanitaria acquisita. es:
    { "required": true, "checkExpire": true }
  • "phoneNumber"
    Verifica e/o acquisisci il numero di telefono dell'utente certificato da un codice OTP inviato automaticamente dal sistema. es:
    { "required": true, "editable": false, "number": "123456789"}
    impostando editable a true sarà possibile cambiare il numero di telefono in fase di videoriconoscimento
  • "policy"
    Attraverso questo parametro, il cliente specifica il link all'informativa sulla privacy. Questo link verrà utilizzato come collegamento esterno nella pagina di accettazione del consenso. es:
    { "url": "https://www.company.it/privacy-policy/" }
  • "output"
    Determina se la documentazione acquisita sarà renderizzata in un unico file pdf o verrà ritornato un archivio contenente i singoli file grafici separati. es:
    { "imagesAsPdf": false }
  • "layout"
    Configura l'interfaccia di videoriconscimento personalizzandone la UI. es:
    {
                        "title": "Video ID",
                        "logo": "https://www.website.it/logo.png",
                        "favicon": "https://www.website.it/favicon.png",
                        "backgroundColor": "#cecece",
                        "textColor": "#000000",
                        "footer": "Company Spa, P.IVA 11111111111"
                      }
  • "callback"
    Configura un tuo webhook per ricevere aggiornamenti asincroni sulla procedura. es:
    {
                        "url": "https://mycallback.site/",
                        "method": "POST",
                        "field": "data",
                        "headers": {
                          "session_id": "oiwejdf89453urf945jfg"
                        }
                      }

Esamina la risposta

La risposta conterrà oltre allo stato della pratica ed il suo "id" anche un "link". Esso va inviato all'utente che deve effettuare il video riconoscimento. es:
{
              "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
            }

Attendi che il video riconoscimento sia completo e ottieni il risultato

Se hai impostato la "callback", una volta completato il video riconoscimento riceverai una richiesta http sul tuo webhook, a questo punto se lo stato "completed" è uguale a "true" puoi procedere a scaricare il dettaglio della verifica compresi i documenti prodotti durante il riconoscimento:
{
        "_id": "28b3a20e-ffcc-4245-843a-563e9ff5f31b",
        "callback": {
          "url": "https://webhook.site/ab91d3f3-c246-498a-9af5-828bf13dd8ef",
          "method": "POST",
          "field": "data",
          "headers": {
            "session_id": "oiwejdf89453urf945jfg"
          },
          "data": {}
        },
        "link": "https://openapi.certid.it/28b3a20e-ffcc-4245-843a-563ddff5f31b",
        "status": "ok",
        "completed": true,
        "owner": "[email protected]",
        "creationTimestamp": 1706283108,
        "lastUpdateTimestamp": 1706283108,
        "reason": null
      }

Se non hai impostato impostato la "callback" potrai comunque controllare lo stato della tua richiesta all'endpoint: /IT-identity-verifications/{id}

Per ottenere il dettaglio della procedura basta effettuare una chiamata a: /IT-identity-verifications/{id}/{type} dove {id} è l'id della procedura e {type} è una delle due opzioni:
  • "data": che ritorna il dato strutturato con le informazioni riguardanti il soggetto riconosciuto:
    {
              "firstName": "Franco",
              "lastName": "Rossi",
              "gender": "M",
              "birthCountry": "Italia",
              "birthDate": "1977-11-06",
              "birthPlace": "Roma",
              "taxCode": "RSSMRA02D16A662G",
              "documentType": "drive_license",
              "documentNumber": "1111111111",
              "documentDate": "2011-01-10",
              "documentExpiration": "2033-11-06",
              "healthCardExpiration": "2028-01-19",
              "healthCardID": "81111111111111111100"
            }
  • "archive": che ritorna un pacchetto zip (Content Type: application/zip) contenente i file relativi alla procedura: (video se presente, immagini del documento e del soggetto)
.