Validazione Sort Code UK e Numero di Conto



Specifiche API di Validazione di Conto Bancario


1. Cosa è l'API per il Calcolo IBAN?


Il SORT code inverso è un sistema online, che fornisce alle aziende un'interfaccia in cui possono effettuare validazioni ed identificazioni del SORT code in tempo reale.

Queste funzioni sono disponibili in forma di moduli add-on, che ampliano le funzionalità del portale.

Il modulo SORT dà accesso al nostro ampio database di codici SORT al tuo portale. È possibile accedere ai dati attraverso una API ed effettuare chiamate automatiche o integrare il database di identificazione SORT/BIC nella tua soluzione software.



2. Caratteristiche


Il modulo SORT fornisce le seguenti funzionalità:

Risultati multipli visualizzati come risposta XML code-friendly


3. Utilizzo delle API


Il sistema di API consente di automatizzare validazione del codice sort tramite un semplici richieste HTTP GET o POST.

I parametri accettati sono elencati nella seguente tabella:

Nome campo Lunghezza Tipo Descrizione
sortcode 6 String Il Sort Code
account 8 String Numero Conto Bancario
api_key 128 String La tua API key personale.
All'interno del nostro portale online è possibile trovare la chiave API, che viene utilizzata per proteggere le richieste di ricerca.

ESEMPIO Query di convalida Sort Code e numero di conto.
Un esempio d'uso delle API di codice SORT con una richiesta GET può essere trovato qui sotto:

https://api.iban.com/clients/api/sort-api.php?api_key=[API_KEY]&sortcode=[SORT]&account=[ACCOUNT]

Dove:


È possibile trovare un esempio di risposta XML nella sezione successiva "Struttura risposta XML API"



4. Struttura Risposta API XML


Uno schema XML della risposta della API può essere trovato nell'archivio della documentazione.
Una descrizione dettagliata dei campi restituiti può essere visualizzata nella tabella sottostante:

Nome Campo Lunghezza Tipo Descrizione
SORT_CODE 8 o 11 String Il codice SORT/BIC che hai cercato viene visualizzato se effettui la ricerca per SORT code. Se effettui una ricerca per nome banca verrà visualizzato il codice SORT della banca e della filiale corrispondente.
BANK 256 String Nome della banca o istituto finanziario che possiede questo tipo di numero SORT/BIC.
BRANCH 128 String Nome della filiale specifica a cui è assegnato il codice SORT/BIC.
COUNTRY 32 String Nome intero del paese di origine e.g. “Stati Uniti”
COUNTRY_CODE 2 String Abbreviazione di due lettere del codice paese e.g. US, UK, AU, FR … etc.
CITY 128 String Nome della località in cui è situata la filiale.
BRANCH_ADDRESS 128 String Indirizzo della banca e della filiale corrente.
LOCATION 128 Char Informazioni aggiuntive sulla località se disponibili.
Il sistema API restituisce i risultati in formato XML, che è facile da analizzare per una moltitudine di linguaggi di programmazione e piattaforme.

Una risposta XML di esempio da API per una ricerca del codice SORT potrebbe essere:

<result>
<sort_code>200415</sort_code>
<account>38290008</account>
<iban>GB37BARC20041538290008</iban>
<bank_name>BARCLAYS BANK PLC</bank_name>
<bank_bic>BARCGB21</bank_bic>
<bank_branch>BARCLAYBANK B'CARD N'PTON</bank_branch>
<branch_bic>08L</branch_bic>
<bank_address>DEPT AC BARCLAYCARD HOUSE</bank_address>
<bank_city>NORTHAMPTON</bank_city>
<bank_postalcode>NN4 7SG</bank_postalcode>
<bank_phone>01604 234234 </bank_phone>
<direct_debits>OK</direct_debits>
<pfs_payments></pfs_payments>
<chaps>OK</chaps>
</result>



5. Errori api API


In caso di errore l'API SORT restituisce una risposta XML che contiene il messaggio di errore.

I tag XML vengono restituiti senza altri campi nella risposta XML.

Qui di seguito potete trovare una descrizione di tutti i possibili messaggi di errore che potrebbero essere restituiti:

<error>Subscription Expired</error>
<error>Invalid API Key</error>
<error>Account number or Sort code is not valid!</error>
<error>Sort code cannot be found</error>
<error>No more queries available, you need to purchase additional queries.</error>