Query Transactions - Kushki Developer Portal

El endpoint de Query Transactions te permite obtener una lista paginada de las transacciones procesadas en tus terminales POS en Chile. Aplica filtros para acotar los resultados por rango de fechas, BIN, dígitos de la tarjeta o referencia de la transacción.

WARNING

Devuelve un máximo de 10.000 transacciones por consulta.

Cómo funciona

POST /pos-analytics/v1/transactions/search — envía los parámetros de paginación y, opcionalmente, un objeto filters.

{
  "page": 1,
  "size": 10,
  "filters": {
    "start_date": 1712286000000,
    "end_date": 1712322035152,
    "transaction_type": "charge"
  }
}

Campos del request

Campo	Obligatorio	Descripción
`page`	Sí	Número de página. Empieza en `1`.
`size`	Sí	Registros por página. Máximo 500.
`filters`	No	Objeto de filtros opcional — ver más abajo.

`filters`

Campo	Tipo	Descripción
`start_date`	integer	Inicio de la ventana de búsqueda (timestamp Unix en ms).
`end_date`	integer	Fin de la ventana de búsqueda (timestamp Unix en ms).
`bin`	string	Primeros 6–8 dígitos de la tarjeta.
`last_four_digits`	string	Últimos 4 dígitos de la tarjeta.
`client_transaction_id`	string	UUID de la transacción generado por el comercio.
`transaction_reference`	string	Referencia de la transacción de Kushki.
`transaction_type`	string	Tipo de transacción: `capture`, `charge`, `checkIn`, `checkout`, `preAuth`, `reAuthorization`, `tip` o `posTip`.

Respuesta

Devuelve un array items con un objeto por transacción.

{
  "items": [
    {
      "transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250",
      "ticket_number": "111727462978861299",
      "transaction_date": "2026-05-15T14:32:10.000Z",
      "amount": {
        "currency": "CLP",
        "subtotal_iva": 0,
        "subtotal_iva0": 10000,
        "iva": 0,
        "tip": 0,
        "extra_taxes": {
          "iac": 0
        }
      },
      "card_mask": "438102XXXXXX4321",
      "transaction_status": "APPROVAL",
      "reference_number": "654321",
      "authorization_code": "654321",
      "transaction_type": "charge",
      "transaction_mode": "Authorization",
      "payment_brand": "VISA",
      "merchant_id": "20000000109815430000",
      "reading_type": "ICC"
    }
  ]
}

Campos de cada elemento de la respuesta

Identificación de la transacción

Campo	Descripción
`transaction_reference`	ID único por transacción generado por Kushki.
`ticket_number`	Número de ticket único asignado por Kushki.
`transaction_date`	Fecha de creación de la transacción.
`reference_number`	Número de referencia devuelto por el procesador.
`trance_audit_number`	Número de auditoría de traza (TRACE/TAN) del procesador.
`authorization_code`	Código de autorización del emisor.

Detalles de la transacción

Campo	Descripción
`transaction_status`	`APPROVAL` o `DECLINED`.
`transaction_type`	Tipo de la transacción — revisa los valores de `filters.transaction_type` de arriba.
`transaction_mode`	`Authorization`, `Void` o `Reverse`.
`payment_brand`	Marca de la tarjeta (por ejemplo, `"VISA"`, `"MASTERCARD"`).
`reading_type`	`ICC`, `MCR` o `NFC`.

Tarjeta y monto

Campo	Descripción
`card_mask`	Número enmascarado de la tarjeta usada.
`amount`	Desglose del monto: `currency`, `subtotal_iva`, `subtotal_iva0`, `iva`, `tip`, `extra_taxes`.
`deferred`	Detalles del diferido, si la transacción fue diferida: `credit_type`, `grace_month`, `months`.

Comercio

Campo	Descripción
`merchant_id`	Identificador del comercio.

Autenticación

Entornos

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consultar transacciones

Pagina las transacciones de terminales POS con filtros opcionales por fecha, BIN, dígitos de la tarjeta o referencia de la transacción.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Consultar transacciones

Cómo funciona#

Campos del request#

filters#

Respuesta#

Campos de cada elemento de la respuesta#

Autenticación#

Entornos#

Endpoints disponibles#

Cómo funciona

Campos del request

`filters`

Respuesta

Campos de cada elemento de la respuesta

Autenticación

Entornos

Endpoints disponibles