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 há mais de 3 semanas

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?