Boek een adviesgesprek

TERUG NAAR HET HELPCENTRUM

Shufti - Reactie-evenementen

Reactie-evenementen

Shufti levert de terugbel-URL functionaliteit die toegankelijk is door een parameter op te geven
in de API-verzoek. De terugbel-URL Ontvangt een update zodra de status verandert.
De parameter voor de callback-URL moet in de request payload worden gedefinieerd, zoals hieronder weergegeven:

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

Indien de “callback_url” als dit in de verificatiepayload is gespecificeerd, stuurt Shufti de
verificatiestatus daarvan URL.

De reactiegebeurtenissen zijn afhankelijk van de verificatieverzoekverzonden via API.

Raadpleeg onderstaande informatie voor meer details. reactie-evenementen en monster
terugbelreacties voor elke reactiegebeurtenis.

verzoek in behandeling

Dit evenement vindt alleen plaats voor verificatie ter plaatse wanneer de verificatielink is gegenereerd, maar
De gebruiker heeft het hele proces nog niet doorlopen. Deze gebeurtenis wordt voor alle gebruikers geretourneerd. verificaties ter plaatse
totdat de verificatie is voltooid or time-outDe status keerde terug naar de terugbel-URL is als volgt;

         { "referentie": "17374217", "gebeurtenis": "verzoek in behandeling", "fout": "", "verificatie-url": "https://app.shuftipro.com/process/verification/-------", "e-mail": "[e-mail beveiligd]", "land": "GB" }

verzoek.ongeldig

De aanvraag ongeldig Dit probleem treedt op wanneer de parameters die in de aanvraagpayload zijn opgegeven niet aanwezig zijn.
in het juiste formaat.

Bijvoorbeeld: het formaat van de datum is onjuistHet opgegeven adres is minder dan 6 tekens.

Een voorbeeldantwoord is bijgevoegd ter verdere toelichting;

    { "reference17374217", "eventrequest.invalid", "error":{ "servicedocument", "keydob", "messageDe geboortedatum komt niet overeen met het formaat Ymd." }, "email":null, "country":null }

verificatie geannuleerd

De “verificatie geannuleerd” Dit probleem doet zich voor wanneer de eindgebruiker niet akkoord gaat met de algemene voorwaarden.
getoond aan het begin van de verificatiestroom. Deze gebeurtenis vindt alleen plaats voor verificaties ter plaatse.

Een voorbeeldantwoord is bijgevoegd ter verduidelijking;

    { "referentie17374217", "gebeurtenisverificatie.geannuleerd", "fout" }

verzoek.timeout

Shufti heeft een tijdslimiet voor verificaties die na de moeten worden uitgevoerd verificatie link is gegenereerd.
Standaard is de De tijdslimiet is 60 minuten. Deze limiet kan worden gewijzigd door gebruik te maken van een specifieke parameter.
parameter zoals hieronder weergegeven;

    { "referentie1234567", "callback_urlhttp://www.example.com/", "e-mail[e-mail beveiligd]", "countryGB", "languageEN", "redirect_urlhttp://www.example.com", "ttl":60, "verification_modeany", "document":{ }

Hieronder ziet u een voorbeeld van een reactie wanneer een verzoek een time-out bereikt;

    { "referentie17374217", "gebeurtenisverzoek.timeout", "fout" }

verzoek.ongeautoriseerd

De "verzoek.ongeautoriseerdDeze gebeurtenis treedt op wanneer de authenticatieheader niet correct is. Om deze fout op te lossen...
Zorg ervoor dat de API-sleutels correct zijn. API-sleutels zijn toegankelijk via de backoffice van Shufti.

    { "referentie", "gebeurtenisverzoek.ongeautoriseerd", "fout":{ "service", "sleutel", "berichtAutorisatiesleutels ontbreken/zijn ongeldig." }, "e-mail":null, "land":null }

verificatie geaccepteerd

Bij geaccepteerde verificaties, de gebeurtenis van “verificatie geaccepteerd" treedt op. Dit antwoord wordt geretourneerd
in de HTTP reactie en de Bel terug .

Bij geaccepteerde verificatieHieronder vindt u een voorbeeldantwoord;

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

verificatie geweigerd

In geval van een geweigerde verificatie een “verificatie geweigerdDe status wordt geretourneerd. Deze gebeurtenis ook
naar de gedaald reden. Voor deze gebeurtenis worden zowel HTTP- als callback-reacties geretourneerd.

Hieronder vindt u een voorbeeld van een reactie ter verduidelijking;

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

verificatiestatus gewijzigd

De status van een verificatie kan worden gewijzigd vanuit de backoffice. Vanuit "Aanvaard' als 'Afgewezen"En
En omgekeerd. Indien de verificatiestatus verandert, wordt de klant hiervan op de hoogte gesteld. terugbel-URL. in
In dit geval wordt er geen aanvullende informatie teruggestuurd naar de terugbel-URL met uitzondering van de bijgewerkte gebeurtenis.

    { "referentie17374217", "gebeurtenisverificatie.status.gewijzigd" }

verzoek.verwijderd

Deze gebeurtenis impliceert dat de verificatiegegevens zijn verwerkt. verwijderdeDe gegevens die ooit van de back-up zijn verwijderd...
Het kantoor werkt ook de status bij van de callback-URL.

Een voorbeeldantwoord voor een verwijderde De verificatie vindt u hieronder;

    { "referentie17374217", "gebeurtenisverzoek.verwijderd" }

verzoek ontvangen

Deze melding geeft aan dat het verificatieverzoek is ontvangen en in behandeling is. verwerking. Dit evenement
komt alleen voor bij verificatie op afstand wanneer het verzoek ter verwerking naar Shufti wordt verzonden.

    { "referentie17374217", "gebeurtenisverzoek ontvangen", "e-mail[e-mail beveiligd]", "landVK" }