Validação de domicílio bancário
POST /validate recebe bank (ISPB ou COMPE), agency, agency_dv (opcional), account, account_dv e account_type (corrente ou poupanca). Espaços, pontos e traços são removidos.
Todas as checagens rodam e todas as falhas voltam juntas em reasons. valid só é true sem nenhum motivo.
| Código | Significado |
|---|---|
| formato_invalido | Campo ausente ou fora do formato |
| banco_inexistente | Banco não encontrado |
| banco_inativo | Banco inativo |
| banco_ambiguo | COMPE aponta para mais de uma instituição |
| agencia_inexistente | Agência não existe no banco |
| agencia_inativa | Agência inativa |
| dv_agencia_invalido | DV da agência não confere |
| dv_conta_invalido | DV da conta não confere |
| tipo_invalido | Tipo de conta inválido |
DV: calculado para Banco do Brasil (001), Itaú (341), Bradesco (237), Caixa (104) e Santander (033). Nos demais, nao_verificado.
Bancos sem lista de agências (ex.: Nu Pagamentos, 260): qualquer agência é aceita, agency_check: "sem_lista" e sugestão 0001.
Importante: a validação confirma existência e formato; não confirma a titularidade da conta.