Dados de teste para programadores
IBAN de teste: exemplos e casos para testar o seu software
Precisa de um IBAN de teste de Portugal ou de outro país? Aqui encontra exemplos publicados com o formato nacional e a verificação MOD-97 corretos, além de variantes deliberadamente incorretas para testar formulários e aplicações.
Exemplo de referência do registo IBAN da SWIFT. Utilize-o para desenvolvimento, testes e documentação; não crie ordens de pagamento a partir deste valor. A validade formal não confirma a titularidade nem a existência de uma conta ativa.
Exemplos de IBAN de Portugal e de outros países
Os 7 valores de referência provêm do registo IBAN da SWIFT, versão 101. O formato nacional, o comprimento e os dígitos de controlo foram recalculados localmente em 15 de outubro de 2026. A função de cópia utiliza o formato eletrónico sem espaços.
| País | IBAN de teste | Caracteres | Ação |
|---|---|---|---|
| Portugal (PT) | 25 | ||
| Alemanha (DE) | 22 | ||
| Áustria (AT) | 20 | ||
| Suíça (CH) | 21 | ||
| França (FR) | 27 | ||
| Países Baixos (NL) | 18 | ||
| Reino Unido (GB) | 22 |
Um IBAN fictício com dígitos de controlo corretos não demonstra que os dados bancários sejam válidos. Por exemplo, o código do banco pode não constar de um diretório atualizado. Determine separadamente se a sua aplicação deve verificar apenas o formato e os dígitos de controlo ou também identificar o banco.
Casos de teste para dados válidos e inválidos
Estes oito casos abrangem normalização, campos obrigatórios, comprimento, caracteres permitidos e dígitos de controlo. O resultado esperado refere-se ao formato após a normalização. Não garante um código de estado da API; a ordem das verificações pode variar entre implementações.
| Caso de teste | Dados introduzidos | Resultado esperado no formulário |
|---|---|---|
| Exemplo de referência português | PT50000201231234567890154 | Formalmente válido após a normalização |
| Remover espaços durante a normalização | PT50 0002 0123 1234 5678 9015 4 | Formalmente válido após a normalização |
| Normalizar letras minúsculas | pt50000201231234567890154 | Formalmente válido após a normalização |
| Dígitos de controlo alterados deliberadamente para 00 | PT00000201231234567890154 | Dígitos de controlo incorretos |
| Falta um carácter | PT5000020123123456789015 | Comprimento incorreto |
| Um carácter a mais | PT500002012312345678901540 | Comprimento incorreto |
| Carácter especial não permitido | PT5000020123123456789015! | Carácter não permitido |
| Campo obrigatório vazio | (vazio) | Falta um campo obrigatório |
Os ficheiros são gerados no navegador a partir destes exemplos fixos e não exigem uma conta. Pode incorporá-los no seu projeto como dados de teste.
IBAN de teste, gerador ou validação de IBAN?
- IBAN de teste: Um valor fixo para testes reproduzíveis de formulários e aplicações.
- Gerador de IBAN: Calcula um IBAN a partir dos dados bancários introduzidos. Utilize o gerador de IBAN.
- Validação de IBAN: Verifica um IBAN existente e acrescenta as informações bancárias disponíveis. Utilize o verificador de IBAN online.
Para pagamentos num ambiente de testes, siga as instruções do seu prestador de serviços de pagamento e utilize os dados e o modo de teste documentados por ele. Esta coleção não define cenários de pagamento bem-sucedido ou falhado específicos de um prestador.
Integre a validação de IBAN na sua aplicação
Utilize a API de validação de IBAN para automatizar verificações em formulários, lojas ou processos ERP. Os casos desta página descrevem os resultados esperados para o formato; a API pode efetuar verificações adicionais.
curl --request POST 'https://www.iban-test.eu/api/v2/iban/validate' \
--header 'Authorization: Bearer YOUR_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"iban":"PT50000201231234567890154"}'Na validação de IBAN, 2100 indica um resultado válido. Um resultado negativo, como 3100, pode ser devolvido com error: false. Avalie o código do resultado e trate separadamente os erros de autenticação, de quota e técnicos. A documentação da API descreve as respostas.
O seu acesso pessoal à API inclui 10 consultas gratuitas por período de 24 horas. Os exemplos acima continuam disponíveis sem registo.
Perguntas frequentes sobre IBAN de teste
Um IBAN de teste corresponde a uma conta bancária real?
Um exemplo publicado não demonstra a existência de uma conta ativa. Estes exemplos ilustram o formato e os dígitos de controlo. Utilize-os apenas para desenvolvimento, testes e documentação.
Porque pode um IBAN de teste ser rejeitado apesar de ter dígitos de controlo corretos?
A sua aplicação pode aplicar regras adicionais, como consultar o código do banco ou efetuar uma verificação nacional da conta. Um ambiente de testes também pode aceitar apenas valores específicos. Passar a verificação MOD-97, por si só, não cumpre estes requisitos.
Como posso testar espaços e letras minúsculas?
Normalize os dados de acordo com as regras da sua aplicação. As variantes PT50 0002 0123 1234 5678 9015 4 e pt50000201231234567890154 devem produzir o mesmo valor de referência após remover os espaços e converter as letras para maiúsculas.