https://api.khipu.com/
Este método se conecta a la cuenta especificada por el usuario en Banco Internacional - Empresas y retorna los saldos actuales de la cuenta (también conocido como "Total Saldo Disponible").
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.
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.
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.
https://api.khipu.com/v1/cl/banking/business/internacional.cl/current/balances
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/internacional.cl/current/balances \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {
"AccountNumber": "11887755"
}
}'
Operación exitosa. Retorna un objeto JSON con los datos solicitados.
Identificador único de la operación.
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.
Contenedor de saldos.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
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
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "Balance": [ { "AccountId": "873458", "CreditDebitIndicator": "Credit", "DateTime": "2017-07-21T17:32:28-0400", "Type": "ClosingAvailable", "Amount": { … } } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Banco Internacional - Empresas y retorna las transacciones más recientes con el límite determinado por el banco (también conocido como "Últimos 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.
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.
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.
https://api.khipu.com/v1/cl/banking/business/internacional.cl/latest/transactions
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/internacional.cl/latest/transactions \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {
"AccountNumber": "11887755"
}
}'
Operación exitosa. Retorna un objeto JSON con los datos solicitados.
Identificador único de la operación.
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.
Contenedor de transacciones.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
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
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "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": { … } } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Banco Internacional - 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").
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.
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.
Fecha de inicio en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.
Fecha final en formato ISO 8601 (YYYY-MM) utilizada para obtener las transacciones.
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.
https://api.khipu.com/v1/cl/banking/business/internacional.cl/statements/transactions
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/internacional.cl/statements/transactions \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {
"AccountNumber": "11887755",
"BookingDateStart": "2022-07",
"BookingDateEnd": "2022-07"
}
}'
Operación exitosa. Retorna un objeto JSON con los datos solicitados.
Identificador único de la operación.
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.
Contenedor de transacciones.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
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
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "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": { … } } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
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 Banco Internacional - 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.
Identificación del usuario con acceso a la cuenta en el sitio web (RUN, DNI).
Contraseña de la cuenta para el sitio web.
https://api.khipu.com/v1/cl/banking/business/internacional.cl/token
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/internacional.cl/token \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"Username": "11.111.111-1",
"Password": "wxyz1234!@#$"
}'
Operación exitosa. Retorna un objeto JSON con el token de la cuenta en el campo Data
.
Identificador único de la operación.
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.
Si la autenticación se ha realizado correctamente, incluye el 'Account Link' para la cuenta.
Este campo puede utilizarse para mostrar información relevante específica de la respuesta, por ejemplo indicando que el campo Data
está incompleto.
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
Indica cómo tratar este código de error específico, en función del tipo de error.
{ "OperationId": "6baf6c19-e485-463b-ae24-a821b025c8a4", "Status": "OK", "Data": { "AccountLink": "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB==" }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }