Passar para o conteúdo principal

Como posso configurar e entender os Webhooks de Decisão da Veriff?

Francesco Malvestio avatar
Escrito por Francesco Malvestio
Atualizado hoje

Os webhooks são uma parte integral do processo de verificação da Veriff. Eles permitem que o sistema envie resultados de verificação, incluindo decisões, dados verificados e detalhes da sessão, diretamente para uma URL pré-definida. Abaixo está uma visão geral dos Webhooks de Decisão da Veriff, suas configurações e os detalhes relevantes para ajudá-lo a compreender e utilizá-los melhor.

Introdução aos Webhooks de Decisão da Veriff

Os Webhooks de Decisão da Veriff agilizam o processo de entrega dos resultados de verificação. Após uma decisão ser tomada, o webhook envia uma decisão, opcionalmente incluindo detalhes como:

  • Status de verificação e horários

  • Detalhes pessoais e do documento

  • Recursos adicionais, como pontuações de risco ou resultados biométricos (dependendo das configurações personalizadas)

Em casos onde a reenvio é necessário, o sistema permite que os usuários tenham uma janela de cinco minutos para reenviar. Se essa janela expirar sem um reenvio, um webhook de reenvio separado é acionado. Você pode configurar a URL do endpoint para esses webhooks no Portal do Cliente da Veriff.

Configuração Básica e Fluxo

Para configurar seu webhook:

  1. Faça login no Portal do Cliente da Veriff.

  2. Especifique a URL do endpoint para onde as respostas do webhook devem ser enviadas.

  3. Consulte a documentação oficial do Webhook de Decisão para exemplos de solicitações e explicações sobre as propriedades: Documentação do Webhook de Decisão.

O fluxo típico inclui os seguintes passos:

  • Uma sessão de verificação é iniciada.

  • Uma vez que uma decisão é tomada, o webhook envia um payload para a URL especificada imediatamente, a menos que em cenários de reenvio.

Recursos e Parâmetros Específicos do Plano

Usuários do Plano Essencial:

O plano de Serviço Próprio Essencial funciona usando webhooks de Full Auto. As diferenças incluem o manuseio automatizado da verificação sem envolvimento manual. A documentação específica do webhook de Full Auto inclui:

Detalhes Gerais:

Para outros planos, consulte os links externos fornecidos na página do Webhook de Decisão, onde explicações e exemplos são traçados de acordo com suas configurações e necessidades.

Campos Frequente Consulta em Webhooks

'DriversLicenseCategory' e 'Subtipo de Documento':

Os usuários costumam perguntar sobre campos como 'driversLicenseCategory' ou 'Subtipo de Documento'. Esses pontos de dados aparecem nas respostas do webhook quando configurados. Para localizar e interpretar esses campos, consulte a documentação da Veriff:

Status da Decisão:

Esse atributo-chave fornece uma visão sobre se uma verificação é aprovada, recusada ou requer entrada adicional. Horários e metadados relevantes ajudam a identificar onde a decisão foi tomada dentro do processo de verificação.

Recursos Adicionais

Para informações adicionais:

Ao entender essas configurações, você pode aproveitar ao máximo os Webhooks de Decisão da Veriff e integrá-los perfeitamente aos seus fluxos de trabalho.

Respondeu à sua pergunta?