Skip to main content

​
Validação de Dados Bancários

Disponibilizamos em ambiente de homologação a funcionalidade de validação de dados bancários para propostas de crédito consignado. Esta validação ocorre como primeira etapa do fluxo, antes do processamento de KYC.

​
Novos Status

O webhook de Eventos de Resultado de Proposta agora inclui 4 novos status relacionados à validação bancária:
Status inicial indicando que os dados bancários estão sendo validados. Esta é a primeira etapa após o envio da proposta para aprovação.
Os dados bancários fornecidos são inválidos. Será necessário corrigi-los através da API de atualização (disponível em breve).
Os dados bancários corrigidos através da API ainda estão inválidos. Indica uma nova tentativa de validação que falhou.
Status final indicando que o limite de 3 tentativas de correção foi excedido. O contrato não prosseguirá e será necessário criar uma nova proposta.

​
Sistema de Tentativas

A validação bancária implementa um controle de tentativas:
  • ✅ Permite até 3 tentativas de correção dos dados bancários
  • ✅ Após cada correção via API, o sistema revalida automaticamente
  • ✅ Se a 3ª tentativa falhar, o contrato é finalizado automaticamente
  • ⚠️ Após o limite ser excedido, é necessário criar uma nova proposta

​
Fluxo Atualizado

O novo fluxo de validação bancária é executado antes do processo de KYC: 
1. VALIDANDO_DADOS_BANCARIOS (primeira etapa)
   ↓
2a. PROCESSANDO_KYC (se válido)
   OU
2b. DADOS_BANCARIOS_INVALIDOS (se inválido)
   ↓
3. Correção via API (até 3 tentativas)
   ↓
4a. PROCESSANDO_KYC (se corrigido com sucesso)
   OU
4b. FALHA_VALIDACAO_DADOS_BANCARIOS (tentativa falhou)
   OU
4c. LIMITE_MAXIMO_TENTATIVAS_VALIDACAO_DADOS_BANCARIOS_EXCEDIDO (3 tentativas)

​
Próximos Passos

A API de correção de dados bancários será disponibilizada em uma próxima entrega. Até lá, os webhooks com os novos status já estão disponíveis para testes internos no ambiente de homologação.

​
Recursos Atualizados

​
Para Desenvolvedores

  • Os webhooks com os novos status já podem ser recebidos no ambiente de homologação
  • Ajuste seu sistema para tratar os 4 novos status de validação bancária
  • O fluxo de KYC só será iniciado após a validação bancária bem-sucedida