Prenota una demo

TORNA AL CENTRO ASSISTENZA

Shufti - Eventi di risposta

Eventi di risposta

Shufti fornisce il URL di callback funzionalità a cui è possibile accedere specificando un parametro
all'interno Richiesta API. URL di callback riceve un aggiornamento ogni volta che si verifica una modifica di stato.
Il parametro per l'URL di callback deve essere definito nel payload della richiesta come mostrato di seguito:

        
       {
            "reference"    : "1234567",
            "callback_url" : "http://www.example.com/",
            "email"        : "[email protected]",
            "country"      : "GB",
            "language"     : "EN",
            "redirect_url" : "http://www.example.com",
            "ttl"          : 60,
            "verification_mode" : "any",

            "document" :     {
         }

Se l' “URL di callback” è specificato nel payload di verifica, Shufti invia il
stato di verifica a quello URL.

Gli eventi di risposta dipendono da richiesta di verificainviato tramite API.

Si prega di fare riferimento alle informazioni seguenti per i dettagli riguardanti eventi di risposta e campione
risposte di richiamata per ogni evento di risposta.

richiesta in sospeso

Questo evento si verifica solo per verifica in loco quando il link di verifica è stato generato ma
l'utente non ha ancora completato l'intero processo. Questo evento viene restituito per tutti verifiche in loco
fino a quando la verifica non sarà completato or timeout. Lo stato è tornato a URL di richiamata è come segue;

         { "reference": "17374217", "event": "request.pending", "error": "", "verification_url": "https://app.shuftipro.com/process/verification/-------", "email": "[email protected]", "paese": "GB" }

richiesta non valida

La richiesta invalido l'evento si verifica quando i parametri specificati nel payload della richiesta non sono
del formato corretto.

Ad esempio, il formato della data è scorretto, l'indirizzo specificato è meno di 6 caratteri.

Si allega un esempio di risposta per ulteriori chiarimenti;

    { "reference":"17374217", "event":"request.invalid", "error":{ "service":"document", "key":"dob", "message":"La data di nascita non corrisponde al formato Ymd." }, "email":null, "country":null }

verifica annullata

Migliori “Verifica annullata” L'evento si verifica quando l'utente finale non accetta i termini e le condizioni.
mostrato all'inizio del flusso di verifica. Questo evento si verifica solo per verifiche in loco.

Si allega un esempio di risposta per ulteriori chiarimenti;

    { "reference":"17374217", "event":"verification.cancelled", "error":"" }

richiesta.timeout

Shufti ha un limite di tempo per le verifiche da eseguire dopo il collegamento di verifica è generato.
Per impostazione predefinita, il Il tempo limite è di 60 minuti. Questo limite può essere modificato utilizzando un parametro specificato
parametro come mostrato di seguito;

    { "reference":"1234567", "callback_url":"http://www.example.com/", "email":"[email protected]", "paese":"GB", "lingua":"EN", "url_reindirizzamento":"http://www.example.com", "ttl":60, "modalità_verifica":"qualsiasi", "documento":{ }

Di seguito è riportato un esempio di risposta nel caso in cui una richiesta vada in timeout;

    { "reference":"17374217", "event":"request.timeout", "error":"" }

richiesta non autorizzata

Il "richiesta non autorizzataL'evento " si verifica quando l'intestazione di autenticazione non è corretta. Per risolvere questo errore
Assicurati che le chiavi API siano corrette. Chiavi API sono accessibili tramite il back-office di Shufti.

    { "reference":"", "event":"request.unauthorized", "error":{ "service":"", "key":"", "message":"Le chiavi di autorizzazione sono mancanti/non valide." }, "email":null, "country":null }

verifica.accettata

Per verifiche accettate, l'evento di “verifica.accettata" si verifica. Questa risposta viene restituita
nella HTTP risposta e la richiama come pure.

Per verifica accettataDi seguito viene fornita una risposta di esempio;

    {
       "reference":"17374217",
       "event":"verification.accepted",
       "error":"",
       "verification_result":{
          "document":{
             "name":1,
             "dob":1,
             "expiry_date":1,
             "issue_date":1,
             "document_number":1,
             "document":1,
             "gender":""
          },
          "address":{
             "name":1,
             "full_address":1
          }
       },
       "verification_data":{
          "document":{
             "name":{
                "first_name":"John",
                "middle_name":"Carter",
                "last_name":"Doe"
             },
             "dob":"1978-03-13",
             "issue_date":"2015-10-10",
             "expiry_date":"2025-12-31",
             "document_number":"1456-0989-5567-0909",
             "selected_type":[
                "id_card"
             ],
             "supported_types":[
                "id_card",
                "driving_license",
                "passport"
             ],
             "gender":"M"
          },
          "address":{
             "name":{
                "first_name":"John",
                "middle_name":"Carter",
                "last_name":"Doe"
             },
             "full_address":"3339 Maryland Avenue, Largo, Florida",
             "selected_type":[
                "id_card"
             ],
             "supported_types":[
                "id_card",
                "bank_statement"
             ]
          }
       },
       "info":{
          "agent":{
             "is_desktop":true,
             "is_phone":false,
             "useragent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36
                                                (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36",
             "device_name":"Macintosh",
             "browser_name":"",
             "platform_name":"OS X - 10_14_0"
          },
          "geolocation":{
             "host":"212.103.50.243",
             "ip":"212.103.50.243",
             "rdns":"212.103.50.243",
             "asn":"9009",
             "isp":"M247 Ltd",
             "country_name":"Germany",
             "country_code":"DE",
             "region_name":"Hesse",
             "region_code":"HE",
             "city":"Frankfurt am Main",
             "postal_code":"60326",
             "continent_name":"Europe",
             "continent_code":"EU",
             "latitude":"50.1049",
             "longitude":"8.6295",
             "metro_code":"",
             "timezone":"Europe/Berlin"
          }
       },
       "additional_data":{
          "document":{
             "proof":{
                "height":"183",
                "country":"United Kingdom",
                "authority":"HMPO",
                "last_name":"Doe",
                "first_name":"John",
                "issue_date":"2018-01-31",
                "expiry_date":"2028-01-30",
                "nationality":"BRITISH CITIZEN",
                "country_code":"GBR",
                "document_type":"P",
                "place_of_birth":"BRISTOL",
                "document_number":"GB1234567",
                "personal_number":"12345678910",
                "dob":"1978-03-13",
                "gender":""
             }
          }
       }
    }

verifica.rifiutata

In caso di verifica rifiutata, “verifica.rifiutataLo stato " viene restituito. Questo evento anche
si riferisce a diminuito Motivo. Per questo evento vengono restituite sia risposte HTTP che risposte di callback.

Di seguito viene fornito un esempio di risposta a scopo chiaritivo;

    {
       "reference":"95156124",
       "event":"verification.declined",
       "error":"",
       "verification_result":{
          "document":{
             "name":0,
             "dob":1,
             "expiry_date":1,
             "issue_date":1,
             "document_number":1,
             "document":null
          },
          "address":{
             "name":null,
             "full_address":null
          }
       },
       "verification_data":{
          "document":{
             "name":{
                "first_name":"John",
                "middle_name":"Carter",
                "last_name":"Doe"
             },
             "dob":"1978-03-13",
             "issue_date":"2015-10-10",
             "expiry_date":"2025-12-31",
             "gender":"M""document_number":"1456-0989-5567-0909",
             "selected_type":[
                "id_card"
             ],
             "supported_types":[
                "id_card",
                "driving_license",
                "passport"
             ]
          },
          "address":{
             "name":{
                "first_name":"John",
                "middle_name":"Carter",
                "last_name":"Doe"
             },
             "full_address":"3339 Maryland Avenue, Largo, Florida",
             "selected_type":[
                "id_card"
             ],
             "supported_types":[
                "id_card",
                "bank_statement"
             ]
          }
       },
       "info":{
          "agent":{
             "is_desktop":true,
             "is_phone":false,
             "useragent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36
                                            (KHTML, like Gecko) Chrome/75.0.3770.100 Safari/537.36",
             "device_name":"Macintosh",
             "browser_name":"",
             "platform_name":"OS X - 10_14_0"
          },
          "geolocation":{
             "host":"212.103.50.243",
             "ip":"212.103.50.243",
             "rdns":"212.103.50.243",
             "asn":"9009",
             "isp":"M247 Ltd",
             "country_name":"Germany",
             "country_code":"DE",
             "region_name":"Hesse",
             "region_code":"HE",
             "city":"Frankfurt am Main",
             "postal_code":"60326",
             "continent_name":"Europe",
             "continent_code":"EU",
             "latitude":"50.1049",
             "longitude":"8.6295",
             "metro_code":"",
             "timezone":"Europe/Berlin"
          }
       },
       "declined_reason":"Name on the document doesn't match",
       "declined_codes":[
          "SPDR07",
          "SPDR06",
          "SPDR23"
       ],
       "additional_data":{
          "document":{
             "proof":{
                "height":"183",
                "country":"United Kingdom",
                "authority":"HMPO",
                "last_name":"Doe",
                "first_name":"John",
                "issue_date":"2018-01-31",
                "expiry_date":"2028-01-30",
                "nationality":"BRITISH CITIZEN",
                "country_code":"GBR",
                "document_type":"P",
                "place_of_birth":"BRISTOL",
                "document_number":"GB1234567",
                "personal_number":"12345678910",
                "dob":"1978-03-13",
                "gender":"M"
             }
          }
       }
    }

stato di verifica modificato

Lo stato di una verifica può essere modificato dal back office. Da “Accettato"A"Rifiutato" e
viceversa. Nel caso in cui lo stato di verifica venga modificato, il cliente viene avvisato tramite URL di richiamata. in
in questo caso, non vengono restituite ulteriori informazioni al URL di richiamata fatta eccezione per l'evento aggiornato.

    { "reference":"17374217", "event":"verification.status.changed" }

richiesta.eliminata

Questo evento implica che i dati di verifica sono stati cancellatoI dati una volta eliminati dal back-
l'ufficio aggiorna anche lo stato su URL di callback.

Una risposta di esempio per una cancellato La verifica è riportata di seguito;

    { "reference":"17374217", "event":"request.deleted" }

richiesta ricevuta

Questo evento indica che la richiesta di verifica è stata ricevuta ed è in corso lavorazioneQuesto evento
si verifica solo per verifica fuori sede quando la richiesta viene inviata a Shufti per l'elaborazione.

    { "reference":"17374217", "event":"request.received", "email":"[email protected]", "paese":"Regno Unito" }