> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Validación de BIC
> El endpoint `bic` valida códigos de identificación bancaria, proporcionando un desglose detallado de códigos bancarios, información del país y tipos de institución para operaciones bancarias internacionales.
## 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:
```json theme={"system"}
{
"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
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.
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](https://www.json.org/json-en.html) universal y ligero.
El BIC normalizado sin espacios, devuelto en formato mayúsculas.
Resultado general de la validación que indica si el BIC es válido según todas las reglas de validación.
El código de país ISO de dos letras (p. ej., DE para Alemania, US para Estados Unidos).
El nombre completo del país asociado al BIC.
El código identificador bancario de 4 caracteres (p. ej., DEUT para Deutsche Bank).
El nombre del banco (actualmente muestra "Bank information not available").
El código de ubicación de 2 caracteres que indica la ciudad o región (p. ej., FF para Fráncfort).
El código de sucursal de 3 caracteres (opcional, puede estar vacío para BIC de 8 caracteres).
Información detallada adicional sobre el tipo y el estado del BIC.
El tipo de identificador (normalmente "BIC").
Si el BIC está actualmente activo y en uso.
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:**
```json theme={"system"}
{
"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:**
```json theme={"system"}
{
"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:**
```json theme={"system"}
{
"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:**
```json theme={"system"}
{
"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:**
```json theme={"system"}
{
"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:**
```json theme={"system"}
{
"error": {
"message": "Missing bic",
"code": "missing_bic"
}
}
```
### Clave API faltante
**Solicitud:**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
```
**Respuesta:**
```json theme={"system"}
{
"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](/bank-validation/countries).
## 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