Guia de validação de IBAN

Validação de IBAN: como conferir com segurança

A validação de IBAN é uma conferência em camadas de uma sequência fornecida pelo banco: formato do país, comprimento esperado, caracteres permitidos e relação de controle MOD-97. Um processo claro encontra erros de cópia sem confundir um formato consistente com uma conta real.

Este guia mostra como validar um IBAN, interpretar falhas comuns e saber quando é necessário falar com o banco ou com o provedor de pagamentos. Ele atende operações, suporte, QA e desenvolvimento, onde é importante separar sintaxe de confirmação da conta.

Ilustração editorial de validação de IBAN separando formato nacional, comprimento e verificação MOD-97
A validação de IBAN testa uma sequência estruturada; não é uma consulta pública de conta.

O que significa a validação de IBAN

A validação de IBAN verifica se um número de conta bancária internacional é coerente com o formato registrado de um país. Na prática, ela procura um prefixo de país plausível, o comprimento correto, caracteres permitidos e dígitos que satisfazem a regra internacional MOD-97. Isso é útil porque um caractere perdido, uma troca de posição ou um prefixo errado pode fazer um formulário rejeitar o valor antes que o banco processe o pagamento.

A palavra validação pode descrever níveis diferentes, que precisam ser separados. Uma conferência de formato não é uma consulta ao banco, uma correspondência do nome do beneficiário, uma verificação de sanções nem uma garantia de que a transferência será recebida. Ao registrar um resultado, diga exatamente o que passou: “formato do país e checksum aprovados” é mais preciso do que “esta conta é válida”. Para obter um resultado imediato, use o verificador de IBAN; este guia explica como interpretar o processo e seus limites.

Use como fonte o valor emitido pelo banco. Não construa um IBAN pessoal a partir de nome, cartão, conta local ou exemplo público. Um gerador pode criar dados sintéticos para desenvolvimento, mas não descobre uma conta privada. Essa separação protege pagamentos reais e evita que fixtures de QA cheguem à produção.

CamadaPergunta respondidaO que não comprova
SintaxeO prefixo e os caracteres parecem um IBAN?Que a sequência veio de um banco.
Formato do paísO país usa este comprimento e padrão BBAN?Que todos os campos nacionais estão ativos.
MOD-97Os dígitos de controle combinam com o restante?Que a conta existe ou pertence ao beneficiário.
Verificação autorizadaO banco ou provedor pode confirmar a relação?Que todo pagamento será garantido em qualquer rota.

As camadas de validação: país, comprimento, BBAN e MOD-97

Comece pelo código do país. As duas primeiras letras selecionam uma especificação nacional e os dois dígitos seguintes são os dígitos de controle internacionais. O restante é o Basic Bank Account Number, ou BBAN. Um BBAN alemão, francês, britânico ou holandês pode ter posições, caracteres e comprimentos diferentes. Por isso o verificador precisa selecionar a regra do país antes de avaliar a sequência.

Depois compare o comprimento normalizado com o comprimento registrado. Remova apenas espaços de apresentação, conserve zeros à esquerda e rejeite pontuação ou caracteres ocultos que o contrato de entrada não permita. Passar no comprimento é necessário, mas fraco: várias sequências erradas podem ter a mesma quantidade de caracteres. O padrão BBAN acrescenta a verificação de dígitos, letras, banco, agência e campos de controle nacionais em cada posição.

Por fim, execute o cálculo MOD-97. Mova os quatro primeiros caracteres para o fim, converta letras de A a Z nos valores 10 a 35 e processe os dígitos com um resto acumulado. Um IBAN completo normalmente é consistente quando o resto final é 1. O checksum detecta erros de transcrição, mas continua sendo uma relação matemática entre caracteres.

Diagrama editorial de quatro passos para validação de IBAN: normalizar, conferir país, calcular MOD-97 e confirmar a fonte
Aplique as verificações estruturais em ordem e mantenha a confirmação bancária como resultado separado.
  1. Escolha a regra do paísLeia o prefixo de duas letras e carregue comprimento e padrão BBAN registrados.
  2. Normalize a apresentaçãoRemova espaços, use maiúsculas quando permitido e rejeite pontuação inesperada.
  3. Confira o checksumFaça a rotação, expanda as letras e calcule o resto módulo 97.
  4. Registre o limiteMarque o resultado como formato ou checksum, salvo quando houver confirmação bancária autorizada.

Como validar um IBAN passo a passo

