Validazione IBAN

GET

iban

Validazione 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"
  }
}

Per iniziare

URL di base

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

Endpoint di validazione

L’endpoint iban richiede la tua chiave API e un parametro IBAN per eseguire una validazione completa degli International Bank Account Numbers.

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

Questa richiesta riuscita valida un IBAN tedesco e restituisce informazioni dettagliate:

{
  "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"
  }
}

Parametri della richiesta

String

obbligatorio

La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche per ciascuna delle API Cleariflow, quindi la chiave dell’API di validazione bancaria non funzionerà per l’API tassi di cambio, ad esempio.

String

obbligatorio

L’International Bank Account Number da validare. Gli spazi sono consentiti e verranno rimossi automaticamente durante l’elaborazione. L’IBAN deve seguire il formato standard ISO 13616.

Parametri della risposta

La risposta API viene restituita in un formato JSON universale e leggero.

String

L’IBAN normalizzato senza spazi, restituito in formato maiuscolo.

Boolean

Risultato complessivo della validazione che indica se l’IBAN è valido secondo tutte le regole di validazione.

String

Il codice paese ISO a due lettere (es. DE per Germania, FR per Francia).

String

Il nome completo del paese associato all’IBAN.

String

Il codice identificativo della banca estratto dall’IBAN secondo il formato specifico del paese.

String

La porzione del numero di conto dell’IBAN, esclusi codice paese, checksum e codice bancario.

Integer

La lunghezza effettiva dell’IBAN fornito.

Integer

La lunghezza prevista per gli IBAN del paese specifico secondo lo standard ISO 13616.

Boolean

Se la validazione del checksum IBAN è passata usando l’algoritmo MOD-97.

Boolean

Se il formato IBAN corrisponde alla struttura prevista per il paese.

Object

Informazioni dettagliate aggiuntive sulla struttura e formattazione dell’IBAN.

String

Una rappresentazione visiva della struttura IBAN usando i segnaposto B (Bank), S (Sort), C (Customer) e K (Key).

String

Un esempio correttamente formattato dell’IBAN con spazi per la leggibilità.

String

Il nome della banca (attualmente mostra “Bank information not available”).

String

Il codice BIC della banca (attualmente mostra “BIC not available”).

String

Il tipo di conto (tipicamente “Bank Account”).

String

Il codice valuta per il paese (es. EUR per i paesi dell’Eurozona, GBP per il Regno Unito).

Esempi

IBAN tedesco valido

Richiesta:

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

Risposta:

{
  "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 francese valido

Richiesta:

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

Risposta:

{
  "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 non valido

Richiesta:

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

Risposta:

{
  "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": ""
  }
}

Gestione degli errori

Parametro IBAN mancante

Richiesta:

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

Risposta:

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

Chiave API mancante

Richiesta:

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

Risposta:

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

Struttura IBAN

L’IBAN è composto da diversi elementi:

Codice paese (2 caratteri): codice paese ISO 3166-1 alpha-2
Cifre di controllo (2 caratteri): validazione con algoritmo MOD-97
Identificativo bancario: codice bancario specifico per paese
Numero di conto: identificativo del conto cliente

Formati specifici per paese

Paesi diversi hanno strutture IBAN differenti:

Germania (DE): 22 caratteri - BBBB BBBB BBBB BBBB BB
Francia (FR): 27 caratteri - BBBB BSSS SSCC CCCC CCCC CCC KK
Italia (IT): 27 caratteri - CAAA AABB BBSS CCCC CCCC CCX
Regno Unito (GB): 22 caratteri - BBBB SSSS SSCC CCCC CC
Spagna (ES): 24 caratteri - BBBB SSSS DDCC CCCC CCCC CC

Dove:

B = Codice bancario
S = Codice di smistamento
C = Numero di conto cliente
K = Chiave/cifra di controllo
A = Tipo di conto
D = Cifra di controllo

Regole di validazione

L’API esegue una validazione completa che include:

Validazione del formato: verifica se l’IBAN segue la struttura prevista per il paese
Validazione della lunghezza: verifica che la lunghezza dell’IBAN corrisponda allo standard del paese
Validazione del checksum: esegue la validazione con algoritmo MOD-97
Validazione del codice paese: assicura che il codice paese sia supportato
Validazione dei caratteri: verifica caratteri alfanumerici validi

Paesi supportati

L’API supporta la validazione IBAN per oltre 50 paesi tra cui:

Europa: Germania, Francia, Italia, Spagna, Paesi Bassi, Belgio, Austria, Svizzera, Regno Unito, Polonia
Asia: Emirati Arabi Uniti, Bahrain, Israele, Giordania, Kazakistan, Kuwait
Americhe: Brasile, Costa Rica, Repubblica Dominicana, Guatemala
Africa: Mauritania, Mauritius, Tunisia

Per un elenco completo dei paesi supportati, consulta la pagina Paesi supportati.

Validazione 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"
  }
}

Validazione

Lookup

Creazione

Per iniziare

URL di base

Endpoint di validazione

Parametri della richiesta

Parametri della risposta

Esempi

IBAN tedesco valido

IBAN francese valido

IBAN non valido

Gestione degli errori

Parametro IBAN mancante

Chiave API mancante

Struttura IBAN

Formati specifici per paese

Regole di validazione

Paesi supportati

​Per iniziare

​URL di base

​Endpoint di validazione

​Parametri della richiesta

​Parametri della risposta

​Esempi

​IBAN tedesco valido

​IBAN francese valido

​IBAN non valido

​Gestione degli errori

​Parametro IBAN mancante

​Chiave API mancante

​Struttura IBAN

​Formati specifici per paese

​Regole di validazione

​Paesi supportati

Per iniziare

URL di base

Endpoint di validazione

Parametri della richiesta

Parametri della risposta

Esempi

IBAN tedesco valido

IBAN francese valido

IBAN non valido

Gestione degli errori

Parametro IBAN mancante

Chiave API mancante

Struttura IBAN

Formati specifici per paese

Regole di validazione

Paesi supportati