Content Comparison

Acceder API Market y registro

Acceder en: https://open-plus-frontend.bech.prd.fsapps.io/

Registro: https://open-plus-frontend.bech.prd.fsapps.io/onboarding/company

Realizado el registro de la Fintech…

Tendrás acceso al API Market: https://open-plus-frontend.bech.prd.fsapps.io/applications

En donde podrás:

Gestionar miembros colaboradores de la Fintech.
Revisar documentación sobre la integración con la plataforma.
Crear una nueva aplicación para consumir nuestras APIs

Comencemos por crear una nueva app...

Al crear una nueva aplicación deberás registrar:

Nombre y descripción.
URL para callback.
Imagen (opcional).

La URL para callback es importante porque:

Identifica la aplicación Fintech (frontend) donde el cliente inicia el flujo de consentimiento.
Esta URL es requerida en la solicitud HTTP que crea el consentimiento.
La autorización ocurre en una aplicación web BancoEstado, y al finalizar, ejecuta una redirección del cliente hacia la URL de callback registrada.

A continuación, podrás escoger el paquete de APIs que requieras.

Para lograr la integración con una experiencia equivalente al ambiente productivo, se sugiere escoger el paquete que utiliza Mutual TLS.

Image Removed

Antes de confirmar y continuar, se muestra un cuadro resumen de la aplicación y las APIs vinculadas.Image Removed

Image Added

Confirmada la creación de la nueva aplicación, se da opción de ir al gestor de aplicaciones o al panel de la aplicación que se acaba de crear.

Image Added

Vamos al panel de la aplicación...

Para continuar, clic sobre el producto vinculado a la aplicación...

El flujo Open Finance es lo primero en desplegarse y simula el proceso de consentimiento. Inicia en la aplicación Fintech, luego muestra la autorización en BancoEstado, y finaliza con el retorno hacia la Fintech.

Para comenzar, vamos a generar un consentimiento con el Flujo Open Finance (necesario para la integración en sandbox)...

Seleccionamos Open Finance...
Nuevo compartir...

Aceptar términos y condiciones y continuar...
Redirección a BancoEstadoBancoEstado…

Ingresar...
Aceptar...

Simula segundo factor de autenticación BancoEstado...
Redirección hacia Fintech

Al finalizar la simulación, se presenta un resumen que muestra al cliente los detalles del consentimiento que acaba de autorizar.

Podemos visualizar un listado de consentimientos generados por el flujo open finance y el estado en que se encuentran. Necesitamos el ID de consentimiento para consumir la API sen Park Dev o vía Postman.

En "Credenciales" tiene acceso al Client ID, certificado y llave privada mtls, elementos necesarios para interactuar con las APIs.

En este punto, está todo listo para consultar el documento técnico de integración.

Image Removed

Solicitudes HTTP

Diagrama

diagrama de

Secuencia

secuencia –

Flujo

flujo consentimiento y

Consulta Datos de Cuenta

consulta datos de cuenta

Image Added

Descripción	Documento técnico. Detalla solicitudes HTTP para lograr integración del flujo de consentimiento.
Prerrequisitos	Registro en portal API Market. Crear aplicación y vincular API cuentas. Generar consentimiento mock. Obtener client Id desde portal API Market. Descargar certificado y llave privada desde portal (utilizar en Postman o en Curls para ejecutar solicitudes HTTP).
Documento relacionado	Diagrama de secuencia flujo consentimiento.

1. POST /token (Fintech Token)

Llamada obtener token para solicitud que crea consentimiento:

Code Block
curl --location 'https://${KEYCLOAK_HOST_AND_REALM} /protocol/openid-connect/token' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'Content-Type: application/x-www-form-urlencoded' \


--data-urlencode 'grant_type=client_credentials' \


--data-urlencode 'client_id= ${FINTECH_CLIENT_ID} ' \


--data-urlencode 'scope=openid'

2. POST /consents (Create Consent)

Llamada para iniciar el proceso de consentimiento, en el cual se debe asociar el rut del cliente, el alcance de los datos dentro del array de scopes (puede ser una, dos o todas las opciones para consulta de datos disponible), y la fecha de expiración del consentimiento:

Code Block
curl --location 'https://${API_HOST}/consent-management/api/v1/consents' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'Content-Type: application/json' \


--header 'Authorization: Bearer ${FINTECH_TOKEN}' \


--data '{


"data": {


"rut": "${RUT_CLIENTE}"

},


