> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wincred.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# 12 de Novembro de 2025

> Ajuste no webhook de resultado da proposta com novos status de validação de conta bancária.

## 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:

<AccordionGroup>
  <Accordion title="VALIDANDO_DADOS_BANCARIOS" icon="clock">
    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.
  </Accordion>

  <Accordion title="DADOS_BANCARIOS_INVALIDOS" icon="triangle-exclamation">
    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).
  </Accordion>

  <Accordion title="FALHA_VALIDACAO_DADOS_BANCARIOS" icon="xmark">
    Os dados bancários corrigidos através da API ainda estão inválidos. Indica uma nova tentativa de validação que falhou.
  </Accordion>

  <Accordion title="LIMITE_MAXIMO_TENTATIVAS_VALIDACAO_DADOS_BANCARIOS_EXCEDIDO" icon="ban">
    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.
  </Accordion>
</AccordionGroup>

### 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

<Warning>
  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.
</Warning>

### Recursos Atualizados

* 📘 [Webhook de Eventos de Resultado de Proposta](/webhooks/03-resultado-proposta) - Documentação atualizada com os novos status e fluxos

### 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