Skip to content
Download OpenAPI description
Overview
Languages
Servers
Production

https://api.khipu.com/

Request

Éste método conecta con la cuenta del usuario especificada en DemoBank y devuelve las transacciones del día actual. 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/jsonrequired
RequestDataobjectrequired

Información necesaria para conectarse a la cuenta del banco del usuario y extraer datos. Los campos obligatorios indican los valores que son necesarios para identificar la cuenta deseada.

AccountNumberstring<= 20 charactersrequired

Número de cuenta bancaria.

Example: "000011887755"
AccountCredentialobjectDeprecated

Atención
El uso de este campo es obligatorio al usar autenticación con Api Key.
Autenticación de la cuenta del usuario para realizar operaciones.

One of:
Deprecated

Atención
El uso de este campo es obligatorio al usar autenticación con Api Key.
Autenticación de la cuenta del usuario para realizar operaciones.

CallbackUrlstring<= 255 characters

URL al que se enviará la respuesta del servicio usando el método POST.

Example: "https://my-api.my-business.com/api/open-data-response"
curl -i -X POST \
  https://api.khipu.com/v1/cl/banking/personal/demo-bank.khipu.com/transactions \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "RequestData": {
      "AccountNumber": "000011887755"
    }
  }'

Responses

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

Bodyapplication/json
OperationIdstring<= 36 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

Estado de la operación. OK significa que el servicio se ejecutó correctamente, incluso si no devuelve datos. ERROR indica que ocurrió algo que impidió la finalización exitosa del proceso.

Enum"OK""ERROR"
Example: "OK"
Dataobject or nullrequired

Contener para las transacciones. Puede ser un array vacío.

TransactionArray of objects>= 0 items

Proveé más detalles sobre una entrada en el reporte.

AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "E201"
Typestring

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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

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."
LifeSpanstring or nullrequired

null en operaciones síncronas.

Example: 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 }

Request

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.

Éste método conecta con la cuenta del usuario en DemoBank 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.

Security
JWT or Api-Key
Bodyapplication/jsonrequired
Usernamestring[ 1 .. 12 ] charactersrequired

Identificación del usuario con acceso a la cuenta del banco (RUN, DNI).

Example: "11.111.111-1"
Passwordstring[ 1 .. 24 ] charactersrequired

Clave de acceso del usuario a la cuenta del banco.

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

Responses

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

Bodyapplication/json
OperationIdstring<= 36 charactersrequired

Identificador único de la operación.

Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"
Statusstringrequired

Estado de la operación, "OK" significa que las credenciales son correctas y se generó el enlace de la cuenta. (AccountLink)

Value"OK"
Example: "OK"
Dataobject or nullrequired

Si la autenticación fue exitosa, incluye el enlace para la cuenta.(AccountLink)

AccountLinkstringrequired

Token generado para acceder a la cuenta bancaria.

Example: "dFyRCVYNM0aGb1LSR/0B8e+eSVr1Zf1xj9YHmMVoiZWk28XtWEyIxEbGXnr1EdvS+QBPzjweau7tbf5QlDv97IQ2jwfUB=="
AdditionalInformationstring or nullrequired

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

Example: null
Errorobject or nullrequired

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

Example: null
Codestring

Código interno del sistema que identifica el error.

Example: "E201"
Typestring

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"
Example: "RETRY_IMMEDIATELY"
Descriptionstring

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."
LifeSpanstring or nullrequired

Esté campo debe ser null 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.

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