Guia técnico de IBAN

Calcular os dígitos de controlo do IBAN com MOD 97: fórmula, exemplo e código

Um IBAN passa a verificação do checksum quando o resto da divisão por 97 é 1, depois de reorganizar e expandir os seus caracteres. O cálculo pode ser feito dígito a dígito, sem criar um número inteiro enorme.

Acompanhe um exemplo GB completo, aprenda a gerar os dígitos a partir de uma BBAN no formato nacional e consulte exemplos em JavaScript e Python. Um checksum aprovado verifica uma cadeia de caracteres; não confirma que um banco emitiu uma conta.

Ilustração editorial de uma sequência IBAN transformada num fluxo numérico para verificar o resto MOD 97
O checksum reorganiza e expande os caracteres do IBAN antes de verificar o resto.

O que verifica o checksum MOD 97 do IBAN

Um IBAN combina um código de país de duas letras, dois dígitos de controlo e uma BBAN específica desse país. O MOD 97 verifica a relação matemática dos dígitos de controlo nessa cadeia. Não consulta um banco nem uma rede de pagamentos.

Mantenha separados a sintaxe da entrada, o comprimento e o padrão BBAN registados para o país e o checksum. A Swift publica o Registo IBAN ISO 13616 com os formatos nacionais. A ISO/IEC 7064 descreve sistemas de caracteres de controlo destinados a detetar erros comuns de cópia ou digitação.

CamadaPergunta respondidaExemplo de falha
Sintaxe da entradaEstes caracteres e espaços são permitidos?Existe uma barra, pontuação ou símbolo não suportado.
Formato do paísEste país usa este comprimento e padrão BBAN?O código do país aparece com um comprimento total incorreto.
Checksum MOD 97Os caracteres satisfazem a relação dos dígitos de controlo?Um caráter alterado faz com que o resto deixe de ser 1.
Verificação bancária ou do pagamentoA conta existe e pode receber este pagamento?É necessário um banco ou serviço autorizado, não MOD 97.

Checksum IBAN MOD 97: as quatro etapas do cálculo

Comece pelo IBAN eletrónico: remova os espaços de apresentação permitidos e passe as letras ASCII para maiúsculas, mas rejeite outros símbolos. Mova os quatro primeiros caracteres para o fim. Substitua cada letra de A a Z pelo respetivo valor decimal, de 10 a 35; os dígitos ficam iguais.

Processe os dígitos expandidos da esquerda para a direita. Comece em zero e atualize resto = (resto × 10 + dígito) mod 97. O valor acumulado permanece entre 0 e 96, por isso não é necessário um número inteiro enorme. Um resto final de 1 satisfaz a relação do checksum.

Diagrama de quatro etapas: rodar o prefixo IBAN, converter letras em números, processar os dígitos módulo 97 e comparar o resto com um
O diagrama resume a transformação; o exemplo explicado mostra a cadeia e a aritmética exatas.
  1. NormalizarRemova os espaços permitidos, converta letras ASCII para maiúsculas e rejeite caracteres não suportados.
  2. RodarMova os quatro primeiros caracteres do IBAN para o fim.
  3. Expandir letrasSubstitua A–Z por 10–35 e mantenha os dígitos decimais.
  4. Processar módulo 97Atualize o resto para cada dígito e aceite o checksum apenas se terminar em 1.

Exemplo explicado: verificar GB82 WEST 1234 5698 7654 32

Este valor é um exemplo matemático, não uma consulta a uma conta. Depois de remover os espaços e mover os quatro primeiros caracteres, obtém-se WEST12345698765432GB82. Ao converter W=32, E=14, S=28, T=29, G=16 e B=11, a sequência fica 3214282912345698765432161182.

A tabela processa a sequência por blocos. Cada bloco novo é acrescentado ao resto anterior de acordo com o seu comprimento decimal, sem construir um número inteiro enorme.

  • Preserve os zeros iniciais de cada bloco; os blocos são texto para cálculo, não números de conta a normalizar.
  • O resto final é 1. Isso não prova que o valor pertença a uma conta bancária ativa.
Ponto do cálculoDígitos processadosResto
Após o primeiro bloco321428291223
Acrescentar os 10 dígitos seguintes345698765458
Acrescentar os 8 últimos dígitos321611821
Resultado final3214282912345698765432161182 mod 97Checksum coerente

Gerar os dígitos de controlo do IBAN a partir de uma BBAN

A validação começa com um IBAN completo que já contém dois dígitos de controlo. A geração começa com o código do país e uma BBAN no formato nacional correto. O checksum não indica que conta ou dados bancários deve usar.

Para calcular os dígitos, forme um valor temporário com o código do país, 00 e a BBAN. Mova os quatro primeiros caracteres, expanda as letras e calcule o resto r módulo 97. Os dígitos são 98 − r, com duas posições decimais. Coloque-os depois do código do país e valide o IBAN completo; o resto deve ser 1. Para a BBAN GB WEST12345698765432, o valor temporário GB00... deixa resto 16. Portanto, 98 − 16 = 82 e obtém-se GB82WEST12345698765432. A conta produz dígitos, não dados bancários verificados.

  1. Começar pela BBAN corretaObtenha os campos bancários de acordo com o formato nacional registado.
  2. Inserir dígitos provisóriosForme código do país + 00 + BBAN e depois rode e expanda os caracteres.
  3. Calcular dois dígitosSubtraia o resto a 98 e use zero inicial quando necessário.
  4. Verificar o resultadoInsira os dígitos e confirme que o IBAN completo deixa resto 1.