Primeiro obtenha o valor completo em um extrato, sessão bancária autenticada, aplicativo oficial ou instrução de pagamento confirmada. Guarde a apresentação original para comparar caso a verificação falhe. Se a mensagem alterar dados de pagamento, confirme por um segundo canal confiável. Uma validação de formato não detecta todo tipo de fraude, pois alguém pode fornecer uma conta perfeitamente formatada.

Depois normalize a entrada conforme o contrato da ferramenta ou do provedor. Espaços impressos costumam ser separadores e podem ser removidos de um campo eletrônico. Não complete caracteres ausentes, não troque uma letra por um dígito parecido e não elimine zeros à esquerda. Rejeite o rótulo “IBAN”, barras, hífens ou caracteres não ASCII quando o analisador não disser que os aceita.

Em seguida valide por camadas e mantenha o primeiro erro relevante. Se o país não é suportado, não apresente falha de checksum como causa principal. Se o comprimento estiver errado, peça uma nova cópia antes de depurar MOD-97. Se o checksum falhar depois do formato, compare cada caractere com a fonte e verifique se um espaço ou quebra de linha foi copiado como dado.

  1. 1. Confirme a fonteUse uma fonte bancária atual e confira nome da conta e moeda.
  2. 2. Normalize com cuidadoRetire apenas espaços, preserve letras e dígitos e rejeite símbolos inesperados.
  3. 3. Aplique regras do paísCompare país, comprimento, classes de caracteres e posições BBAN.
  4. 4. Execute MOD-97Use a sequência completa e espere resto final 1 para a consistência do checksum.
  5. 5. Encaminhe corretamenteFale com banco ou provedor quando a decisão exigir mais do que sintaxe.

Como ler resultados de aprovação e falha

Um bom validador devolve um estado explicado, não apenas um selo verde. “País não suportado” significa que o registro não conhece o prefixo ou que ele foi copiado errado; não é motivo para escolher outro país. “Comprimento incorreto” significa que a contagem normalizada não bate com a especificação. “Caracteres inválidos” costuma indicar pontuação, rótulo copiado, espaço não separável ou caractere fora do alfabeto. Corrija a fonte em vez de adivinhar.

Um checksum falho significa que a sequência rotacionada e expandida não produziu o resto esperado. Copie o valor novamente, compare os quatro primeiros caracteres e procure uma inversão. Um checksum aprovado significa somente consistência matemática. Não comprova que a conta esteja aberta, que o nome coincida ou que o banco receptor aceite o pagamento. Essa limitação deve aparecer junto do resultado aprovado.

  • Nunca altere dígitos para obter um checksum aprovado; isso apaga a evidência do erro original.
  • Mantenha falhas de formato nacional e de checksum separadas nos seus indicadores.
  • Mostre “formato aceito” em vez de afirmar que o banco confirmou a conta.
ResultadoSignificado provávelPróxima ação
País não suportadoO prefixo não está no registro ou foi escrito errado.Confirme o prefixo bancário e a cobertura do registro.
Comprimento incorretoA quantidade de caracteres não segue a regra nacional.Copie novamente; não acrescente zeros.
Falha de padrãoUm caractere ou campo não segue o BBAN.Compare a fonte e as instruções do país.
Checksum falhoMOD-97 falhou após a normalização.Revise cópia, espaços e rotação dos quatro caracteres.
Formato aprovadoA sequência é consistente nas regras testadas.Use verificação bancária para decisões sobre a conta.

O que a validação de IBAN não prova

Um validador de formato pode analisar uma sequência sem entrar em contato com o banco. Ele normalmente detecta caracteres proibidos, comprimento errado, incompatibilidade entre país e BBAN e checksum MOD-97 falho. Isso é útil para formulários e limpeza de dados, mas responde a uma pergunta técnica limitada. Uma sequência pode passar pelas regras locais e ainda não estar atribuída, estar encerrada, estar no campo errado ou ser inadequada à rota de pagamento.

A validação também não informa quem é o titular. Ela não deduz o IBAN de uma pessoa a partir de nome, cartão, endereço ou conta local parcial. Não faz conferência de beneficiário, sanções, saldo ou autorização. Essas decisões pertencem ao banco ou a um provedor autorizado com acesso e controles adequados.

Para uma transferência real, compare o IBAN completo com as instruções atuais do banco receptor e confirme alterações por um canal seguro. Para software, use valores sintéticos identificados e proteções de ambiente. O guia de dados de teste IBAN mostra como manter fixtures longe de faturas, listas de beneficiários, débitos diretos e chamadas de produção.

  • Validade do formato não comprova existência da conta.
  • O prefixo do país não prova onde o titular vive.
  • Um checksum aprovado não prova titularidade nem correspondência do beneficiário.
  • Uma conferência local não é autorização nem garantia de liquidação.

