1. Generación del link de consentimiento

Los usuarios generan un ID de consentimiento a través de Prometeo, especificando los permisos que desean otorgar.

Para iniciar sesión en tus cuentas bancarias de Brasil y acceder a tu información a través de Prometeo y Open Finance, primero debes generar tu ID de consentimiento, que será utilizado como username una vez generado para acceder a tus datos bancarios asociados a la cuenta.

¿Cómo generar el ID para mi cuenta bancaria de Brasil?

Para acceder a la información de tu cuenta bajo el esquema regulado de finanzas abiertas de Brasil, es mandatorio que el titular de la cuenta realice el flujo de consentimiento en la institución financiera donde ésta fue abierta, para darle acceso a Prometeo a extraer de manera autorizada los datos requeridos.

Para realizarlo, debes completar en nuestro Endpoint/login las características necesarias a asignarle al consentimiento, para que siempre tengas el control de la información que estás autorizando a tu Entidad Financiera compartir con Prometeo:

Parámetros Descripción
permissions Detalle de los permisos que le darás a Prometeo para acceder a datos de tu cuenta. De esta manera controlas de forma compartimentada si quieres compartir balances y movimientos de tu cuenta bancaria o solo uno de estos conceptos. [obligatorio]
external_id Es el alias que le asignarás a este consentimiento, el mismo será útil para luego identificarlo, modificarlo y/o revocarlo (i.e.: TUEMPRESA-TUBANCO-001).
expires_At Fecha de validez que le quieres asignar a este consentimiento. Si no se completa, el consentimiento tendrá fecha de expiración dentro de 12 meses. [opcional]
user_Tax_Id CPF del usuario. Si no se envía en la solicitud, será requerido en el flujo de consentimiento en el banco. [opcional]
business_Tax_Id CNPJ de la empresa (en caso de cuentas corporativas). Este campo es requerido si el flujo de consentimiento involucra una cuenta empresarial. [opcional]

Una vez enviada la recibirás el data_ID asignado al consentimiento (importante: este consentimiento todavía no activado) y la interface_URL que deberás seguir para autorizar en tu Institución Financiera el consumo de información por parte de Prometeo:

{
  "key": "ca4d6ca0cb9645xxxxxxxxxd86a2e77",
  "status": "interaction_required",
  "field": "link_id",
  "context": {
    "data_id": "6be6cdf1-xxxx-yyyy-zzzz-6f5b2b31fa9",
    "interfaceURL": "https://data.app.sandbox.openfinance_br.com.br?v=eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4MDc5MDA5M1h0DYzIyOQy1jNGFmMGIxZmQ1ZGIiLCJ0eXBblIjoITElOSyIsdHMxMjM0IiwidXNlclklcljoiYk9NTgVky00YmRlTLTkYjctMTIzNTM2NGMyZTA4IiwicmVmc2giOiIByb2lIIdGVvIiwjYXZhdGFyIyOiIaHF6Ly9pbmljaWfkb3JtLmJyL3N0YXJpXpy9pbWFnFtZXZfRtV5SbLSzqEYBEmESnacIRju6loSvE6yOA"
  }
}

📘

Recuerda: el data_ID recibido será tu usuario para acceder a los datos de la cuenta que asocies a este consentimiento, por lo que es importante guardarlo correctamente para utilizarlo luego al consumir información bancaria

Tiempo para confirmar el compartimiento de Datos según la LGPD: Los usuarios tienen hasta 1 hora para confirmar el compartimiento de sus datos. Anteriormente, este tiempo estaba limitado a 5 minutos, brindando así más tiempo para revisar y autorizar el compartimiento.

Importante: este paso se debe realizar por única vez para cada cuenta que quieras asociar, hasta que finalice el plazo de vencimiento asignado al ID o revoques el consentimiento mediante Prometeo o la Institución Financiera donde tienes tu cuenta bancaria.