"scopes": [


"ACCOUNTS_READ",


"ACCOUNTS_BALANCES_READ",


"ACCOUNTS_TRANSACTIONS_READ"

],


"expirationDateTime": "2024-06-15T15:14:10Z",


"redirectUri": "${REDIRECT_URL_FINTECH} "

}'

NOTA: Para este curl, redirectUri debe ser la url callback registrada al momento de crear la aplicación en el API Market.

2.1. Response /consents (Create Consent):

La respuesta al crear un consentimiento contiene el campo “authorizationUrl”, que establece la url a la cual se redirige el cliente (aplicación BECH) con los parámetros necesarios para validar el consentimiento mediante clave BEPASS:

Code Block
{


"id": "64e533c6f7c877001112d405",


"interactionId": "64e533c6f7c877001112d406",


"authorizationUrl": "https://appBancoEstado.cl?consentid=64e533c6f7c877001112d405&interactionid=64e533c6f7c877001112d406"

2.2. Redirección desde App BECH:

Una vez validado el consentimiento por el cliente con su BEPASS, se retorna el control a la fintech Fintech (redirección desde BECH) indicando mediante parámetros en la url un “ticket” (token para ejecutar consultas de datos) y el “state” (id del consentimiento):

Code Block

{URL_CALLBACK}/statusView?ticket=eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJiNzdmMWJiZS03MzYxLTQyYjktYjE5NS1lNDUzNGIwNTg1MTIifQ.eyJleHAiOjE2OTI3NDMyNjMsIm5iZiI6MCwiaWF0IjoxNjkyNzQyOTYzLCJwZXJtaXNzaW9ucyI6W3sicnNpZCI6IjEzMTBjMDQzLTNjZTctNGQwOC04N2VhLTA1MjFmZjBjZjY4YiJ9XSwianRpIjoiNTQzNTQxZWItMzc2NC00OTJhLWFlNTctNjNiMWFkNTRjYWVjLTE2OTI3NDI5NjM4NzgiLCJhdWQiOiJodHRwczovL2tleWNsb2FrLmJkYy5zaGFyZWQuZnNhcHBzLmlvL2F1dGgvcmVhbG1zL2NvbnNlbnQtbWFuYWdlbWVudC1kZXYiLCJzdWIiOiJlZmFlOTk3NC1jOGQyLTQzNTgtYmU4OS04YjJjNWIxNmY0M2EiLCJhenAiOiJyZXNvdXJjZS1jbGkifQ.oNQY9rbtxC5HeVkGldK4Kpn81ApuUCR0JgAUFBvd0dE&state= ${CONSENT_ID}


El ticket es equivalente al “Fintech Token”, puede ser utilizado para consultar los datos que el cliente autorizó en el proceso de consentimiento. Dicho token tiene una duración de 5 minutos, y se puede volver a generar ejecutando el curl 3.POST/token.

2.3.

-

Obtener detalles consentimiento:

Una vez ejecutada la redirección desde la aplicación BancoEstado hacia la Fintech, es posible consultar los detalles del consentimiento, y con esto, poder mostrar información al cliente sobre el alcance de los datos que autorizó, el tiempo por el cual estará vigente dicho consentimiento, etc.

Code Block
curl --location 'https://${API_HOST}/consent-management/api/v1/consents/${CONSENT_ID}/' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'Authorization: Bearer ${FINTECH_TOKEN

Response:

Code Block
{


  "_id": "6515c4b96fa1f70011e2f561",


  "resourceId": "25ad3e63-04e5-441a-8aba-fc4940a69d0f",


  "resourceName": "WInRZVsZJM0Fc2lMwgI9ubqH_PRTmJFMMPX_WbRhZOU",


  "requestorClientId": "openplus_f0dbdbdb-5ab9-405e-8af9-c34758b851f7",


  "requestorSubject": "f6dec843-7843-4935-85f5-273196234c9b",


  "requestorClientName": "openplus_f0dbdbdb-5ab9-405e-8af9-c34758b851f7",


  "scopes": [


  "ACCOUNTS_READ",


  "ACCOUNTS_BALANCES_READ",


  "ACCOUNTS_TRANSACTIONS_READ"

],


  "status": "AUTHORISED",


  "redirectUri": "https://open-plus-frontend.bech.hml.fsapps.io",


  "creationDateTime": "2023-09-28T18:23:53.509Z",


  "statusUpdateDateTime": "2023-10-18T15:40:37.639Z",


  "expirationDateTime": "2024-06-15T15:14:10.000Z",


  "data": {


  "rut": "100067269"

3. POST /token (Fintech Token)

Llamada obtener token para solicitud de segundo token:

Code Block
curl --location 'https://${KEYCLOAK_HOST_AND_REALM}/protocol/openid-connect/token' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'Content-Type: application/x-www-form-urlencoded' \


--data-urlencode 'grant_type=client_credentials' \


--data-urlencode 'client_id= ${FINTECH_CLIENT_ID} ' \


--data-urlencode 'scope=openid'

4. POST /token (

Api

API Token)

Llamada obtener token para solicitud de datos:

Code Block
curl --location 'https://${API_HOST}/consent-management/api/v1/oauth/token' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'Content-Type: application/json' \


--header 'Authorization: Bearer ${FINTECH_TOKEN} ' \


--data '{



  "grant_type": "refresh_token",


  "extras": {


  "consentId": "${CONSENT_ID} "

}'

5. GET /accounts

Code Block
curl --location 'https://${API_HOST}/open-banking-chile/accounts/v2/accounts?page=1&page-size=25&accountType=&pagination-key=7a6b0f9b-6770-49aa-8704-e407d6d340e3' \


--cert /path/to/certificate.crt \


--key /path/to/private-key.key \


--header 'x-fapi-auth-date: Sun, 10 Sep 2023 19:43:31 UTC' \


--header 'x-fapi-customer-ip-address: 1.1.1.1' \


--header 'x-fapi-interaction-id: ${CONSENT_ID} \


--header 'x-customer-user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36' \


--header 'Authorization: Bearer ${API_TOKEN} '

Paso a producción API Market

Ejecutada la solicitud para paso a producción de una aplicación, y aprobada por BancoEstado, los pasos a seguir son los que se detallan a continuación…

Generar

Certificado

certificado y

Llave

llave

Como primer paso se debe generar un certificado y llave. Podemos utilizar el siguiente comando:

Code Block
openssl req new newkey rsa:2048 nodes keyout client.key out client.csr

Esto genera dos archivos dentro de la carpeta en donde es lanzado el comando.

Subir CSR y descargar

Certificado

certificado de seguridad

Podemos ver los archivos generados:

Dentro de " Credenciales " en la pestaña "PRODUCCIÓN" debemos subir el archivo crt antes generado.

Luego de subir el archivo, se desbloquea el botón que nos permite descargar el certificado de serguridad seguridad asignado.

Configurar

Certificados Producción

certificados de producción

Ahora, tenemos los archivos generados con openssl y el certificado asignado descargado:

Para utilizar las URLs productivas, debemos configurar para cada host de producción, el certificado designado que acabamos de descargar y la llave que fue generada con openssl:

NotaNOTA: En este punto podemos realizar el proceso completo para consentimiento de consulta de datos en producción, para lo cual, es importante que el usuario que otorgará dicho consentimiento sea cliente BancoEstado y cuente con clave BEPASS activa.

Requisitos para activación de BEPASS:

Crear clave BEPASS en APP BancoEstado.
Realizar alguna transacción, por ejemplo, una transferencia por más de 50K CLP ($50.001).
Realizada la transacción, en 72 horas se logra activación completa BEPASS. Es importante destacar que el conteo de las 72 horas comienza únicamente después de haber ejecutado la transacción.

Version	Old Version 6	New Version Current
Changes made by	Cristina Saito (Unlicensed)	Cristina Saito (Unlicensed)
Saved on	Feb 15, 2024	Feb 16, 2024

Versions Compared

Key

Acceder API Market y registro

Realizado el registro de la Fintech…

Comencemos por crear una nueva app...

Vamos al panel de la aplicación...

Para continuar, clic sobre el producto vinculado a la aplicación...

Solicitudes HTTP

diagrama de

secuencia –

flujo consentimiento y

consulta datos de cuenta

1. POST /token (Fintech Token)

2. POST /consents (Create Consent)

2.1. Response /consents (Create Consent):

2.2. Redirección desde App BECH:

2.3.

Obtener detalles consentimiento:

3. POST /token (Fintech Token)

4. POST /token (

API Token)

5. GET /accounts

Paso a producción API Market

Generar

certificado y

llave

Subir CSR y descargar

certificado de seguridad

Configurar

certificados de producción