# Account Link (deprecated)

{% admonition type="warning" name="Deprecado" %} Este método está deprecado y se retirará en los próximos meses. Por favor, migre su implementación actual para usar tokens OAuth en su lugar. {% /admonition %}

Éste método conecta con la cuenta del usuario en  y devuelve un token vinculado a esa cuenta que puede ser usado en operaciones posteriores, evitando la necesidad de enviar sus credenciales en texto plano al llamar a los servicios bancarios.

Endpoint: POST /v1/cl/banking/personal/demo-bank.khipu.com/token
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `Username` (string, required)
    Identificación del usuario con acceso a la cuenta del banco (RUN, DNI).
    Example: "11.111.111-1"

  - `Password` (string, required)
    Clave de acceso del usuario a la cuenta del banco.
    Example: "wxyz1234!@#$"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación, "OK" significa que las credenciales son correctas
  y se generó el enlace de la cuenta. (AccountLink)
    Enum: "OK"

  - `Data` (object,null, required)
    Si la autenticación fue exitosa, incluye el enlace para la cuenta.(AccountLink)

  - `Data.AccountLink` (string, required)
    Token generado para acceder a la cuenta bancaria.
    Example: "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="

  - `AdditionalInformation` (string,null, required)
    Éste campo puede ser usado para mostrar información relevante específica  de la respuesta, por ejemplo indicando que el campo  está incompleto.

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando . Si  este campo será . Puedes leer una explicación completa de este objeto visitando [este enlace](https://docs.khipu.com/data-solutions/open-finance/codes-errors).

  - `Error.Code` (string)
    Código interno del sistema que identifica el error.
    Example: "E201"

  - `Error.Type` (string)
    Indica cómo tratar este código de error específico, según el tipo de error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Descripción asociada al código de error, que explica el problema ocurrido y cómo solucionarlo.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    Esté campo debe ser  en peticiones síncronas, ya que el token
  generado no tiene una duración definida. En peticiones asíncronas, indica
  el tiempo estimado en que el token generado será válido, en formato ISO 8601.