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.
| Camada | Pergunta respondida | Exemplo de falha |
|---|---|---|
| Sintaxe da entrada | Estes caracteres e espaços são permitidos? | Existe uma barra, pontuação ou símbolo não suportado. |
| Formato do país | Este país usa este comprimento e padrão BBAN? | O código do país aparece com um comprimento total incorreto. |
| Checksum MOD 97 | Os 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 pagamento | A 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.
- NormalizarRemova os espaços permitidos, converta letras ASCII para maiúsculas e rejeite caracteres não suportados.
- RodarMova os quatro primeiros caracteres do IBAN para o fim.
- Expandir letrasSubstitua A–Z por 10–35 e mantenha os dígitos decimais.
- 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álculo | Dígitos processados | Resto |
|---|---|---|
| Após o primeiro bloco | 3214282912 | 23 |
| Acrescentar os 10 dígitos seguintes | 3456987654 | 58 |
| Acrescentar os 8 últimos dígitos | 32161182 | 1 |
| Resultado final | 3214282912345698765432161182 mod 97 | Checksum 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.
- Começar pela BBAN corretaObtenha os campos bancários de acordo com o formato nacional registado.
- Inserir dígitos provisóriosForme código do país + 00 + BBAN e depois rode e expanda os caracteres.
- Calcular dois dígitosSubtraia o resto a 98 e use zero inicial quando necessário.
- 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.
| Teste | Comportamento esperado | Camada |
|---|---|---|
| Exemplo conhecido coerente com o checksum | Resto 1 | Checksum |
| Um carácter alterado | Indicar um resto diferente de 1 | Checksum |
| Zero inicial num campo numérico | Preservar o zero | Análise e checksum |
| Comprimento incorreto ou pontuação não permitida | Indicar erro de formato ou sintaxe | Validaçã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
- Registo IBAN da Swift e número internacional de conta bancária — A Swift publica o registo ISO 13616 das especificações nacionais dos formatos IBAN.
- Sistemas de caracteres de controlo ISO/IEC 7064:2003 — A página oficial descreve sistemas de controlo que ajudam a detetar erros de cópia e digitação.