Validação de IBAN: Muito Além do Checksum

A maioria das bibliotecas de validação de IBAN apenas executa um checksum módulo-97. Isso detecta erros de digitação, mas não diz nada sobre se o banco existe, qual é seu código BIC ou se ele participa do SEPA. A API de Validação de IBAN da Veille (GET /v1/vat/iban) vai além, retornando os dados completos do banco junto com a verificação matemática.

O que a API retorna

Para qualquer IBAN, você obtém: valid (booleano), bank_name, bic (código SWIFT), country_code, country_name, a decomposição estrutural (bank_code, branch_code, account_number, bban) e in_sepa_zone.

Integração rápida

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.veille.io/v1"

response = requests.get(
    f"{BASE_URL}/vat/iban",
    params={"query": "FR7630006000011234567890189"},
    headers={"x-api-key": API_KEY},
)
data = response.json()

if data["valid"] and data["in_sepa_zone"]:
    print(f"SEPA-ready - {data['bank_name']} (BIC: {data['bic']})")
else:
    print("IBAN invalid or outside SEPA zone")

TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.veille.io/v1";
const headers = { "x-api-key": API_KEY };

const response = await fetch(
  `${BASE_URL}/vat/iban?query=FR7630006000011234567890189`,
  { headers }
);
const data = await response.json();

if (data.valid && data.in_sepa_zone) {
  console.log(`SEPA-ready - ${data.bank_name} (BIC: ${data.bic})`);
} else {
  console.log("IBAN invalid or outside SEPA zone");
}

Campos principais da resposta

• valid - validação estrutural e de checksum completa
• bank_name - a instituição por trás do IBAN
• bic - código BIC/SWIFT para roteamento
• in_sepa_zone - se o banco suporta transferências SEPA
• bank_code / branch_code / account_number - decomposição do BBAN

5 casos de uso

1. Validação em formulário de pagamento - verifique o IBAN e exiba o nome do banco antes de o usuário enviar, reduzindo transferências com falha.
2. Débito Direto SEPA - confirme a participação na zona SEPA antes de configurar um mandato para evitar débitos rejeitados.
3. Pagamentos a fornecedores - resolva automaticamente o BIC a partir do IBAN para preencher os detalhes de transferência bancária.
4. Onboarding KYC - cruze o país do banco com o país de residência declarado pelo cliente.
5. Sistemas de pagamento - valide os IBANs de freelancers ou criadores de conteúdo antes de agendar pagamentos para evitar transações com falha.

Artigos relacionados

• Validação de IVA para empresas SaaS europeias - validar números de IVA da UE junto com IBANs para verificação B2B completa
• Construindo um pipeline de detecção de fraudes - combinar sinais de pagamento, email e IP para prevenção completa de fraudes
• Usar a API Veille em uma empresa autônoma Paperclip - validação de IBAN e IVA integrada em um agente de faturamento autônomo do Paperclip