Validar formato, tamanho e checksum de um IBAN

Este validador normaliza espaços e hífens comuns, identifica o código do país, confere o tamanho oficial definido para esse país e aplica a regra de checksum mod-97 da ISO 7064. Cada decisão é retornada separadamente, permitindo que você confira uma conta ou use software para decidir se um registro de pagamento está pronto para a próxima etapa.

Comece com um IBAN completo e reconhecível

Cole ou envie o IBAN completo, incluindo o código do país com duas letras e os dois dígitos verificadores. Espaços usados para agrupar caracteres e facilitar a leitura são aceitos, assim como hífens, e o validador os remove antes da conferência. Letras minúsculas são convertidas em maiúsculas no resultado normalizado. Nenhum outro sinal de pontuação é descartado silenciosamente, pois isso poderia esconder um erro ao copiar e colar. Um valor estruturalmente utilizável precisa começar com duas letras seguidas de dois dígitos, e todos os caracteres restantes devem ser letras ou números. A resposta inclui o IBAN normalizado para que uma integração possa armazenar ou comparar uma representação consistente. Ela também apresenta o código do país e os tamanhos real e esperado, em vez de devolver apenas uma resposta vaga. Se o prefixo do país não estiver no registro de IBAN aceito, a solicitação gera um erro de entrada. Essa diferença é importante: um esquema desconhecido não pode ser avaliado com segurança e não deve ser tratado como uma simples falha de checksum.

Entenda as verificações de tamanho e mod-97

Os IBANs não têm uma única quantidade universal de caracteres. Cada país participante define um tamanho fixo; por isso, um IBAN alemão tem uma extensão esperada diferente de um norueguês ou maltês. O validador consulta o tamanho associado ao código inicial do país e o compara ao valor normalizado. Em seguida, realiza o procedimento definido para IBAN na ISO 7064: os quatro primeiros caracteres são movidos para o fim, as letras são convertidas em valores numéricos de A igual a 10 até Z igual a 35 e a sequência decimal resultante é calculada módulo 97. Um checksum válido deixa resto igual a um. A implementação calcula o resto progressivamente, dígito por dígito, em vez de formar um inteiro enorme que poderia ultrapassar o intervalo numérico seguro da linguagem. A resposta informa `length_valid` e `checksum_valid` separadamente e só define `valid` quando as duas verificações passam. Um tamanho incorreto impede a aprovação do checksum, mantendo a decisão conservadora e simples de interpretar em fluxos automatizados.

Valide no ponto certo do fluxo de pagamento

Execute esta conferência quando um IBAN entrar no seu sistema: durante o envio de um formulário, a importação de um CSV, o cadastro de um favorecido ou a revisão final antes de criar uma instrução de pagamento. Um resultado negativo evidencia um problema de formato, tamanho ou checksum e ajuda a encontrar cedo erros comuns de transcrição. Ele não comprova que a conta bancária existe, está aberta, pertence ao destinatário informado ou pode receber determinada transferência. Essas questões exigem serviços bancários ou de provedores de pagamento e podem envolver verificações de identidade regulamentadas. Mantenha restrito o papel do validador: rejeite identificadores claramente malformados, mostre quais verificações falharam e peça ao usuário que confirme o número em uma fonte confiável. O algoritmo é determinístico e não usa rede, valor aleatório, relógio ou consulta externa durante a execução, tornando chamadas repetidas reproduzíveis. Uma solicitação à API custa US$ 0,002, enquanto a página executa no navegador a mesma lógica pura de validação.