Funcionamiento
Configurar la CA del api gateway
Para garantizar la correcta conexión con las APIs de Cecabank, las aplicaciones consumidoras deberán disponer en su almacén de certificados de confianza de las autoridades certificadoras asociadas al certificado QWAC utilizado por el API Gateway.
Las siguientes autoridades certificadoras deben estar incorporadas en el almacén de confianza de la plataforma:
FIRMAPROFESIONAL CA ROOT-A WEB
-----BEGIN CERTIFICATE-----
MIICejCCAgCgAwIBAgIQMZch7a+JQn81QYehZ1ZMbTAKBggqhkjOPQQDAzBuMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
IFJPT1QtQSBXRUIwHhcNMjIwNDA2MDkwMTM2WhcNNDcwMzMxMDkwMTM2WjBuMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
IFJPT1QtQSBXRUIwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAARHU+osEaR3xyrq89Zf
e9MEkVz6iMYiuYMQYneEMy3pA4jU4DP37XcsSmDq5G+tbbT4TIqk5B/K6k84Si6C
cyvHZpsKjECcfIr28jlgst7L7Ljkb+qbXbdTkBgyVcUgt5SjYzBhMA8GA1UdEwEB
/wQFMAMBAf8wHwYDVR0jBBgwFoAUk+FDY1w8ndYn81LsF7Kpryz3dvgwHQYDVR0O
BBYEFJPhQ2NcPJ3WJ/NS7Beyqa8s93b4MA4GA1UdDwEB/wQEAwIBBjAKBggqhkjO
PQQDAwNoADBlAjAdfKR7w4l1M+E7qUW/Runpod3JIha3RxEL2Jq68cgLcFBTApFw
hVmpHqTm6iMxoAACMQD94vizrxa5HnPEluPBMBnYfubDl94cT7iJLzPrSA8Z94dG
XSaQpYXFuXqUPoeovQA=
-----END CERTIFICATE-----
FIRMAPROFESIONAL ICA A01 QWAC 2022
-----BEGIN CERTIFICATE-----
MIIEADCCA4agAwIBAgIQCuFQdAWV5DfFBC65/wudRjAKBggqhkjOPQQDAzBuMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MScwJQYDVQQDDB5GSVJNQVBST0ZFU0lPTkFMIENB
IFJPT1QtQSBXRUIwHhcNMjIwNzE5MTIxNjQ0WhcNMjcwNzE4MTIxNjQ0WjByMQsw
CQYDVQQGEwJFUzEcMBoGA1UECgwTRmlybWFwcm9mZXNpb25hbCBTQTEYMBYGA1UE
YQwPVkFURVMtQTYyNjM0MDY4MSswKQYDVQQDDCJGSVJNQVBST0ZFU0lPTkFMIElD
QSBBMDEgUVdBQyAyMDIyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEvuu1GFFr+VxW
8eoevTgtgu5s7y3f5FERhijHck36GREYCvjMSEbTaoJ1vaU3HronnxMmAurF+D2K
uLveBmTD8sR4lvfUH0OnK9efzdZ6NzJn9vdfQZgLer6alMl3/bzeo4IB4zCCAd8w
EgYDVR0TAQH/BAgwBgEB/wIBADAfBgNVHSMEGDAWgBST4UNjXDyd1ifzUuwXsqmv
LPd2+DB6BggrBgEFBQcBAQRuMGwwPAYIKwYBBQUHMAKGMGh0dHA6Ly9jcmwuZmly
bWFwcm9mZXNpb25hbC5jb20vY2Fyb290LWFfd2ViLmNydDAsBggrBgEFBQcwAYYg
aHR0cDovL29jc3AuZmlybWFwcm9mZXNpb25hbC5jb20wgZoGA1UdIASBkjCBjzCB
jAYEVR0gADCBgzCBgAYIKwYBBQUHAgIwdAxyQ2VydGlmaWNhZG8gZGUgQXV0b3Jp
ZGFkIGRlIENlcnRpZmljYWNpw7NuLiBDb25zdWx0ZSBsYXMgY29uZGljaW9uZXMg
ZGUgdXNvIGVuIGh0dHA6Ly93d3cuZmlybWFwcm9mZXNpb25hbC5jb20vY3BzMB0G
A1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDATBBBgNVHR8EOjA4MDagNKAyhjBo
dHRwOi8vY3JsLmZpcm1hcHJvZmVzaW9uYWwuY29tL2Nhcm9vdC1hX3dlYi5jcmww
HQYDVR0OBBYEFP08p+eiaNYoGjrPfRYQxP5CAVvDMA4GA1UdDwEB/wQEAwIBBjAK
BggqhkjOPQQDAwNoADBlAjEA5Ywu2PuVwFtYiw5a5ojWsxxPjfXu4Sx7O1cTZPTo
EZZfElWaOkEWzoZ2fbMl+ngjAjBi3bNQ4gkzLLy4lJAYeovR6C6ZsO+BB5gClTbJ
m6abPPvSxB5DsDjlPmDR5lDviGI=
-----END CERTIFICATE-----
Regístrate en nuestro Portal del desarrollador de APIs
Para poder probar todas las APIs de nuestro catálogo de Productos puedes registrarte de dos formas distintas:
- Con un certificado digital de tipo QSealC
- Sin certificado digital
Una vez registrado, el usuario puede acceder al conjunto de APIS disponibles, explorar las distintas posibilidades, los planes de uso definidos para cada API y definir una aplicación con la configuración de APIS que seleccione.
Registro con certificado digital QSealC
Deberás invocar un servicio rest en el que se solicitará, mediante una firma electrónica, la prueba de que el TPP está en posesión de un certificado tipo QSealC según describe el reglamento eIDAS (Reglamento UE Nº910/2014 del Parlamento Europeo y del Consejo, de 23 de julio de 2014).
Este certificado debe ser adquirido en una Autoridad de Certificación reconocida por la European Banking Authority (EBA).
El resultado de la invocación del servicio será la entrega de un usuario y clave al portal privado, la suscripción automática a las APIS disponibles en función de la habilitación encontrada en el certificado y los datos necesarios para iniciar automáticamente la invocación del API.
Especificaciones técnicasActualización certificado digital QSealC
Para posibilitar la acción de actualización de los datos del certificado, se dispone de un servicio para ser invocado por los TPP con las características técnicas que se definen en el siguiente apartado.
Especificaciones técnicasAñade tu Aplicación
Una vez registrado podrás añadir y configurar tus aplicaciones. Cada aplicación te permitirá, con sus credenciales correspondientes (API Key), que tu código funcione rápidamente con todos los servicios de las APIs que ésta necesite.
Accede al "Panel de Control" de tus APPs y pulsa en "Añadir APP" para crear tu primera aplicación. En un principio, tendrás acceso a probar todas las APIs que quieras en el entorno de Pruebas (Sandbox). Para el entorno de Producción deberás solicitar el acceso y te proporcionaremos credenciales alternativas.
Deberás identificar tu App de forma única a través del Nombre y el Identificador (ID) de la aplicación. El nombre de la aplicación es el que verán tus clientes cuando la utilicen.
De todas las APIs disponibles, activa tantas como necesites para hacer tus desarrollos en el entorno de Pruebas (Sandbox).
Por último, pulsa en el botón "Añadir APP" y en ese momento se creará, de forma automática, un "Secret OAuth" que será necesario para autenticar tu aplicación y obtener el token de acceso para realizar llamadas a las APIs seleccionadas. Podrás consultar todos estos datos, más tarde, en el detalle de tus aplicaciones desde el "Panel de Control" de tus Apps.
Y ya está... a partir de este momento puedes conectar con nuestras APIs !!!