UK Validación del Código de Clasificación y de Número de Cuenta para el Reino Unido



Especificaciones de la API de Validación de Cuenta Bancaria


1. ¿Qué es la API de Cálculo de IBAN?


El Código SORT inverso es un sistema en línea, que le ofrece a las empresas una interfaz donde se puede realizar la validación de código SORT en tiempo real y su identificación.

Estas funciones se presentan en forma de módulos adicionales, que amplían la funcionalidad de su portal.

El módulo SORT añade acceso a nuestra extensa base de datos de código SORT a su portal. Puede acceder a los datos a través de una API y realizar llamadas automáticas o integrar la base de datos de identificación BIC/SORT en su solución de software.



2. Características


El Módulo SORT le proporciona la siguiente funcionalidad:




3. Uso de la API


El sistema API le permite automatizar la validación del código de clasificación a través de una sencilla solicitud HTTP GET o POST.

Los parámetros aceptados se enumeran en la tabla siguiente:

Nombre del campo Longitud Tipo Descripción
sortcode 6 Cadena El Código de Clasificación
account 8 Cadena Numero de cuenta bancaria
api_key 128 Cadena Tú clave personal de la API.
Dentro de su portal en línea que usted puede encontrar su clave de API, que se utiliza para fijar las solicitudes de búsqueda.

Ejemplo de consulta de validación de Código de clasificación y número de cuenta.
Un ejemplo de uso de la API de Código SORT con una petición GET se puede encontrar a continuación:

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

Donde:


Usted puede encontrar una respuesta XML de ejemplo en la siguiente sección “Estructura de la Respuesta XML de la API”



4. Estructura de la Respuesta XML de la API


Un esquema XML de la respuesta de la API se puede encontrar en el archivo de documentación.
Una descripción detallada de los campos devuelto se puede ver en la tabla siguiente:

Nombre del campo Longitud Tipo Descripción
SORT_CODE 8 o 11 Cadena El Código SORT/BIC que haya buscado aparece si ha buscado por código SORT. Si busca por el banco de nombrar el código SORT del banco correspondiente y sucursal será mostrado.
BANCO 256 Cadena Nombre del banco o institución financiera que posee este número de sort/BIC.
SUCURSAL 128 Cadena Nombre de la sucursal específica a la que se asigna el código SORT/BIC.
PAÍS 32 Cadena Nombre completo del país de origen e.g. “Estados Unidos”
CÓDIGO_PAÍS 2 Cadena Abreviatura de dos letras del código de país e.g. US, UK, AU, FR … etc.
CIUDAD 128 Cadena El nombre de la ciudad de la ubicación de la sucursal
DIRECCION_SUCURSAL 128 Cadena Dirección del banco y la sucursal actual.
UBICACION 128 Char Información de ubicación adicional si está disponible.
El sistema de la API devuelve los resultados en formato XML, que es fácil de analizar en una variedad de lenguajes y plataformas de programación.

Una respuesta XML de ejemplo de la API de búsqueda de código SORT sería:

<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. Errores de la API


En caso de un error de la API SORT devuelve una respuesta XML que contiene el mensaje de error.

Las Etiquetas XML son devueltas sin otros campos en la respuesta XML.

A continuación puede encontrar una descripción de todos los mensajes de error posibles que podrían ser devueltos:

<error>Suscripción Expirada</error>
<error>Clave de API no válida</error>
<error>Número de cuenta o código de clasificación no es válido!</error>
<error>código de clasificación no encontrado</error>
<error>No hay más consultas disponibles, que necesitan comprar consultas adicionales.</error>