Documentación
Consentimiento y TRX-Pull
Listar entidades

Listar entidades disponibles

Nivel de seguridad requerida para este servicio

Medio  Medio (accessToken)

Objetivo

Este servicio tiene como objetivo proporcionar un listado de entidades que pueden ser enroladas en el sistema. Las entidades pueden estar en dos roles: "Wallet" (Billetera) o "Acceptor" (Aceptador). Dependiendo del parámetro "role" especificado en la solicitud, se obtendrá el listado correspondiente de entidades que pueden ser enroladas desde el rol billeteras o aquellas que pueden enrolarte como proveedor de cuenta (PCP).

Request

Method: GET
/external/open-banking/list-entities
curl -X GET "https://$env/v2/ar/open-banking/list-entities" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN' \
    --data-urlencode "role=1"
  • env: Entorno de la API, como producción o desarrollo.
  • YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.
  • role: Un parámetro opcional que determina el rol de la entidad que se desea obtener.

Valores válidos para el parámetro "role"

  • 1: Para obtener entidades que pueden vincularse a tu billetera (default)
  • 2: Para obtener entidades que pueden enrolar tus cuentas en tu rol PCP/Aceptador (Acceptor).

Ejemplo de Respuestas:

JSON
{
  "entities": [
    {
      "name": "Klio",
      "legalName": "PROPAGO ARGENTINA SRL",
      "cuit": "33714835349",
      "bcraCode": "33563",
      "urlLogo": "https://assets.klio.la/external/ar-logo/33563.svg",
      "urlIsoLogo": "https://assets.klio.la/external/ar-isologo/33563.svg",
      "cbuCvuIdentity": "0000198"
    },
    {
      "name": "Brubank",
      "legalName": "BRUBANK S.A.U.",
      "cuit": "30715899716",
      "bcraCode": "00143",
      "urlLogo": "https://assets.klio.la/external/ar-logo/00143.svg",
      "urlIsoLogo": "https://assets.klio.la/external/ar-isologo/00143.svg",
      "cbuCvuIdentity": "143"
    }
  ]
}

El servicio get-entities responde un listado de entidades que incluye información importante para el enrolamiento. Los detalles proporcionados son los siguientes:

  • name: El nombre corto o comercial de la entidad (por ejemplo, "Klio").
  • legalName: La razón social registrada de la entidad (por ejemplo, "PROPAGO ARGENTINA SRL").
  • cuit: El número de CUIT (Código Único de Identificación Tributaria) de la entidad (por ejemplo, "33714835349").
  • bcraCode: El código asignado por BCRA (Banco Central de la República Argentina) a la entidad (por ejemplo, "33563").
  • urlLogo: La URL del logotipo de la entidad en formato SVG.
  • urlIsoLogo: La URL del isologotipo de la entidad en formato SVG.
  • cbuCvuIdentity: Son los primeros 7 dígitos del CVU o los primero 3 del CBU que identifican a la entidad en el sistema CBU/CVU (por ejemplo, "0000198"). El servicio puede responder con múltiples entidades según el parámetro "role" especificado en la solicitud.
IntroducciónEnrolar cuenta