Implementação JavaScript sem um número inteiro enorme

Esta função verifica a sintaxe básica e o checksum. Um validador de produção também deve aplicar o comprimento e o padrão BBAN atuais do país.

function ibanMod97Remainder(input) {
  const iban = input.replace(/ /g, "").toUpperCase();
  if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]+$/.test(iban)) {
    throw new Error("Sintaxe de IBAN inválida");
  }

  let remainder = 0;
  const rotated = iban.slice(4) + iban.slice(0, 4);
  for (const character of rotated) {
    const expanded = character >= "A" && character <= "Z"
      ? String(character.charCodeAt(0) - 55)
      : character;
    for (const digit of expanded) {
      remainder = (remainder * 10 + Number(digit)) % 97;
    }
  }
  return remainder;
}

ibanMod97Remainder("GB82 WEST 1234 5698 7654 32"); // 1

Separe uma falha de checksum de uma falha de sintaxe ou de formato nacional; o código não verifica uma conta bancária.

Cálculo progressivo em Python

O mesmo ciclo com resto limitado funciona em Python. O exemplo mantém o IBAN como texto e consulta um registo atualizado para as regras nacionais de formato.

import re

source = "GB82 WEST 1234 5698 7654 32"
iban = re.sub(r" ", "", source).upper()
if re.fullmatch(r"[A-Z]{2}[0-9]{2}[A-Z0-9]+", iban) is None:
    raise ValueError("Sintaxe de IBAN inválida")

rotated = iban[4:] + iban[:4]
remainder = 0
for character in rotated:
    expanded = str(ord(character) - 55) if "A" <= character <= "Z" else character
    for digit in expanded:
        remainder = (remainder * 10 + int(digit)) % 97
print(remainder)  # 1
  • O exemplo devolve 1; o código de produção deve comunicar erros de análise e de checksum separadamente.

Mantenha a aritmética do checksum testável de forma independente quando os dados nacionais forem atualizados.

Testes e limites de uma implementação de checksum IBAN

Teste o cálculo e o analisador com exemplos identificados, entradas malformadas e valores sintéticos. A normalização pode remover espaços de impressão permitidos e converter ASCII para maiúsculas; não deve eliminar pontuação arbitrária, substituir caracteres parecidos nem adivinhar dados em falta.

  • Use valores sintéticos nos testes e oculte dados bancários reais nos diagnósticos. MOD 97 deteta erros; não autentica nem aprova pagamentos.
TesteComportamento esperadoCamada
Exemplo conhecido coerente com o checksumResto 1Checksum
Um carácter alteradoIndicar um resto diferente de 1Checksum
Zero inicial num campo numéricoPreservar o zeroAnálise e checksum
Comprimento incorreto ou pontuação não permitidaIndicar erro de formato ou sintaxeValidação da entrada

O que um checksum IBAN MOD 97 válido não prova

Um resto de 1 prova apenas que os caracteres satisfazem a relação matemática do checksum. Não prova que um banco atribuiu o IBAN, que a conta está aberta, que o destinatário é o titular ou que a conta pode receber um pagamento.

Um processo de produção pode exigir um registo nacional atualizado, confirmação do destinatário ou um serviço autorizado de verificação. Mantenha os estados separados, por exemplo: formato aceite, checksum aprovado e dados bancários não verificados. Para uma transferência real, use o IBAN fornecido pelo banco; não altere dígitos para forçar um resultado.

Perguntas frequentes sobre checksum IBAN MOD 97

MOD 97 é o mesmo que verificar a conta bancária?

Não. Verifica a consistência matemática dos caracteres do IBAN. Não consulta um banco nem confirma atribuição, estado, titularidade, identidade do destinatário ou possibilidade de pagamento.

Que resto deve produzir um IBAN coerente com o checksum?

Depois de mover os quatro primeiros caracteres e expandir as letras, o resto final deve ser 1. Verifique separadamente o comprimento e o padrão BBAN do país.

Como calcular os dígitos de controlo do IBAN a partir de uma BBAN?

Forme código do país + 00 + BBAN, mova os quatro primeiros caracteres, expanda as letras e calcule o resto. Subtraia-o a 98, preencha duas posições, insira os dígitos e verifique o IBAN completo.

Devo aplicar este algoritmo a todos os formatos nacionais?

A etapa internacional do checksum é comum, mas o comprimento e a estrutura BBAN dependem do país. Consulte um registo atualizado, como o Registo IBAN publicado pela Swift, antes de validar o formato completo.

Lista de verificação da implementação

Normalize apenas entradas permitidas, verifique o formato nacional, rode os caracteres, expanda as letras e processe MOD 97. Aceite o checksum apenas quando o resto final for 1.

Para uma verificação prática, abra o verificador de IBAN; para gerar dígitos a partir de uma BBAN, use a calculadora de IBAN. Nenhuma ferramenta substitui a verificação bancária.

Referências de normas e formatos