https://api.khipu.com/
Este método se conecta a la cuenta especificada por el usuario en Banco Santander - Office Banking y retorna las últimas transacciones de compras hechas con la tarjeta de crédito especificada, las cuales no han sido facturados aún (también conocido como "Movimientos no facturados").
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.
Número de cuatro dígitos usado para identificar la tarjeta, el cual corresponde a los últimos cuatro dígitos de la tarjeta.
Tipo de transacciones a obtener.
https://api.khipu.com/v1/cl/banking/business/santander.cl/credit-card/unbilled-transactions
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.cl/credit-card/unbilled-transactions \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"RequestData": {
"LastDigits": "1234",
"TransactionType": "National"
}
}'
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", "AddressLine": "SUCURSAL SANTIAGO CENTRO", "BookingDateTime": "2017-07-22T00:00:00-0400", "CreditDebitIndicator": "Credit", "Status": "Booked", "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87", "TransactionInformation": "PAGO DE CUENTAS", "Amount": { … }, "SupplementaryData": {} } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Banco Santander - Office Banking y retorna los saldos actuales de la cuenta (también conocido como "Saldo en la cartola provisoria").
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/santander.cl/current/balances
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.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 Santander - Office Banking y retorna las transacciones dentro del estado de cuenta actual (también conocido como "Cartola provisoria").
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/santander.cl/current-statement/transactions
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.cl/current-statement/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", "AddressLine": "SUCURSAL SANTIAGO CENTRO", "BookingDateTime": "2017-07-22T00:00:00-0400", "CreditDebitIndicator": "Credit", "Status": "Booked", "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87", "TransactionInformation": "PAGO DE CUENTAS", "Amount": { … }, "BankTransactionCode": { … }, "SupplementaryData": {} } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Banco Santander - Office Banking 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/santander.cl/statements/transactions
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.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", "AddressLine": "SUCURSAL SANTIAGO CENTRO", "BookingDateTime": "2017-07-22T00:00:00-0400", "CreditDebitIndicator": "Credit", "Status": "Booked", "TransactionId": "c830d0c9a0904ea6badbaf8e25ff6e87", "TransactionInformation": "PAGO DE CUENTAS", "Amount": { … }, "BankTransactionCode": { … } } ] }, "AdditionalInformation": null, "Error": null, "LifeSpan": null }
Este método se conecta a la cuenta especificada por el usuario en Banco Santander - Office Banking y retorna el resumen de los estados de cuenta emitidos por el banco dentro del rango de fechas especificado (también conocido como "Resumen de estado de cuenta").
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/santander.cl/statements
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.cl/statements \
-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 resumen de estados de 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": { "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": "ATRIBUTOS ADICIONALES", "StatementReference": "a2c557c63450", "Type": "RegularPeriodic", "StatementAmount": [ … ] } ] }, "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 Santander - Office Banking 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.
Identificación de empresa (RUT).
https://api.khipu.com/v1/cl/banking/business/santander.cl/token
curl -i -X POST \
https://api.khipu.com/v1/cl/banking/business/santander.cl/token \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"Username": "11.111.111-1",
"Password": "wxyz1234!@#$",
"EnterpriseIdentity": "99.999.999-9",
"Role": "Usuario"
}'
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 }