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.

O formulário envia o IBAN ao backend para validação
O backend protege o token de API e avalia a resposta

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.

Distinga IBAN válidos, dados inválidos e erros do serviço

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

Todos os guias de integração · Documentação da API

Planos de API

Escolha um plano de API para o tráfego dos formulários

Compare os pacotes de API e escolha o limite adequado ao seu processo.

Os valores mensais são calculados para 30 dias. Aplica-se o limite por cada 24 horas.

* Ofertas apenas para utilização comercial; preços sem IVA.

Antes da integração

Perguntas sobre este caso de utilização

Posso chamar a API diretamente a partir de JavaScript no navegador?

Guarde o token Bearer no servidor. O formulário deve chamar o seu backend, que consulta o IBAN-Test e devolve a informação necessária à interface.

Ler a documentação de autenticação e integração

Um IBAN válido significa que a conta existe?

Não. A validade formal e as correspondências bancárias disponíveis não confirmam a existência da conta, o titular, a atividade ou a aptidão para pagamentos.

O que confirma a validação IBAN

O que devo fazer quando atingir o limite de pedidos?

Trate a resposta de limite como uma condição do serviço. Não assinale o IBAN do cliente como inválido. Suspenda as verificações até voltar a ter pedidos disponíveis ou escolha um pacote de API adequado.

Comparar planos de API e limites de pedidos

Existe um exemplo de integração funcional?

Sim. Os pacotes abrangem PHP, Python/CSV, Excel/Power Query, Google Sheets/Apps Script e n8n, além de um exemplo de participação SEPA. Escolha o pacote adequado à aplicação e siga as instruções de configuração.

Ver todos os pacotes e exemplos de integração

A sua próxima integração

Adicione uma verificação bancária ao próximo envio do formulário

Escolha o limite de pedidos, crie o acesso e ligue o endpoint de validação ao backend.

Escolher plano de API