Esta especificación incluye todos los artefactos relevantes para la especificación de API de datos abiertos para cajeros automáticos.
Este punto final puede contener varias marcas propiedad de un grupo bancario en particular. Cada marca puede proporcionar varios cajeros automáticos.
Un cajero automático consta de:
Una identificación única
Servicios de cajero automático: un conjunto predefinido de nombres de código estándar que definen los servicios disponibles en un cajero automático, por ejemplo, PinUnblock.
Otros servicios de cajero automático: permite que un banco agregue sus propios códigos, nombres de código y descripciones no estándar/propietarios.
Accesibilidad: un conjunto predefinido de nombres de código estándar que definen las funciones de accesibilidad que ofrece el cajero automático, por ejemplo, InductionLoop
Otros servicios de accesibilidad: permite que un banco agregue sus propios códigos, nombres de código y descripciones no estándar/propietarios.
Idiomas admitidos: el código de idioma ISO 639-1 de 2 dígitos.
Ubicación: aquí es donde se encuentra el cajero automático y es una combinación de una dirección postal y las coordenadas geográficas (latitud y longitud decimales). La información de la dirección postal puede ser:
i) Hasta 7 líneas de información de dirección no estructurada (AddressLine)
ii) Información de dirección estructurada, por ejemplo, número de edificio, nombre de la calle, ciudad, código postal, etc., o una combinación de ambos.
La ubicación es muy importante, por lo que el proveedor de API debe asegurarse de que se proporcionen las coordenadas geográficas (preferiblemente) o una combinación de número de edificio y código postal para que el cajero automático pueda ubicarse con precisión en un mapa.
Moneda base: actualmente restringida a "GBP" únicamente, pero puede ampliarse en el futuro para hacer frente a otras monedas dispensadas por los cajeros automáticos en los aeropuertos, por ejemplo, si los proveedores de API pueden proporcionar esta información.
Importe mínimo posible: esto informará al consumidor sobre el importe mínimo posible que puede retirar de un cajero automático. Nota: Esto no es lo mismo que la denominación mínima. Por ejemplo, un cajero automático puede dispensar billetes de 5 libras esterlinas, pero exigir al consumidor que retire un importe mínimo posible de 10 libras esterlinas.
Documentación
- Contenido
Revise detenidamente la Documentación de OpenAPI para comprender la estructura y los requisitos de la solicitud.
- Seguridad
Recuerde obtener las credenciales de su aplicación en "Mis Aplicaciones", verificando la Clave de Consumidor y el Secreto de Consumidor.
Formato de Error
Todas las APIs de OpenBanking generan errores en el siguiente formato JSON:
{"Id": "123",
"Code": "123",
"Message":"Message example",
"Description": "Description of error",
"Errors":[
{
"ErrorCode":"AC17",
"Message":"Message Example",
"Path":"/accounts",
"Url":"url.example.com"
}]
}
Api Portal