Números IBAN de teste: dados sintéticos seguros para QA

O que é um IBAN de teste?

Um IBAN de teste é um International Bank Account Number sintético criado para exercitar o comportamento de um software. Pode ser usado em campos de pagamento, seletores de país, normalização, fixtures de API, testes de navegador, demonstrações, formação e documentação. O valor pode seguir o comprimento e as classes de caracteres do país escolhido e passar pelo checksum matemático necessário ao seu código.

A palavra importante é teste. Um valor gerado não localiza uma conta real, não identifica um beneficiário e não consulta um diretório bancário. O gerador IBAN em massa cria linhas sintéticas e o verificador de IBAN analisa a cadeia fornecida; nenhum dos dois contacta um banco.

• Uso adequado: validação de formulários, parsers, fixtures, regressões, demos e documentação técnica.
• Uso inadequado: transferências, débitos diretos, criação de beneficiários, prova de titularidade ou descoberta de contas.
• Guarde a finalidade, o limite do ambiente e a regra de limpeza junto ao fixture.

Dados sintéticos não são uma conta bancária real

Um valor sintético serve para exercitar um formato. Pode ter o prefixo de país correto, o comprimento esperado, classes de caracteres BBAN plausíveis e resto MOD-97 igual a 1. Estas verificações respondem apenas a uma pergunta de engenharia: a cadeia é estruturalmente compatível com a regra escolhida?

Um IBAN emitido por um banco responde a outras perguntas. Pode estar ligado a uma conta, banco, agência, moeda, beneficiário e estado atual. Uma verificação local não demonstra esses factos a partir dos caracteres.

Valide um IBAN de teste em três camadas

Um fixture útil não é apenas uma cadeia aleatória. Comece pelo formato registado do país e teste cada camada separadamente. O diretório de países IBAN ajuda a comparar comprimentos e padrões BBAN; o descodificador IBAN mostra as partes visíveis de um valor completo.

Primeiro confirme o código do país e o comprimento total. Depois verifique se o BBAN aceita caracteres numéricos, alfabéticos ou alfanuméricos. Por fim execute MOD-97-10. Inclua valores que passam e falhas intencionais, porque o tratamento do erro também faz parte do contrato.

1. 1. País e comprimentoSelecione um país suportado e confirme o comprimento fixo registado para o valor completo.
2. 2. Padrão de caracteresConfirme que cada campo nacional aceita os dígitos ou letras definidos pela regra.
3. 3. Checksum MOD-97Execute o cálculo internacional e confirme o resto esperado.
4. 4. Limite de negócioRegiste que o resultado é apenas estrutural; não o transforme numa afirmação de titularidade ou pagamento.

• Separe o erro de comprimento do erro de checksum para explicar o primeiro problema útil.
• Altere um único dígito de controlo num fixture válido para testar um erro preciso.
• Use uma letra num campo numérico apenas quando o caso negativo for intencional e estiver documentado.

Fluxo seguro para um fixture de QA

Trate um IBAN de teste como qualquer fixture sintético: defina o objetivo, gere-o com uma regra conhecida, valide-o, etiquete-o e mantenha-o dentro do ambiente que precisa dele. Uma cadeia matematicamente válida pode ser perigosa se for parar a uma seed de produção, exportação de clientes, fatura ou lista de beneficiários.

Para poucos casos, crie um valor com o gerador da página inicial. Para uma matriz ou regressão, use o gerador em massa para exportar CSV ou JSON e acrescente país, comprimento, resultado esperado, finalidade e responsável pela limpeza ao seu fixture.

1. DefinirEscreva o país, o comportamento do campo, o resultado esperado e o motivo do fixture.
2. GerarCrie valores sintéticos segundo a regra do país; não copie contas de clientes.
3. ValidarExecute asserções de comprimento, padrão e MOD-97 e guarde o resultado esperado.
4. Isolar e limparMantenha o fixture em datasets de teste, bloqueie a promoção e elimine ou rode os valores após a execução.

Crie uma matriz de testes, não apenas um caso feliz

Um único valor aprovado prova muito pouco. Cubra vários comprimentos e padrões BBAN, formato impresso com espaços, formato eletrónico compacto, letras minúsculas, um dígito alterado e valores demasiado curtos ou longos. Se um fornecedor de pagamentos disponibilizar identificadores próprios de sandbox, siga a sua documentação e mantenha-os separados dos fixtures genéricos.

Guarde no fixture o país, o resultado esperado, o formato de apresentação e o motivo do erro para reproduzir tanto o sucesso como a falha.

• Guarde os resultados esperados junto aos fixtures para rever alterações no validador.
• Use IDs descritivos como iban-de-length-22-valid em vez de uma cadeia aleatória sem etiqueta.
• Não inclua nomes, cartões, faturas ou extratos reais num caso sintético.

Erros comuns e limites práticos

O erro mais comum é tratar fake IBAN como se significasse um valor seguro para pagar. Em código e documentação, prefira IBAN de teste, IBAN sintético ou fixture IBAN. Para uma transferência real, obtenha os dados junto do banco ou fornecedor autorizado.

Outro erro é tratar um verificador como uma consulta bancária. A ferramenta pode explicar os caracteres, mas não sabe se o identificador está ativo, se a conta pertence a uma pessoa, se o beneficiário passou por controlos ou se o pagamento será liquidado.

• Não chame um valor sintético de oficial, seguro para pagar, atribuído ou verificado por titularidade.
• Não deduza um IBAN a partir de um nome, cartão, conta local ou captura de ecrã.
• Não publique um fixture numa fatura, instrução de reembolso, ficheiro salarial ou mandato de débito direto.
• Não inclua nomes, cartões, faturas ou extratos reais num caso sintético.