Open Finance

Chile

Banca

Empresas

Itaú

Latest Transactions

Itaú (v1.0)

Download OpenAPI description

openapi.json

openapi.yaml

Overview

Licencia

Khipu Open Data API

Servers

Production

https://api.khipu.com/

Latest Transactions

Request

Este método se conecta a la cuenta especificada por el usuario en Itaú - Empresas y retorna las transacciones más recientes con el límite determinado por el banco (también conocido como "Últimos 100 movimientos").

El uso del campo CallbackUrl desencadenará un proceso asíncrono y los datos resultantes se enviarán más tarde al webhook especificado. Esta es la forma preferida de interactuar con nuestros servicios, ya que asegura que se harán todos los esfuerzos para extraer los datos y cumplir con su solicitud dentro de un plazo razonable. Si desea la respuesta de inmediato, omita el campo CallbackUrl pero tenga en cuenta que puede provocar tiempos de espera dependiendo del tamaño del resultado de los datos y las condiciones de la red.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

AccountNumberstring[ 1 .. 20 ] charactersrequerido

Número de cuenta bancaria.

Ejemplo: "11887755"

Currencystring<= 3 characters^[A-Z]{3,3}$

Identificación de la moneda en la que se mantiene la cuenta. Utilización: La moneda sólo debe utilizarse en caso de que sea necesaria para identificar la cuenta.

Ejemplo: "CLP"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/latest/transactions \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "AccountNumber": "11887755"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Estado de la operación. OK significa que el servicio se ha ejecutado correctamente aunque no devuelva datos. ERROR indica que ha ocurrido algo que ha impedido la finalización con éxito del proceso.

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor de transacciones.

TransactionArray of objects>= 0 itemsrequerido

Proporciona más detalles sobre las transacciones. Puede ser un arreglo vacío.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "Amount": { … },
        "Balance": { … },
        "BankTransactionCode": { … },
        "CreditorAgent": { … },
        "DebtorAgent": { … },
        "SupplementaryData": {}
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Outbound Transfers

Request

Este método se conecta a la cuenta especificada por el usuario en Itaú - Empresas y retorna las transferencias enviadas para la fecha especificada (también conocido como "Transferencias enviadas").

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

