# Transactions

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

Endpoint: POST /v1/cl/banking/personal/demo-bank.khipu.com/transactions
Version: v1.0
Security: JWT, Api-Key

## Request fields (application/json):

  - `RequestData` (object, required)
    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.

  - `RequestData.AccountNumber` (string, required)
    Número de cuenta bancaria.
    Example: "000011887755"

  - `RequestData.AccountCredential` (any)
    {% admonition type="warning" name="Atención" %} El uso de este campo es obligatorio al usar autenticación con Api Key. {% /admonition %} Autenticación de la cuenta del usuario para realizar operaciones.

  - `CallbackUrl` (string)
    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"

## Response 200 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación.  significa que el servicio se ejecutó
  correctamente, incluso si no devuelve datos.  indica que ocurrió
  algo que impidió la finalización exitosa del proceso.
    Enum: "OK", "ERROR"

  - `Data` (object,null, required)
    Contener para las transacciones. Puede ser un array vacío.

  - `Data.Transaction` (array)
    Proveé más detalles sobre una entrada en el reporte.

  - `Data.Transaction.AccountId` (string, required)
    Identificador único e inmutable utilizado para identificar el recurso de cuenta. Éste identificador no tiene significado para el propietario de la cuenta.
    Example: "873458"

  - `Data.Transaction.BookingDateTime` (string, required)
    Date and time when a transaction entry is posted to an account on the account servicer's books. Usage: Booking date is the expected booking date, unless the status is booked, in which case it is the actual booking date. Fecha y hora en que una entrada de transacción es registrada en la cuenta.  Uso: La fecha de registro es la fecha de registro esperada, a menos que el estado sea "registrado", en cuyo caso es la fecha de registro real.
    Example: "2017-07-22T00:00:00-0400"

  - `Data.Transaction.CreditDebitIndicator` (string, required)
    Indica si la transacción es un abono o un cargo. (Credit o Debit)
    Enum: "Credit", "Debit"

  - `Data.Transaction.Status` (string, required)
    Estado de la transacción en los libros contables del prestador de servicios de la cuenta.
    Enum: "Booked", "Pending", "Rejected"

  - `Data.Transaction.Amount` (object, required)
    Cantidad de dinero en la entrada de transacción de efectivo.

  - `Data.Transaction.Amount.Amount` (number, required)
    Monto de unidades monetarias especificado en una moneda activa donde la unidad de moneda es explícita y cumple con ISO 4217.
    Example: 10000

  - `Data.Transaction.Amount.Currency` (string, required)
    Código asignado a una moneda por una Agencia de Mantenimiento bajo un esquema
  internacional de identificación, como se describe en la última edición de
  la norma internacional ISO 4217 "Códigos para la representación de monedas
  y fondos".
    Example: "CLP"

  - `Data.Transaction.AddressLine` (string)
    Información que localiza e identifica una dirección específica para una entrada de transacción, que se presenta en texto de formato libre.
    Example: "SUCURSAL SANTIAGO CENTRO"

  - `Data.Transaction.StatementReference` (array)
    Referencia única para el estado de cuenta. Esta referencia puede ser opcionalmente enviada si está disponible.
    Example: ["a2c557c63450"]

  - `Data.Transaction.TransactionId` (string)
    Identificador único para la transacción dentro de una institución de servicio. Éste identificador es único e inmutable.
    Example: "c830d0c9a0904ea6badbaf8e25ff6e87"

  - `Data.Transaction.TransactionInformation` (string)
    Detalles adicionales de la transacción. Esta es la narrativa de la transacción, que es texto no estructurado.
    Example: "PAGO DE CUENTAS"

  - `Data.Transaction.TransactionMutability` (string)
    Espécifica la mutabilidad del registro de transacción.
    Enum: "Mutable", "Immutable"

  - `Data.Transaction.TransactionReference` (string)
    Referencia única para la transacción.
    Example: "09cce92d-494b-4f29-8584-6a0409a052c7"

  - `Data.Transaction.ValueDateTime` (string)
    Fecha y hora en que los activos se vuelven disponibles para el propietario de la cuenta en caso de una entrada de crédito, o dejan de estar disponibles para el propietario de la cuenta en caso de una entrada de débito. Uso: Si el estado de la entrada de transacción es pendiente y ValueDateTime está presente, entonces ValueDateTime se refiere a una fecha esperada/solicitada. Para entradas de transacción sujetas a disponibilidad/flotación y para las cuales se proporciona información de disponibilidad, ValueDateTime no debe ser utilizada. En este caso, el componente de disponibilidad identifica el número de días de disponibilidad.
    Example: "2017-07-21T17:32:28-0400"

  - `Data.Transaction.Balance` (object)
    Conjunto de elementos utilizados para definir el saldo como una
  representación numérica de los aumentos y disminuciones netas en una cuenta
  después de que se aplica una transacción a la cuenta.

  - `Data.Transaction.Balance.Type` (string, required)
    Balance type, in a coded form.
    Enum: "ClosingAvailable", "ClosingBooked", "ClosingCleared", "Expected", "ForwardAvailable", "Information", "InterimAvailable", "InterimBooked", "InterimCleared", "OpeningAvailable", "OpeningBooked", "OpeningCleared", "PreviouslyClosedBooked"

  - `Data.Transaction.Balance.Amount` (object, required)
    Balance de dinero del saldo de efectivo después de que se aplica una entrada de dinero a la cuenta.

  - `Data.Transaction.BankTransactionCode` (object)
    Conjunto de elementos utilizados para identificar completamente el tipo de
  transacción subyacente que resulta en una entrada.

  - `Data.Transaction.BankTransactionCode.Code` (string, required)
    Specifies the family within a domain.
    Example: "RCDT"

  - `Data.Transaction.BankTransactionCode.SubCode` (string, required)
    Specifies the sub-product family within a specific family.
    Example: "DMCT"

  - `Data.Transaction.CardInstrument` (object)
    Conjunto de elementos para describir la tarjeta utilizada en la transacción.

  - `Data.Transaction.CardInstrument.CardSchemeName` (string, required)
    Name of the card scheme.
    Enum: "AmericanExpress", "Diners", "Discover", "MasterCard", "VISA"

  - `Data.Transaction.CardInstrument.AuthorisationType` (string)
    The card authorisation type.
    Enum: "ConsumerDevice", "Contactless", "None", "PIN"

  - `Data.Transaction.CardInstrument.Identification` (string)
    Identificación asignada por una institución para identificar la tarjeta  utilizada en la transacción. Esta identificación es conocida por  el propietario de la cuenta y puede estar enmascarada.
    Example: "BLACK CARD ****6328"

  - `Data.Transaction.CardInstrument.Name` (string)
    Name of the cardholder using the card instrument.
    Example: "JOHN DOE"

  - `Data.Transaction.ChargeAmount` (object)
    Cargos a ser pagados por el portador del cargo.

  - `Data.Transaction.CreditorAccount` (object)
    Identificación inequívoca de la cuenta del acreedor, en el caso de una
  transacción de débito.

  - `Data.Transaction.CreditorAccount.Identification` (string)
    Identificación asignada por una institución para identificar una cuenta.
  Esta identificación es conocida por el propietario de la cuenta.
    Example: "99056723"

  - `Data.Transaction.CreditorAccount.Name` (string)
    El nombre de la cuenta es el nombre o los nombres del propietario(s) de la
  cuenta representados a nivel de cuenta, tal como se muestra en los canales
  en línea del ASPSP. Nota, el nombre de la cuenta no es el nombre del
  producto o el apodo de la cuenta.
    Example: "JOHN DOE"

  - `Data.Transaction.CreditorAccount.SchemeName` (string)
    Name of the identification scheme, in a coded form as published in an external list. Nombre del esquema de identificación, en una forma codificada como se
  publica en una lista externa.
    Example: "BBAN"

  - `Data.Transaction.CreditorAccount.SecondaryIdentification` (string)
    Identificación secundaria de la cuenta, según lo asignado por la
  institución que presta el servicio de la cuenta. Esto puede ser utilizado
  por sociedades de construcción para identificar adicionalmente cuentas con
  un número de rollo (además de una combinación de código de clasificación y
  número de cuenta).
    Example: "1373-86353478"

  - `Data.Transaction.CreditorAgent` (object)
    Institución financiera que presta servicios a una cuenta del acreedor.

  - `Data.Transaction.CreditorAgent.Identification` (string)
    Identificación única e inequivoca de una institución financiera o una sucursal de una institución financiera.
    Example: "DEMO BANK"

  - `Data.Transaction.CreditorAgent.Name` (string)
    Nombre por el cual se conoce a un agente y que normalmente se utiliza para identificar a ese agente.
    Example: "DEMO BANK CHILE"

  - `Data.Transaction.CreditorAgent.SchemeName` (string)
    Nombre del esquema de identificación, en una forma codificada como se
  publica en una lista externa.
    Example: "BICFI"

  - `Data.Transaction.CreditorAgent.PostalAddress` (object)
    Información que localiza e identifica una dirección específica, según lo definido por los servicios postales.

  - `Data.Transaction.CreditorAgent.PostalAddress.AddressLine` (array)
    Información que localiza e identifica una dirección específica,  según lo definido por los servicios postales, presentada en texto de formato libre.
    Example: ["AGUSTINAS 1234, SANTIAGO"]

  - `Data.Transaction.CreditorAgent.PostalAddress.AddressType` (string)
    Identifica la naturaleza de la dirección postal.
    Enum: "Business", "Correspondence", "DeliveryTo", "MailTo", "POBox", "Postal", "Residential", "Statement"

  - `Data.Transaction.CreditorAgent.PostalAddress.BuildingNumber` (string)
    Número que identifica la posición de un edificio en una calle.
    Example: "1234"

  - `Data.Transaction.CreditorAgent.PostalAddress.Country` (string)
    Nación independiente con su propio gobierno.
    Example: "CL"

  - `Data.Transaction.CreditorAgent.PostalAddress.CountrySubDivision` (string)
    Identifica una subdivisión de un país, como estado, región o condado.
    Example: "REGION METROPOLITANA"

  - `Data.Transaction.CreditorAgent.PostalAddress.Department` (string)
    Identtificación de una división de una gran organización o edificio.
    Example: "OFICINA SANTIAGO CENTRO"

  - `Data.Transaction.CreditorAgent.PostalAddress.PostCode` (string)
    Identificador que consiste en un grupo de letras y/o números que se
  añade a una dirección postal para ayudar en la clasificación del correo.
    Example: "8340422"

  - `Data.Transaction.CreditorAgent.PostalAddress.StreetName` (string)
    Nombre de una calle o vía pública.
    Example: "CALLE MONEDA"

  - `Data.Transaction.CreditorAgent.PostalAddress.SubDepartment` (string)
    Identificación de una subdivisión de una gran organización o edificio.
    Example: "BANCA PERSONAS"

  - `Data.Transaction.CreditorAgent.PostalAddress.TownName` (string)
    Nombre de una zona urbanizada, con límites definidos y un gobierno local.
    Example: "SANTIAGO"

  - `Data.Transaction.CurrencyExchange` (object)
    Conjunto de elementos utilizados para proporcionar detalles sobre el cambio de divisas.

  - `Data.Transaction.CurrencyExchange.ExchangeRate` (string, required)
    Factor usado para convertir un monto de una moneda a otra.  Esto refleja el precio al que se compró una moneda con otra moneda.  Uso: ExchangeRate expresa la relación entre UnitCurrency y  QuotedCurrency (ExchangeRate = UnitCurrency/QuotedCurrency).
    Example: "691.907186"

  - `Data.Transaction.CurrencyExchange.SourceCurrency` (string, required)
    Moneda desde la que se convertirá un monto en una conversión de divisas.
    Example: "USD"

  - `Data.Transaction.CurrencyExchange.ContractIdentification` (string)
    Identificación única para identificar de forma inequívoca el contrato de
  cambio de divisas.
    Example: "84783113"

  - `Data.Transaction.CurrencyExchange.QuotationDate` (string)
    Fecha y hora en que se cotiza un tipo de cambio.
    Example: "2019-05-15T09:45:00-0400"

  - `Data.Transaction.CurrencyExchange.TargetCurrency` (string)
    Moneda a la que se convertirá un monto en una conversión de divisas.
    Example: "CLP"

  - `Data.Transaction.CurrencyExchange.UnitCurrency` (string)
    Moneda en la que se expresa la tasa de cambio en un cambio de divisas. En el ejemplo 1USD = xxxCLP, la moneda unitaria es USD.
    Example: "USD"

  - `Data.Transaction.CurrencyExchange.InstructedAmount` (object)
    Cantidad de dinero a ser transferida entre el deudor y acreedor, antes de la
  deducción de cargos, expresada en la moneda ordenada por la parte iniciadora.

  - `Data.Transaction.DebtorAccount` (object)
    Identificación inequívoca de la cuenta del deudor, en el caso de una
  transacción de crédito.

  - `Data.Transaction.DebtorAccount.Name` (string)
    Nombre de la cuenta es el nombre o los nombres del propietario(s) de la
  cuenta representada a nivel de cuenta, como se muestra en los canales
  en línea del ASPSP. Nota, el nombre de la cuenta no es el nombre del
  producto o el apodo de la cuenta.
    Example: "JOHN DOE"

  - `Data.Transaction.DebtorAccount.SchemeName` (string)
    Name of the identification scheme, in a coded form as published in an external list. Nombre del esquema de identificación, en un formato codificado
  publicado en una lista externa.
    Example: "BBAN"

  - `Data.Transaction.DebtorAccount.SecondaryIdentification` (string)
    Identificación secundaria de la cuenta, asignada por la
  institución que presta servicios a la cuenta. Esto puede ser utilizado
  por sociedades de construcción para identificar adicionalmente cuentas
  con un número de rollo (además de una combinación de código de orden y
  número de cuenta).
    Example: "1373-86353478"

  - `Data.Transaction.DebtorAgent` (object)
    Institución financiera que presta servicios a una cuenta del deudor.

  - `Data.Transaction.DebtorAgent.Identification` (string)
    Identificación única e inequívoca de una institución financiera o una sucursal de una institución financiera.
    Example: "DEMO BANK"

  - `Data.Transaction.DebtorAgent.SchemeName` (string)
    Nombre del esquema de identificación, en un formato codificado como se
  publica en una lista externa.
    Example: "BICFI"

  - `Data.Transaction.MerchantDetails` (object)
    Detalles de la entidad comercial involucrada en la transacción.

  - `Data.Transaction.MerchantDetails.MerchantCategoryCode` (string)
    Código de categoría conforme a ISO 18245, relacionado con el tipo de  servicios o bienes que provee el comercio para la transacción.
    Example: "2741"

  - `Data.Transaction.MerchantDetails.MerchantName` (string)
    Nombre por el cual se conoce al comercio.
    Example: "MI COMERCIO"

  - `Data.Transaction.ProprietaryBankTransactionCode` (object)
    Conjunto de elementos para identificar completamente un código de transacción bancaria propietario.

  - `Data.Transaction.ProprietaryBankTransactionCode.Code` (string, required)
    Código de transacción bancaria propietario para identificar la transacción subyacente.
    Example: "TRANSFERENCIA"

  - `Data.Transaction.ProprietaryBankTransactionCode.Issuer` (string)
    Identificación del emisor del código de transacción bancaria propietario.
    Example: "DEMO BANK"

  - `Data.Transaction.SupplementaryData` (array)
    Información adicional que no puede ser capturada en los campos estructurados y/o en cualquier otro bloque específico.

  - `AdditionalInformation` (string,null, required)
    Éste campo puede ser usado para mostrar información relevante específica
  de la respuesta, por ejemplo indicando que el campo  está incompleto.

  - `Error` (object,null, required)
    Objeto con los detalles del error, utilizado cuando . Si  este campo será . Puedes leer una explicación completa de este objeto visitando [este enlace](https://docs.khipu.com/data-solutions/open-finance/codes-errors).

  - `Error.Code` (string)
    Código interno del sistema que identifica el error.
    Example: "E201"

  - `Error.Type` (string)
    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"

  - `Error.Description` (string)
    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."

  - `LifeSpan` (string,null, required)
    en operaciones síncronas.

## Response 202 fields (application/json):

  - `OperationId` (string, required)
    Identificador único de la operación.
    Example: "6baf6c19-e485-463b-ae24-a821b025c8a4"

  - `Status` (string, required)
    Estado de la operación. Cuando se realizan solicitudes asíncronas, siempre devolverá .
    Example: "OK"

  - `Data` (object, required)
    en operaciones asíncronas.

  - `AdditionalInformation` (string, required)
    Mensaje de la operación, puede ser utilizado para mostrar información adicional.
    Example: "Los datos serán enviados a la URL de callback."

  - `Error` (object, required)
    en operaciones asíncronas.

  - `LifeSpan` (string, required)
    Fecha máxima estimada de entrega para solicitudes asíncronas, en formato de fecha ISO 8601, UTC.
    Example: "2017-07-22T00:00:00-0400"