Validación de IBAN

GET

iban

Validación de IBAN

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

Primeros pasos

URL base

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

Endpoint de validación

El endpoint iban requiere su clave API y un parámetro IBAN para realizar una validación exhaustiva de números de cuenta bancaria internacional.

https://bankvalidation.cleariflow.com/v1/iban/
? api_key = YOUR_UNIQUE_API_KEY
& iban = DE89370400440532013000

Esta solicitud exitosa valida un IBAN alemán y devuelve información detallada:

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

Parámetros de solicitud

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.

String

requerido

El número de cuenta bancaria internacional a validar. Se permiten espacios y se eliminarán automáticamente durante el procesamiento. El IBAN debe seguir el formato estándar ISO 13616.

Parámetros de respuesta

La respuesta de la API se devuelve en un formato JSON universal y ligero.

String

El IBAN normalizado sin espacios, devuelto en formato mayúsculas.

Boolean

Resultado general de la validación que indica si el IBAN es válido según todas las reglas de validación.

String

El código de país ISO de dos letras (p. ej., DE para Alemania, FR para Francia).

String

El nombre completo del país asociado al IBAN.

String

El código identificador bancario extraído del IBAN según el formato específico del país.

String

La parte del número de cuenta del IBAN, excluyendo el código de país, el dígito de control y el código bancario.

Integer

La longitud real del IBAN proporcionado.

Integer

La longitud esperada para los IBAN del país específico según el estándar ISO 13616.

Boolean

Si la validación del dígito de control del IBAN pasó utilizando el algoritmo MOD-97.

Boolean

Si el formato del IBAN coincide con la estructura esperada para el país.

Object

Información detallada adicional sobre la estructura y el formato del IBAN.

String

Una representación visual de la estructura del IBAN usando marcadores de posición B (Banco), S (Sort), C (Cliente) y K (Clave).

String

Un ejemplo correctamente formateado del IBAN con espacios para facilitar la lectura.

String

El nombre del banco (actualmente muestra “Bank information not available”).

String

El código BIC del banco (actualmente muestra “BIC not available”).

String

El tipo de cuenta (normalmente “Bank Account”).

String

El código de moneda del país (p. ej., EUR para países de la zona euro, GBP para Reino Unido).

Ejemplos

IBAN alemán válido

Solicitud:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=DE89370400440532013000

Respuesta:

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

IBAN francés válido

Solicitud:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=FR1420041010050500013M02606

Respuesta:

{
  "iban": "FR1420041010050500013M02606",
  "is_valid": true,
  "country_code": "FR",
  "country_name": "France",
  "bank_code": "2004101005",
  "account_number": "0500013M02606",
  "length": 27,
  "expected_length": 27,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BSSS SSCC CCCC CCCC CCC KK",
    "example": "FR14 2004 1010 0505 0001 3M02 606",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

IBAN no válido

Solicitud:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=INVALID

Respuesta:

{
  "iban": "",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "account_number": "",
  "length": 7,
  "expected_length": 0,
  "checksum_valid": false,
  "format_valid": false,
  "details": {
    "structure": "",
    "example": ""
  }
}

Manejo de errores

Parámetro IBAN faltante

Solicitud:

GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY

Respuesta:

{
  "error": {
    "message": "Missing iban",
    "code": "missing_iban"
  }
}

Clave API faltante

Solicitud:

GET https://bankvalidation.cleariflow.com/v1/iban/?iban=DE89370400440532013000

Respuesta:

{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

Estructura del IBAN

El IBAN consta de varios componentes:

Código de país (2 caracteres): código de país ISO 3166-1 alpha-2
Dígitos de control (2 caracteres): validación mediante algoritmo MOD-97
Identificador bancario: código bancario específico del país
Número de cuenta: identificador de la cuenta del cliente

Formatos específicos por país

Los distintos países tienen estructuras de IBAN variables:

Alemania (DE): 22 caracteres - BBBB BBBB BBBB BBBB BB
Francia (FR): 27 caracteres - BBBB BSSS SSCC CCCC CCCC CCC KK
Italia (IT): 27 caracteres - CAAA AABB BBSS CCCC CCCC CCX
Reino Unido (GB): 22 caracteres - BBBB SSSS SSCC CCCC CC
España (ES): 24 caracteres - BBBB SSSS DDCC CCCC CCCC CC

Donde:

B = Código bancario
S = Código de sucursal
C = Número de cuenta del cliente
K = Dígito de control/clave
A = Tipo de cuenta
D = Dígito de control

Reglas de validación

La API realiza una validación exhaustiva que incluye:

Validación de formato: comprueba si el IBAN sigue la estructura esperada para el país
Validación de longitud: verifica que la longitud del IBAN coincida con el estándar del país
Validación de dígito de control: realiza la validación mediante algoritmo MOD-97
Validación del código de país: garantiza que el código de país esté admitido
Validación de caracteres: comprueba que los caracteres alfanuméricos sean válidos

Países admitidos

La API admite la validación de IBAN para más de 50 países, incluidos:

Europa: Alemania, Francia, Italia, España, Países Bajos, Bélgica, Austria, Suiza, Reino Unido, Polonia
Asia: EAU, Baréin, Israel, Jordania, Kazajistán, Kuwait
América: Brasil, Costa Rica, República Dominicana, Guatemala
África: Mauritania, Mauricio, Túnez

Para una lista completa de países admitidos, consulte la página Países admitidos.

Validación de IBAN

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

Validación

Consulta

Creación

Primeros pasos

URL base

Endpoint de validación

Parámetros de solicitud

Parámetros de respuesta

Ejemplos

IBAN alemán válido

IBAN francés válido

IBAN no válido

Manejo de errores

Parámetro IBAN faltante

Clave API faltante

Estructura del IBAN

Formatos específicos por país

Reglas de validación

Países admitidos

​Primeros pasos

​URL base

​Endpoint de validación

​Parámetros de solicitud

​Parámetros de respuesta

​Ejemplos

​IBAN alemán válido

​IBAN francés válido

​IBAN no válido

​Manejo de errores

​Parámetro IBAN faltante

​Clave API faltante

​Estructura del IBAN

​Formatos específicos por país

​Reglas de validación

​Países admitidos

Primeros pasos

URL base

Endpoint de validación

Parámetros de solicitud

Parámetros de respuesta

Ejemplos

IBAN alemán válido

IBAN francés válido

IBAN no válido

Manejo de errores

Parámetro IBAN faltante

Clave API faltante

Estructura del IBAN

Formatos específicos por país

Reglas de validación

Países admitidos