Agende uma Demonstração

VOLTAR À CENTRAL DE AJUDA

Shufti - Eventos de Resposta

Eventos de resposta

Shufti fornece o URL de retorno de chamada funcionalidade que pode ser acessada especificando um parâmetro
dentro do Solicitação de API. O URL de retorno de chamada Recebe uma atualização sempre que houver uma mudança de status.
O parâmetro para a URL de retorno de chamada deve ser definido no corpo da requisição, conforme mostrado abaixo:

        
       {
            "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 o “callback_url” conforme especificado na carga útil de verificação, Shufti envia o
status de verificação para isso URL.

Os eventos de resposta dependem de solicitação de verificaçãoenviado por API.

Consulte as informações abaixo para obter detalhes sobre eventos de resposta e amostra
respostas de retorno de chamada para cada evento de resposta.

solicitação pendente

Este evento ocorre apenas para verificação no local quando o link de verificação tiver sido gerado, mas
O usuário ainda não concluiu todo o processo. Este evento é retornado para todos. verificações no local
até que a verificação seja concluído or tempo limiteO status retornou ao URL de retorno de chamada é como segue;

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

solicitação.inválida

O pedido inválido O evento ocorre quando os parâmetros especificados na carga útil da solicitação não são atendidos.
do formato correto.

Por exemplo, o formato da data é incorreto, o endereço especificado é menos de 6 caracteres.

Segue em anexo um exemplo de resposta para melhor compreensão;

    { "reference":"17374217", "event":"request.invalid", "error":{ "service":"document", "key":"dob", "message":"A data de nascimento não corresponde ao formato A/M/D." }, "email":null, "country":null }

verificação cancelada

O “verificação cancelada” O evento ocorre quando o usuário final não concorda com os termos e condições.
Exibido no início do fluxo de verificação. Este evento ocorre apenas para verificações no local.

Segue anexa uma resposta de exemplo para maior esclarecimento;

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

solicitação.tempo limite

Shufti tem um limite de tempo para que as verificações sejam realizadas após o Link de verificação é gerado.
Por padrão, o O limite de tempo é de 60 minutos. Esse limite pode ser alterado usando um valor especificado.
parâmetro conforme mostrado abaixo;

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

Abaixo, segue um exemplo de resposta para quando uma solicitação expira;

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

solicitação não autorizada

O "solicitação não autorizadaO evento ocorre quando o cabeçalho de autenticação está incorreto. Para resolver esse erro.
Certifique-se de que as chaves da API estejam corretas. Chaves API são acessíveis através do painel administrativo da Shufti.

    { "reference":"", "event":"request.unauthorized", "error":{ "service":"", "key":"", "message":"Authorization keys are missing/invalid." }, "email":null, "country":null }

verificação aceita

Para verificações aceitas, o evento de “verificação aceitaOcorre. Esta resposta é retornada.
no HTTP resposta e a ligue de volta tão bem.

Para verificação aceitaAbaixo, é apresentada uma resposta de exemplo;

    {
       "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ção recusada

Em caso de verificação recusada, um “verificação recusadaO status é retornado. Este evento também
refere-se ao recusou Motivo. Tanto as respostas HTTP quanto as de retorno de chamada são retornadas para este evento.

Segue abaixo um exemplo de resposta para esclarecimento;

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

status de verificação alterado

O status de uma verificação pode ser alterado no painel administrativo. De “Aceito"Para"Recusado"E
e vice-versa. Caso o status de verificação seja alterado, o cliente será notificado através do URL de retorno de chamada. em
Neste caso, nenhuma informação adicional é retornada ao URL de retorno de chamada exceto o evento atualizado.

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

solicitação excluída

Este evento implica que os dados de verificação foram excluídoOs dados, uma vez apagados do backup-
O escritório também atualiza o status do URL de retorno de chamada.

Uma resposta de exemplo para um excluído A verificação é apresentada abaixo;

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

solicitação recebida

Este evento indica que o pedido de verificação foi recebido e está em andamento. em processamentoEste evento
ocorre apenas para verificação fora do local quando a solicitação é enviada para Shufti para processamento.

    { "reference":"17374217", "event":"request.received", "email":"[email protected]", "país":"Reino Unido" }