BookingDatestring^(19[7-9][0-9]|20([0-1][0-9]|2[0-4]))-(0[1-9]...requerido

Fecha en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.

Ejemplo: "2024-02"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/outbound-transfers \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "BookingDate": "2024-02"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor de transacciones.

TransactionArray of objects>= 0 itemsrequerido

Proporciona más detalles sobre las transacciones. Puede ser un arreglo vacío.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "TransactionReference": "09cce92d-494b-4f29-8584-6a0409a052c7",
        "Amount": { … },
        "CreditorAccount": { … },
        "CreditorAgent": { … },
        "SupplementaryData": {}
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Statements Transactions Daily Filter

Request

Este método se conecta a la cuenta especificada por el usuario en Itau - Empresas y retorna las transacciones registradas en los estados de cuenta emitidos por el banco dentro del rango de fechas especificado por dias (también conocido como "Cartola Histórica Filtro Diario").

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

BookingDatestring^(19[7-9][0-9]|20([0-1][0-9]|2[0-4]))-(0[1-9]...requerido

Fecha en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.

Ejemplo: "2024-02"

AccountNumberstring[ 1 .. 20 ] charactersrequerido

Número de cuenta bancaria.

Ejemplo: "11887755"

Currencystring<= 3 characters^[A-Z]{3,3}$requerido

Identificación de la moneda en la que se mantiene la cuenta. Utilización: La moneda sólo debe utilizarse en caso de que sea necesaria para identificar la cuenta.

Ejemplo: "CLP"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/statements/transactions/daily \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "BookingDate": "2024-02",
      "AccountNumber": "11887755",
      "Currency": "CLP"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor de transacciones.

TransactionArray of objects>= 0 itemsrequerido

Proporciona más detalles sobre las transacciones. Puede ser un arreglo vacío.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "AddressLine": "SUCURSAL SANTIAGO CENTRO",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "Amount": { … },
        "Balance": { … },
        "BankTransactionCode": { … }
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Statements Transactions

Request

Este método se conecta a la cuenta especificada por el usuario en Itaú - Empresas y retorna las transacciones registradas en los estados de cuenta emitidos por el banco dentro del rango de fechas especificado (también conocido como "Cartola histórica").

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Información necesaria para conectarse a la cuenta del usuario en el sitio web y extraer datos. Los campos obligatorios indican los valores necesarios para identificar la cuenta deseada.

AccountNumberstring[ 1 .. 20 ] charactersrequerido

Número de cuenta bancaria.

Ejemplo: "11887755"

BookingDateStartstring^(19[7-9][0-9]|20([0-1][0-9]|2[0-4]))-(0[1-9]...requerido

Fecha de inicio en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.

Ejemplo: "2022-07"

BookingDateEndstring^(19[7-9][0-9]|20([0-1][0-9]|2[0-4]))-(0[1-9]...requerido

Fecha final en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.

Ejemplo: "2022-07"

Currencystring<= 3 characters^[A-Z]{3,3}$

Identificación de la moneda en la que se mantiene la cuenta. Utilización: La moneda sólo debe utilizarse en caso de que sea necesaria para identificar la cuenta.

Ejemplo: "CLP"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

One of:

Deprecado

Atención: El uso de este campo es obligatorio cuando se utiliza autenticación por Api Key.

CallbackUrlstring<= 255 characters

URL para enviar el mensaje de respuesta utilizando un método POST.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/statements/transactions \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "AccountNumber": "11887755",
      "BookingDateStart": "2022-07",
      "BookingDateEnd": "2022-07"
    }
  }'

Responses

Operación exitosa. Retorna un objeto JSON con los datos solicitados.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Contenedor de transacciones.

TransactionArray of objects>= 0 itemsrequerido

Proporciona más detalles sobre las transacciones. Puede ser un arreglo vacío.

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "AddressLine": "SUCURSAL SANTIAGO CENTRO",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "Amount": { … },
        "Balance": { … },
        "BankTransactionCode": { … }
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Booked Month Statements (LCY)

Request

This method connects to the user's specified account in Itaú-Empresas and returns the desired month's booked statements (also known as "Resumen de movimientos cuenta corriente").

Using the CallbackUrl field will trigger an asynchronous process and the resulting data will be sent later to the specified webhook. This is the preferred way to interact with our services, as it assures that all efforts will be made to extract the data to fulfill your request within a reasonable time frame. If you want the response immediately, skip the field CallbackUrl but bear in mind that it can result in timeouts depending on the data's result size and the network conditions.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Information needed to connect to the user's bank account and extract data. Mandatory fields indicates values that are necessary to identify the desired account.

AccountNumberstring<= 20 charactersrequerido

Bank account number.

Ejemplo: "000011887755"

BookingDatestring^((19[7-9][0-9])|(20[0-1][0-9])|(202[0-3]))-(...requerido

Start date used for fetch the transactions, in ISO 8601 format (yyyy-mm)

Ejemplo: "2022-07"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

One of:

Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

CallbackUrlstring<= 255 characters

URL to send the response message using a POST verb.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/booked/month/LCY/statements \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "AccountNumber": "000011887755",
      "BookingDate": "2022-07"
    }
  }'

Responses

Successful operation. Returns a JSON object with the booked statements for the specified account in the Data field.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Unique identifier of the operation.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Operation status. OK means that the service was executed successfully even if it does not return Data. ERROR indicates that something happened that prevented the successful completion of the process.

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Container for Statements. Can be an empty array.

StatementArray of objects>= 0 items

Provides further details on a statement resource.

AdditionalInformationstring or nullrequerido

This field can be used to display relevant information specific to the response, for instance indicating that the Data field is incomplete.

Ejemplo: null

Errorobject or nullrequerido

Object with the error details, used when Status=ERROR. If Status=OK this field will be null. You can read a complete explanation of this object visiting this link

Ejemplo: null

Codestring

Internal system code that identifies the error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Description associated with the error code.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null in sync requests.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Statement": [
      {
        "AccountId": "873458",
        "CreationDateTime": "2017-07-21T17:32:28-0400",
        "EndDateTime": "2017-06-30T23:59:59-0400",
        "StartDateTime": "2017-06-01T00:00:00-0400",
        "StatementDescription": [ … ],
        "StatementId": "4525f6656f4248a99d289fe8d213557d",
        "StatementReference": "a2c557c63450",
        "Type": "RegularPeriodic",
        "StatementAmount": [ … ],
        "StatementBenefit": [ … ],
        "StatementDateTime": [ … ],
        "StatementFee": [ … ],
        "StatementInterest": [ … ],
        "StatementRate": [ … ],
        "StatementValue": [ … ]
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Booked Month Transactions / Inbound Transfers (LCY)

Request

This method connects to the user's account in Itaú-Empresas and returns the desired month's booked transactions for inbound transfers (also known as "Transferencias recibidas").

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Information needed to connect to the user's bank account and extract data. Mandatory fields indicates values that are necessary to identify the desired account.

BookingDatestring^((19[7-9][0-9])|(20[0-1][0-9])|(202[0-3]))-(...requerido

Start date used for fetch the transactions, in ISO 8601 format (yyyy-mm)

Ejemplo: "2022-07"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

One of:

Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

CallbackUrlstring<= 255 characters

URL to send the response message using a POST verb.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/booked/month/LCY/transactions/inbound-transfers \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "BookingDate": "2022-07"
    }
  }'

Responses

Successful operation. Returns a JSON object with the booked inbound transactions for the specified account in the Data field.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Unique identifier of the operation.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Container for Transactions. Can be an empty array.

TransactionArray of objects>= 0 items

Provides further details on an entry in the report.

AdditionalInformationstring or nullrequerido

This field can be used to display relevant information specific to the response, for instance indicating that the Data field is incomplete.

Ejemplo: null

Errorobject or nullrequerido

Object with the error details, used when Status=ERROR. If Status=OK this field will be null. You can read a complete explanation of this object visiting this link

Ejemplo: null

Codestring

Internal system code that identifies the error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Description associated with the error code.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null in sync requests.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "AddressLine": "SUCURSAL SANTIAGO CENTRO",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "StatementReference": [ … ],
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "TransactionMutability": "Immutable",
        "TransactionReference": "09cce92d-494b-4f29-8584-6a0409a052c7",
        "ValueDateTime": "2017-07-21T17:32:28-0400",
        "Amount": { … },
        "Balance": { … },
        "BankTransactionCode": { … },
        "CardInstrument": { … },
        "ChargeAmount": { … },
        "CreditorAccount": { … },
        "CreditorAgent": { … },
        "CurrencyExchange": { … },
        "DebtorAccount": { … },
        "DebtorAgent": { … },
        "MerchantDetails": { … },
        "ProprietaryBankTransactionCode": { … },
        "SupplementaryData": [ … ]
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Pending Current Transactions / Card Purchases (LCY)

Request

This method connects to the user's account in Itaú-Empresas and returns the last non-bookend transactions for purchases made with the specified credit card (also known as "Últimas compras en pesos").

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

RequestDataobjectrequerido

Information needed to connect to a Itaú-Empresas bank account and extract data from card purchases. Mandatory fields indicates values that are necessary to identify the desired account.

Productstringrequerido

Name of the credit card.

Ejemplo: "CreditCard Business"

LastDigitsstring^\d{4}$requerido

Last 4 digits of the credit card.

Ejemplo: "0634"

AccountCredentialAccountLinkCredential (object) or AccountAuthCredential (object)Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

One of:

Deprecado

Attention: The use of this field is mandatory when using Api Key authentication.

CallbackUrlstring<= 255 characters

URL to send the response message using a POST verb.

Ejemplo: "https://my-api.my-business.com/api/open-data-response"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/pending/current/LCY/transactions/card-purchases \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "Product": "CreditCard Business",
      "LastDigits": "0634"
    }
  }'

