Você precisa validar os detalhes do banco rapidamente—números de roteamento para ACH, IBANs para SEPA e SWIFT/BICs para transferências internacionais—antes que sua próxima versão seja lançada. Ao final deste guia, você terá solicitações funcionais que verificam esses identificadores e retornam metadados bancários que você pode exibir em sua interface ou usar em seus fluxos de pagamento.
O que esta API resolve para seus fluxos de Finanças e Pagamentos
A API SWIFT - IBAN - Verificação de Banco de Roteamento fornece três endpoints de validação focados:
- Verificador de Banco de Roteamento: Valida um número de roteamento dos EUA e retorna metadados bancários (nome, cidade, estado, telefone, data da última revisão).
- Verificador de Código IBAN: Valida um IBAN e retorna informações do país e componentes analisados (código do banco, código da agência, BBAN, checksum).
- Verificador de Código SWIFT: Valida um SWIFT/BIC e retorna a identidade do banco, localização e uma análise do código.
Usos comuns incluem pré-validação de checkout para reduzir pagamentos falhados, formulários de integração que preenchem automaticamente os detalhes do banco após um usuário inserir um número, operações de tesouraria que verificam beneficiários e ferramentas de suporte que confirmam a identidade do banco durante disputas.
Começando no Zyla API Hub
Abra a listagem para esta API, inscreva-se e obtenha sua chave. O Zyla API Hub usa um modelo de assinatura + cota (não pago por chamada). Para uso pela primeira vez no hub, você pode começar com um teste de 7 dias ou 50 solicitações, dependendo das opções de acesso atuais da API; verifique a página da API para opções de acesso e preços atuais.
- Vá para a página da API e clique em Inscrever-se (ou Começar Teste Gratuito quando disponível).
- Copie sua chave da API.
- Envie solicitações com Authorization: Bearer YOUR_API_KEY.
O Zyla API Hub centraliza mais de 10.000 APIs públicas sob uma conta e uma chave. Você pode explorar mais categorias e APIs financeiras diretamente em zylalabs.com e gerenciar todas as assinaturas em um só lugar.
Comece o teste de 7 dias na API SWIFT - IBAN - Verificação de Banco de Roteamento
Autenticação
Envie sua chave no cabeçalho de Autorização:
- Cabeçalho: Authorization
- Valor: Bearer YOUR_API_KEY
Nenhum outro parâmetro de autenticação é necessário nos exemplos abaixo.
Endpoint: Verificador de Banco de Roteamento
Valide um número de roteamento dos EUA e recupere metadados bancários.
- Método: GET
- URL: https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker
- Parâmetro de consulta obrigatório:
- number (number): 121000248
exemplo cURL
curl -s -X GET "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker?number=121000248" \
-H "Authorization: Bearer YOUR_API_KEY"Resposta de exemplo oficial
{
"status": 200,
"success": true,
"message": "O Banco de Roteamento 031101334 é válido",
"data": {
"routing_number": "031101334",
"date_of_revision": "5 de Jan, 2023",
"new_routing_number": "",
"bank": "Sofi Bank, National Association",
"address": "San Francisco, CA",
"city": "San Francisco",
"state": "CA",
"zip": "",
"phone": "855-936-2269"
}
}O que usar em seu aplicativo:
- status, success, message: verificação rápida do estado de validação e cópia voltada para o usuário.
- data.routing_number: o número de roteamento validado (pode refletir atualizações, se aplicável).
- data.bank, data.city, data.state, data.phone: exibir metadados em formulários de integração ou ferramentas administrativas.
- data.date_of_revision e data.new_routing_number: úteis para reconciliação e tratamento de migrações.
Nota: date_of_revision é uma string de data legível por humanos. Se você precisar de ordenação ou comparações, analise-a em seu formato de data padrão no lado do servidor.
exemplo Python usando requests
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker"
params = {"number": "121000248"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, headers=headers, params=params, timeout=10)
resp.raise_for_status()
data = resp.json()
if data.get("success"):
bank_info = data.get("data", {})
print("Validado:", data.get("message"))
print("Roteamento:", bank_info.get("routing_number"))
print("Banco:", bank_info.get("bank"))
print("Localização:", f'{bank_info.get("city")}, {bank_info.get("state")}')
print("Telefone:", bank_info.get("phone"))
else:
# Lidar com falha de validação (por exemplo, mostrar um erro no formulário)
print("Validação falhou:", data.get("message"))Endpoint: Verificador de Código IBAN
Valide um IBAN e recupere detalhes do país e estruturais.
- Método: GET
- URL: https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- Parâmetro de consulta obrigatório:
- number (string): PT50000101231234567890192
Em caso de sucesso, você recebe o estado de validação e campos analisados, como:
- iban, country, sepa_country, checksum
- bban, bank_code, branch_code, account_number
Casos de uso:
- Preencher automaticamente os campos do nome do banco a jusante assim que um IBAN válido for fornecido.
- Roteamento específico para SEPA: verifique se sepa_country é igual a Sim antes de habilitar métodos de pagamento SEPA.
- Validação do lado do cliente antes de passar pagamentos para seu processador.
Endpoint: Verificador de Código SWIFT
Valide um SWIFT/BIC e recupere a identidade do banco e uma análise do código.
- Método: GET
- URL: https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- Parâmetro de consulta obrigatório:
- code (string): ADTVBRDF
Em caso de sucesso, você recebe o estado de validação, campos de identidade e uma análise estruturada, incluindo:
- swift_code, bank, city, branch, address, post_code, country, country_code
- breakdown.swift_code, breakdown.bank_code, breakdown.country_code, breakdown.location_code, breakdown.code_status, breakdown.branch_code
Implementações típicas:
- Mostrar banco e país assim que um pagador digitar um SWIFT/BIC, reduzindo a fricção do formulário.
- Barreiras na integração de pagamentos verificando se country_code está alinhado com o corredor esperado.
- Logs de auditoria: persista os campos de análise para rastrear por que um código foi aceito ou rejeitado.
Colocando tudo junto em seu produto
Formulários de checkout e pagamento
- Verificação do lado do cliente: acesse o endpoint relevante quando um campo perder o foco (debounced) e exiba a mensagem como feedback inline.
- Reverificação do lado do servidor: execute a mesma chamada antes de persistir ou iniciar um pagamento para evitar adulteração.
- Em caso de sucesso, armazene identificadores normalizados (routing_number, iban, swift_code) e metadados bancários para exibição e revisão.
Operações de tesouraria e finanças
- Verifique em lote listas de beneficiários durante a noite; registre mensagens e campos de dados para reconciliar atualizações (por exemplo, new_routing_number).
- Controle corredores transfronteiriços: use o país do IBAN e o country_code do SWIFT para habilitar trilhos específicos.
Ferramentas de suporte
- Construa um painel “Verificar detalhes do banco” que busca e exibe banco, cidade, estado/país e campos de contato para confirmações rápidas.
Notas operacionais e dicas de integração
- Idempotência: solicitações GET são seguras para cache. Armazene validações positivas (e metadados bancários associados) para beneficiários comumente usados.
- Datas: date_of_revision é uma string legível por humanos; analise conforme necessário para armazenamento ou comparações.
- Internacional vs doméstico: direcione ACH dos EUA para Verificador de Banco de Roteamento; use Verificador de Código IBAN para regiões de IBAN; use Verificador de Código SWIFT em todos os lugares onde você coleta BICs.
- Tratamento de erros: verifique sucesso e status antes de consumir dados. Sempre exiba uma mensagem clara e acionável para o usuário.
- Taxa de transferência e cotas: o uso é por assinatura + cota. Verifique a página da API para opções de acesso e preços atuais.
Chame a API através de agentes de IA usando MCP
Se você orquestra fluxos de trabalho financeiros com ferramentas compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf), pode chamar esta API através do endpoint MCP da Zyla. Configure seu agente para acessar:
Use sua chave da API Zyla (parâmetro de consulta apikey) e faça o agente invocar os endpoints da API SWIFT - IBAN - Verificação de Banco de Roteamento por seus caminhos de mercado. Isso permite que ferramentas autônomas validem números de roteamento, IBANs ou códigos SWIFT como parte de tarefas de múltiplos passos (por exemplo, analisar um CSV e depois verificar cada beneficiário).
Lista de verificação de testes
- Roteamento: teste com number=121000248 e verifique se você analisa mensagem, sucesso e campos de dados.
- IBAN: teste com number=PT50000101231234567890192 e confirme se sepa_country e componentes analisados são tratados.
- SWIFT: teste com code=ADTVBRDF e assegure-se de que você pode exibir campos de banco, país e análise.
- Timeouts e tentativas: defina timeouts de cliente sensatos e tente novamente apenas em erros de rede transitórios.
- Registro: armazene a mensagem e um subconjunto de campos de dados para trilhas de auditoria e diagnósticos de suporte.
Explore mais no Zyla API Hub
Gerencie todas as suas validações financeiras e mais sob uma chave em zylalabs.com. Quando você precisar expandir além das validações, navegue por outras listagens de Finanças & Pagamentos e integre-as ao mesmo processo de construção.
FAQ
Qual é a diferença entre códigos de roteamento, IBAN e SWIFT?
Um número de roteamento é usado para transferências domésticas nos EUA (ACH/transferências). Um IBAN é usado em muitos países (incluindo SEPA) e codifica informações de país, banco, agência e conta. Um SWIFT/BIC identifica um banco internacionalmente e é usado para pagamentos transfronteiriços.
Como faço para autenticar solicitações?
Envie Authorization: Bearer YOUR_API_KEY nos cabeçalhos da solicitação para cada chamada aos URLs do endpoint do mercado mostrados acima.
Posso usar isso a partir de uma função sem servidor?
Sim. Estas são solicitações padrão HTTPS GET com um cabeçalho para autenticação. Mantenha sua chave da API no gerenciador de segredos da sua plataforma e defina timeouts apropriados.
Os campos de resposta são estáveis?
Use os campos demonstrados nos exemplos (por exemplo, status, success, message, data.*). Se você precisar depender de campos adicionais, consulte a página da API para quaisquer atualizações antes de liberar para produção.
Quais são as opções de acesso e limites?
O hub usa um modelo de assinatura + cota. O acesso pela primeira vez geralmente oferece um teste de 7 dias ou 50 solicitações; verifique a página da API para opções de acesso e preços atuais.
Pronto para validar detalhes bancários e enviar com confiança? Comece sua integração aqui: Comece o teste de 7 dias na API SWIFT - IBAN - Verificação de Banco de Roteamento
