Saltar para o conteúdo principal
GET
/
v1
/
bic
Validação BIC
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/bic/
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
Primeiros passos

​
URL base

https://bankvalidation.cleariflow.com/v1/bic/

​
Endpoint de validação

O endpoint bic requer a sua chave API e um parâmetro BIC para realizar uma validação abrangente de Business Identifier Codes. 
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
Este pedido bem-sucedido valida um BIC alemão e devolve informação detalhada: 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
Parâmetros de pedido

​
api_key
String
obrigatório
A sua chave API única. Tenha em conta que cada utilizador tem chaves API únicas para cada uma das APIs Cleariflow, por isso a sua chave da API de validação bancária não funcionará para a sua API de taxas de câmbio, por exemplo.
​
bic
String
obrigatório
O Business Identifier Code a validar. São permitidos espaços e serão removidos automaticamente durante o processamento. O BIC deve seguir o formato padrão ISO 9362.

​
Parâmetros de resposta

A resposta da API é devolvida num formato JSON universal e leve.
​
bic
String
O BIC normalizado sem espaços, devolvido em maiúsculas.
​
is_valid
Boolean
Resultado geral da validação que indica se o BIC é válido de acordo com todas as regras de validação.
​
country_code
String
El código de país ISO de dos letras (p. ej., DE para Alemania, US para Estados Unidos).
​
country_name
String
O nome completo do país associado ao BIC.
​
bank_code
String
O código identificador bancário de 4 caracteres (p. ex., DEUT para Deutsche Bank).
​
bank_name
String
O nome do banco (atualmente mostra “Bank information not available”).
​
location_code
String
O código de localização de 2 caracteres que indica a cidade ou região (p. ex., FF para Frankfurt).
​
branch_code
String
O código de sucursal de 3 caracteres (opcional, pode estar vazio para BIC de 8 caracteres).
​
details
Object
Informação detalhada adicional sobre o tipo e o estado do BIC.
​
details.type
String
O tipo de identificador (normalmente “BIC”).
​
details.active
Boolean
Se o BIC está atualmente ativo e em uso.
​
details.institution_type
String
O tipo de instituição financeira (p. ex., “Bank”, “Credit Union”).

​
Exemplos

​
BIC alemão válido (8 caracteres)

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
Resposta: 
{
  "bic": "DEUTDEFF",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
BIC alemão válido (11 caracteres com sucursal)

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
Resposta: 
{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
BIC dos EUA válido

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
Resposta: 
{
  "bic": "CHASUS33",
  "is_valid": true,
  "country_code": "US",
  "country_name": "United States",
  "bank_code": "CHAS",
  "bank_name": "Bank information not available",
  "location_code": "33",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
BIC do Reino Unido válido

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
Resposta: 
{
  "bic": "NWBKGB2L",
  "is_valid": true,
  "country_code": "GB",
  "country_name": "United Kingdom",
  "bank_code": "NWBK",
  "bank_name": "Bank information not available",
  "location_code": "2L",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

​
BIC inválido

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
Resposta: 
{
  "bic": "INVALID",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "bank_name": "Bank information not available",
  "location_code": "",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true
  }
}

​
Tratamento de erros

​
Parâmetro BIC em falta

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY
Resposta: 
{
  "error": {
    "message": "Missing bic",
    "code": "missing_bic"
  }
}

​
Chave API em falta

Pedido: 
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
Resposta: 
{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

​
Estrutura do BIC

O BIC consiste em vários componentes:
  1. Código bancário (4 caracteres): identificador único da instituição financeira
  2. Código de país (2 caracteres): código de país ISO 3166-1 alpha-2
  3. Código de localização (2 caracteres): identificador de cidade ou região
  4. Código de sucursal (3 caracteres): identificador de sucursal opcional (XXX para escritório principal)

​
Exemplos de formato

  • BIC de 8 caracteres: DEUTDEFF (Deutsche Bank, Alemanha, Frankfurt)
  • BIC de 11 caracteres: DEUTDEFF500 (Deutsche Bank, Alemania, Fráncfort, sucursal 500)

​
Códigos de localização comuns

  • FF: Frankfurt, Alemanha
  • 33: Nova Iorque, Estados Unidos
  • 2L: Londres, Reino Unido
  • PP: Paris, França
  • MM: Milão, Itália

​
Regras de validação

A API realiza uma validação abrangente que inclui:
  1. Validación de longitud: comprueba si el BIC tiene 8 u 11 caracteres
  2. Validação de formato: verifica se o BIC segue o padrão ISO 9362
  3. Validación de caracteres: garantiza que solo se utilicen caracteres alfanuméricos
  4. Validação do código de país: valida o formato do código de país
  5. Validação do código bancário: verifica o formato do identificador bancário

​
Requisitos de formato do BIC

  • Código bancário: 4 caracteres alfanuméricos
  • Código de país: 2 caracteres alfabéticos (ISO 3166-1)
  • Código de localização: 2 caracteres alfanuméricos
  • Código de sucursal: 3 caracteres alfanuméricos (opcional)

​
BIC vs SWIFT

BIC (Business Identifier Code) y SWIFT se utilizan a menudo de forma intercambiable:
  • BIC: o nome oficial do padrão ISO 9362
  • SWIFT: a rede de mensagens que popularizou o código
  • Código SWIFT: nome alternativo para BIC
Todos os BIC podem ser usados para mensagens SWIFT, mas nem todos os códigos SWIFT são BIC válidos.

​
Países suportados

A API suporta validação de BIC para mais de 50 países, incluindo:
  • Europa: Alemanha, França, Itália, Espanha, Países Baixos, Bélgica, Áustria, Suíça, Reino Unido, Polónia
  • América: Estados Unidos, Canadá, Brasil, México
  • Ásia: Japão, Singapura, Hong Kong, Austrália
  • África: África do Sul, Egito, Nigéria
Para uma lista completa de países suportados, consulte a página Países suportados.

​
Casos de utilização

A validação de BIC é essencial para:
  1. Transferências internacionais: garantir informação de encaminhamento precisa
  2. Pagamentos SEPA: requisitos do sistema de pagamentos europeu
  3. Aplicações bancárias: validação de contas de clientes
  4. Conformidade financeira: requisitos de relatórios regulatórios
  5. Processamento de pagamentos: aplicações de comércio eletrónico e fintech