Responses

Successful operation. Returns a JSON object with the last non-booked transactions for purchases made with the specified credit card in the Data field.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Unique identifier of the operation.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobject or nullrequerido

Container for Transactions. Can be an empty array.

TransactionArray of objects>= 0 items

Provides further details on an entry in the report.

AdditionalInformationstring or nullrequerido

This field can be used to display relevant information specific to the response, for instance indicating that the Data field is incomplete.

Ejemplo: null

Errorobject or nullrequerido

Object with the error details, used when Status=ERROR. If Status=OK this field will be null. You can read a complete explanation of this object visiting this link

Ejemplo: null

Codestring

Internal system code that identifies the error.

Ejemplo: "E201"

Typestring

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"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Description associated with the error code.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null in sync requests.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "Transaction": [
      {
        "AccountId": "873458",
        "AddressLine": "SUCURSAL SANTIAGO CENTRO",
        "BookingDateTime": "2017-07-22T00:00:00-0400",
        "CreditDebitIndicator": "Credit",
        "StatementReference": [ … ],
        "Status": "Booked",
        "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87",
        "TransactionInformation": "PAGO DE CUENTAS",
        "TransactionMutability": "Immutable",
        "TransactionReference": "09cce92d-494b-4f29-8584-6a0409a052c7",
        "ValueDateTime": "2017-07-21T17:32:28-0400",
        "Amount": { … },
        "Balance": { … },
        "BankTransactionCode": { … },
        "CardInstrument": { … },
        "ChargeAmount": { … },
        "CreditorAccount": { … },
        "CreditorAgent": { … },
        "CurrencyExchange": { … },
        "DebtorAccount": { … },
        "DebtorAgent": { … },
        "MerchantDetails": { … },
        "ProprietaryBankTransactionCode": { … },
        "SupplementaryData": [ … ]
      }
    ]
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Account LinkDeprecado

