Consentimiento y TRX-Pull
Rol Billetera
Enrolar cuenta

Enrolar una cuenta

Nivel de seguridad requerida para este servicio

Medio  Medio (accessToken)

Objetivo

El servicio account-enrollment permite enrolar una cuenta bancaria o de un PCP a través del servicio de Open-Banking.

Request

Method: POST
/external/open-banking/account-enrollment
curl -X POST "https://$env/external/open-banking/account-enrollment" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN' \
    -d "$body"

Ejemplo del Body Request:

Body JSON
{
  "bcraCode": “12022”,
  "cui": “20000000001”
}
  • bcraCode: El código de la entidad que con la que se quiere conectar. Debe obtenerse el valor de la entidad que se desea conectar usando el servicio Listar entidades
  • cui: El Clave Única de Identificación (CUIT o CUIL) del titular de cuenta que va a realizar en enrolamiento, sin guiones.

Ejemplo de Respuestas:

JSON
{
    "url": "https://auth.example.com/12345/authorize?response_type=code&code_challenge=exampleChallenge
  123456&code_challenge_method=S256&user_identifier=1234567890&client_id=12345&redirect_uri=https://auth.example.com/12345/callback/credentials&scope=openid+offline_access+accounts.debit&state=exampleState12345",
    "enrollmentId": "443-1234-5678-9012-345678901234"
}

La respuesta proporciona dos elementos importantes en el contexto de enrolamiento de una cuenta bancaria utilizando el servicio de Open Banking:

  • url: Esta es la URL proporcionada que la aplicación deberá abrir en una Custom Tab (pestaña in-app del navegador). Al abrir esta URL en una Custom Tab, el usuario podrá completar el proceso de autorización y autenticación necesario para enrolar su cuenta bancaria.
  • enrollmentId: Este es el ID de la solicitud de enrolamiento generada para esta operación específica. Puedes utilizar este ID para consultar el estado posteriormente y realizar un seguimiento del proceso de enrolamiento. Al consultar con este ID, podrás obtener información sobre si la solicitud de enrolamiento se completó correctamente o si hubo algún problema durante el proceso. Además, contiene los CVU/CBUs de las cuentas que se enrolaron. En resumen, al abrir la URL proporcionada en una Custom Tab, el usuario completará el proceso de autorización y autenticación necesario para enrolar su cuenta bancaria. Luego, podrás utilizar el enrollmentId para verificar el estado de la solicitud y obtener más detalles sobre el resultado del enrolamiento.
Listar entidadesObtener resultado