Saltar al contenido principal
GET
/
v1
/
bic
Validación de 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"
  }
}

​
Primeros pasos

​
URL base

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

​
Endpoint de validación

El endpoint bic requiere su clave API y un parámetro BIC para realizar una validación exhaustiva de códigos de identificación bancaria. 
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
Esta solicitud exitosa valida un BIC alemán y devuelve información detallada: 
{
  "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 solicitud

​
api_key
String
requerido
Su clave API única. Tenga en cuenta que cada usuario tiene claves API únicas para cada una de las APIs de Cleariflow, por lo que su clave de la API de validación bancaria no funcionará para su API de tipos de cambio, por ejemplo.
​
bic
String
requerido
El código de identificación bancaria a validar. Se permiten espacios y se eliminarán automáticamente durante el procesamiento. El BIC debe seguir el formato estándar ISO 9362.

​
Parámetros de respuesta

La respuesta de la API se devuelve en un formato JSON universal y ligero.
​
bic
String
El BIC normalizado sin espacios, devuelto en formato mayúsculas.
​
is_valid
Boolean
Resultado general de la validación que indica si el BIC es válido según todas las reglas de validación.
​
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
El nombre completo del país asociado al BIC.
​
bank_code
String
El código identificador bancario de 4 caracteres (p. ej., DEUT para Deutsche Bank).
​
bank_name
String
El nombre del banco (actualmente muestra “Bank information not available”).
​
location_code
String
El código de ubicación de 2 caracteres que indica la ciudad o región (p. ej., FF para Fráncfort).
​
branch_code
String
El código de sucursal de 3 caracteres (opcional, puede estar vacío para BIC de 8 caracteres).
​
details
Object
Información detallada adicional sobre el tipo y el estado del BIC.
​
details.type
String
El tipo de identificador (normalmente “BIC”).
​
details.active
Boolean
Si el BIC está actualmente activo y en uso.
​
details.institution_type
String
El tipo de institución financiera (p. ej., “Bank”, “Credit Union”).

​
Ejemplos

​
BIC alemán válido (8 caracteres)

Solicitud: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
Respuesta: 
{
  "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án válido (11 caracteres con sucursal)

Solicitud: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
Respuesta: 
{
  "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 estadounidense válido

Solicitud: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
Respuesta: 
{
  "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 británico válido

Solicitud: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
Respuesta: 
{
  "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 no válido

Solicitud: 
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
Respuesta: 
{
  "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
  }
}

​
Manejo de errores

​
Parámetro BIC faltante

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

​
Clave API faltante

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

​
Estructura del BIC

El BIC consta de varios componentes:
  1. Código bancario (4 caracteres): identificador único de la institución financiera
  2. Código de país (2 caracteres): código de país ISO 3166-1 alpha-2
  3. Código de ubicación (2 caracteres): identificador de ciudad o región
  4. Código de sucursal (3 caracteres): identificador de sucursal opcional (XXX para oficina principal)

​
Ejemplos de formato

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

​
Códigos de ubicación comunes

  • FF: Fráncfort, Alemania
  • 33: Nueva York, Estados Unidos
  • 2L: Londres, Reino Unido
  • PP: París, Francia
  • MM: Milán, Italia

​
Reglas de validación

La API realiza una validación exhaustiva que incluye:
  1. Validación de longitud: comprueba si el BIC tiene 8 u 11 caracteres
  2. Validación de formato: verifica que el BIC siga el estándar ISO 9362
  3. Validación de caracteres: garantiza que solo se utilicen caracteres alfanuméricos
  4. Validación del código de país: valida el formato del código de país
  5. Validación del código bancario: comprueba el formato del identificador bancario

​
Requisitos de formato del BIC

  • Código bancario: 4 caracteres alfanuméricos
  • Código de país: 2 caracteres alfabéticos (ISO 3166-1)
  • Código de ubicación: 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: el nombre oficial del estándar ISO 9362
  • SWIFT: la red de mensajería que popularizó el código
  • Código SWIFT: nombre alternativo para BIC
Todos los BIC pueden utilizarse para mensajería SWIFT, pero no todos los códigos SWIFT son BIC válidos.

​
Países admitidos

La API admite la validación de BIC para más de 50 países, incluidos:
  • Europa: Alemania, Francia, Italia, España, Países Bajos, Bélgica, Austria, Suiza, Reino Unido, Polonia
  • América: Estados Unidos, Canadá, Brasil, México
  • Asia: Japón, Singapur, Hong Kong, Australia
  • África: Sudáfrica, Egipto, Nigeria
Para una lista completa de países admitidos, consulte la página Países admitidos.

​
Casos de uso

La validación de BIC es esencial para:
  1. Transferencias internacionales: garantizar información de enrutamiento precisa
  2. Pagos SEPA: requisitos del sistema de pagos europeo
  3. Aplicaciones bancarias: validación de cuentas de clientes
  4. Cumplimiento financiero: requisitos de informes regulatorios
  5. Procesamiento de pagos: aplicaciones de comercio electrónico y fintech