Request

Este método se está descontinuando y se retirará en los próximos meses. Migre su implementación actual para usar tokens OAuth en su lugar.

Este método se conecta a la cuenta del usuario en Itaú - Empresas 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.

Security

JWT or Api-Key

Bodyapplication/jsonRequerido

Usernamestring[ 1 .. 12 ] charactersrequerido

Identificación del usuario con acceso a la cuenta en el sitio web (RUN, DNI).

Ejemplo: "11.111.111-1"

Passwordstring[ 1 .. 24 ] charactersrequerido

Contraseña de la cuenta para el sitio web.

Ejemplo: "wxyz1234!@#$"

EnterpriseIdentitystring[ 1 .. 12 ] characters

Identificación de empresa (RUT).

Ejemplo: "99.999.999-9"

curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/business/itau.cl/token \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "Username": "11.111.111-1",
    "Password": "wxyz1234!@#$"
  }'

Responses

Operación exitosa. Retorna un objeto JSON con el token de la cuenta en el campo Data.

Bodyapplication/json

OperationIdstring<= 36 charactersrequerido

Identificador único de la operación.

Ejemplo: "6baf6c19-e485-463b-ae24-a821b025c8a4"

Statusstringrequerido

Enum"OK""ERROR"

Ejemplo: "OK"

Dataobjectrequerido

Si la autenticación se ha realizado correctamente, incluye el 'Account Link' para la cuenta.

AccountLinkstringrequerido

Token generado para acceder a la cuenta del sitio web.

Ejemplo: "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="

AdditionalInformationstring or nullrequerido

Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data está incompleto.

Ejemplo: null

Errorobject or nullrequerido

Objeto con los detalles del error, utilizado cuando Status=ERROR. Si Status=OK este campo será nulo. Puede leer una explicación completa de este objeto visitando este enlace

Ejemplo: null

Codestring

Código interno del sistema que identifica el error.

Ejemplo: "E201"

Typestring

Indica cómo tratar este código de error específico, en función del tipo de error.

Enum"RETRY_IMMEDIATELY""DO_NOT_RETRY""WAIT_4_HOURS_BEFORE_RETRY""RETRY_AFTER_NOTIFICATION"

Ejemplo: "RETRY_IMMEDIATELY"

Descriptionstring

Descripción asociada al código de error.

Ejemplo: "El servicio destino utilizado para la extracción de datos no se encuentra disponible."

LifeSpanstring or nullrequerido

null en peticiones sincrónicas.

Ejemplo: null

Response

application/json

{
  "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4",
  "Status": "OK",
  "Data": {
    "AccountLink": "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="
  },
  "AdditionalInformation": null,
  "Error": null,
  "LifeSpan": null
}

Itaú (v1.0)

Latest Transactions

Request

Responses

¿Fue útil esta info?

Outbound Transfers

Request

Responses

¿Fue útil esta info?

Statements Transactions Daily Filter

Request

Responses

¿Fue útil esta info?

Statements Transactions

Request

Responses

¿Fue útil esta info?

Booked Month Statements (LCY)

Request

Responses

¿Fue útil esta info?

Booked Month Transactions / Inbound Transfers (LCY)

Request

Responses

¿Fue útil esta info?

Pending Current Transactions / Card Purchases (LCY)

Request

Responses

¿Fue útil esta info?

Account LinkDeprecado

Request

Responses

¿Fue útil esta info?

Itaú (v1.0)

Latest Transactions

RequestExpandir todo

Responses

¿Fue útil esta info?

Outbound Transfers

RequestExpandir todo

Responses

¿Fue útil esta info?

Statements Transactions Daily Filter

RequestExpandir todo

Responses

¿Fue útil esta info?

Statements Transactions

RequestExpandir todo

Responses

¿Fue útil esta info?

Booked Month Statements (LCY)

RequestExpandir todo

Responses

¿Fue útil esta info?

Booked Month Transactions / Inbound Transfers (LCY)

RequestExpandir todo

Responses

¿Fue útil esta info?

Pending Current Transactions / Card Purchases (LCY)

RequestExpandir todo

Responses

¿Fue útil esta info?

Account LinkDeprecado

Request

Responses

¿Fue útil esta info?

Request

Request

Request

Request

Request

Request

Request