Checkout, registo e criação de clientes
Valide os IBAN antes de o formulário os guardar
Permita que os clientes corrijam dados bancários enquanto ainda estão no formulário. Adicione validação IBAN no servidor ao checkout, registo ou criação de clientes com a API IBAN-Test.
40 países
Consultas bancárias quando existem dados de origem
115 formatos IBAN
Regras nacionais, comprimento e dígitos de controlo
REST API
Pedidos autenticados e respostas JSON
Porquê fazer esta verificação
Dê informações úteis durante a introdução dos dados
Detete dados com formato incorreto
Verifique o formato nacional, o comprimento esperado e os dígitos de controlo antes de aceitar o IBAN enviado.
Vá além dos dígitos de controlo
Utilize os diretórios disponíveis para identificar a instituição e distinguir a validade formal de uma correspondência bancária.
Mantenha o token de API no servidor
Consulte o IBAN-Test a partir do backend e devolva o resultado necessário ao formulário sem expor o token Bearer no navegador.
Dos dados a um resultado útil
Como integrar a verificação no seu processo
Passo 1: Recolha o IBAN no formulário
Receba os dados do cliente e envie-os para o seu backend. O endpoint de validação também aceita IBAN com espaços.


Passo 2: Valide a partir do backend
Envie um pedido com o token de API. Avalie a resposta HTTP e o código JSON: HTTP 200 e error:false, por si só, não confirmam dados bancários válidos.
Passo 3: Apresente um resultado que permita agir
Peça ao cliente que corrija dados inválidos. Distinga falhas de autenticação, limite ou serviço temporário de um IBAN inválido.

A API na prática
Uma validação no servidor para a sua aplicação
Utilize a API com o backend que já tem. Os nossos pacotes descarregáveis incluem exemplos para várias linguagens e ferramentas, gestão do token no servidor e tratamento separado de erros de validação e de pedido.
Pedido de validação autenticado
curl -X POST "https://www.iban-test.eu/api/v2/iban/validate" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
--data '{"iban":"DE89370400440532013000"}'IBAN de referência publicado para exemplos de integração.
Excerto da resposta de validação
{
"error": false,
"code": 2100,
"message": "IBAN is valid"
}Excerto ilustrativo. Avalie a resposta completa e o estado HTTP.
Distinga erros de introdução de dados e falhas do serviço
Numa validação individual, o código 2100 indica um IBAN válido. Códigos como 3100 identificam dados inválidos. Um problema de autenticação ou limite exige uma mensagem de serviço e não a indicação de que a conta do cliente está errada.
Pacotes de integração: PHP · Python / CSV · Excel / Power Query · Google Sheets / Apps Script · n8n · Participação SEPA