Lista para desenvolvimento e QA de validação de IBAN

Implemente a validação em etapas explícitas para que cada consumidor escolha a mensagem correta. Mantenha o valor como texto, normalize apenas a apresentação permitida e carregue regras de um registro mantido. Não converta um IBAN completo em Number do JavaScript ou ponto flutuante: sequências longas e zeros à esquerda podem ser danificados. Um loop de resto módulo mantém a aritmética limitada e facilita os testes.

Uma matriz de testes útil inclui valor sintético conhecido para vários países, o mesmo valor com espaços, letras minúsculas, um caractere alterado, dois caracteres invertidos, prefixo não suportado, sequência curta, sequência longa, pontuação e um caso limite de dígitos. A discussão de desenvolvedores da pesquisa mostra por que é preciso validar o intervalo dos dois dígitos para não aceitar a sobreposição enganosa `00`/`97`. Confira esse limite no registro atual.

Separe estados como `syntax_error`, `country_unsupported`, `length_error`, `pattern_error`, `checksum_error` e `format_pass`. Nos logs, evite IBANs completos de clientes quando um valor com hash ou mascarado basta. Para confirmação real, encaminhe ao banco ou provedor em vez de incluir uma requisição oculta no conferidor local.

function ibanMod97(input) {
  const value = input.replace(/[ \t\r\n]/g, '').toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(value)) {
    return {status: 'syntax_error'};
  }
  let remainder = 0;
  for (const character of value.slice(4) + value.slice(0, 4)) {
    const expanded = /[A-Z]/.test(character)
      ? String(character.charCodeAt(0) - 55)
      : character;
    for (const digit of expanded) {
      remainder = (remainder * 10 + Number(digit)) % 97;
    }
  }
  return {status: remainder === 1 ? 'checksum_pass' : 'checksum_error'};
}

// Verifique também comprimento e BBAN antes de aceitar o resultado.

O código mostra apenas o limite aritmético. Um serviço completo precisa de regras nacionais atualizadas, mensagens claras, controles de privacidade e uma etapa separada de verificação bancária.

Escolha o próximo passo depois da validação

Se o valor falhar, peça uma nova cópia ao titular ou ao banco. Não use um exemplo público como modelo de correção e não altere caracteres até a ferramenta ficar verde. Para QA, guarde uma fixture sintética com etiqueta de ambiente. Para um pagamento real, siga as instruções do banco receptor e a verificação autorizada do provedor.

O site separa essas tarefas. Use o verificador de IBAN para formato e checksum, o decodificador de IBAN para ver campos e o guia MOD-97 para a fórmula. Se precisa de um valor emitido pelo banco, leia como encontrar seu IBAN em vez de gerá-lo.

  1. Formato aprovado para documentaçãoRegistre a regra do país, a versão do registro e a normalização aplicada.
  2. Fixture de QAMarque o valor como sintético e mantenha-o fora de dados de clientes e pagamentos.
  3. Pagamento realConfirme os dados do banco e use o caminho autorizado do provedor.

Perguntas frequentes sobre validação de IBAN

O que a validação de IBAN verifica?

Ela pode conferir sintaxe, país, comprimento registrado, caracteres BBAN e relação MOD-97. As camadas dependem do registro e do provedor.

Um IBAN válido significa que a conta existe?

Não. Formato e checksum são evidências matemáticas. Não comprovam atribuição, status, titularidade, beneficiário ou possibilidade de pagamento.

Como validar um IBAN antes de pagar?

Comece com o valor do banco, compare conta e pagamento, execute formato e checksum e use banco ou provedor quando precisar de confirmação da conta.

Posso validar um IBAN com nome ou cartão?

Não. Não deduza dados bancários privados de nome, cartão ou conta parcial. Peça o valor ao banco ou use um canal autenticado.

O que fazer quando o checksum falha?

Copie novamente, remova apenas espaços, compare os quatro primeiros e os últimos caracteres e peça outro valor. Não edite dígitos.

Um verificador de IBAN é uma verificação bancária?

Não. O verificador testa a sequência e o formato; um serviço autorizado confirma a relação da conta conforme suas regras.

Lista segura para validar um IBAN

Valide em camadas: use uma fonte confiável, normalize espaços, escolha a regra do país, confira comprimento e BBAN e execute MOD-97. Informe o estado exato e mantenha os erros fáceis de corrigir.

Um resultado aprovado significa que a sequência é consistente nas regras testadas. Não prova que a conta existe, quem é o titular ou que o pagamento será liquidado. Essas decisões exigem o banco ou um provedor autorizado.

Referências de formato e implementação