# Account Link

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

Endpoint: POST /v1/ar/banking/business/santander.com.ar/token
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `DocumentNumber` (number, required)
    User's document number identification with access to the bank's account (DNI).
    Example: "999999999"

  - `Username` (string, required)
    User identification with access to the bank's account.
    Example: "example00"

  - `Password` (number, required)
    Account password for the website.
    Example: "1234"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Unique identifier of the operation.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Operation status, "OK" meaning that the credentials were correct and the account link was generated.
    Enum: "OK"

  - `Data` (object,null, required)
    If the authentication challenge was successful, it includes the link for the account.

  - `Data.AccountLink` (string, required)
    Token generated to access the bank account.
    Example: "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="

  - `AdditionalInformation` (string,null, required)
    This field can be used to display relevant information specific to the response, for instance indicating that the  field is incomplete.

  - `Error` (object,null, required)
    Object with the error details, used when . If  this field will be null. You can read a complete explanation of this object visiting [this link](https://docs.khipu.com/portal/en/errors/)

  - `Error.Code` (string)
    Internal system code that identifies the error.
    Example: "E201"

  - `Error.Type` (string)
    Indicates how to treat this specific error code, based on the type of error.
    Enum: "RETRY_IMMEDIATELY", "DO_NOT_RETRY", "WAIT_4_HOURS_BEFORE_RETRY", "RETRY_AFTER_NOTIFICATION"

  - `Error.Description` (string)
    Description associated with the error code.
    Example: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

  - `LifeSpan` (string,null, required)
    in sync requests.