La Analytics API te permite consultar el historial completo de transacciones de tu cuenta de comercio en Chile 🇨🇱. Úsala para conciliación, reportería y monitoreo — con filtros de consulta flexibles y resultados paginados. Hay dos versiones disponibles: Versión Endpoint Cobertura v2 GET /analytics/v2/transactions-listTransacciones online y presenciales en un solo endpoint
Usa v2 para reportería unificada
Si tu integración incluye Online Payments y Card Present (POS), usa v2 para consultar todos los tipos de transacción desde un solo endpoint.
v1 quedó obsoleta desde julio de 2025. Usa v2 para todas las integraciones nuevas — ofrece más filtros de búsqueda y campos de respuesta adicionales.
Inicio rápido# GET /analytics/v2/transactions-list?from=2026-05-01T00:00:00&to=2026-05-31T23:59:59&limit=50Parámetro Obligatorio Descripción from✅ Fecha inicial — formato YYYY-MM-DDTHH:MM:SS to✅ Fecha final — formato YYYY-MM-DDTHH:MM:SS limit— Máximo de registros por página. Por defecto: 100 offset— Desplazamiento de página para la paginación
Filtros de consulta# Acota los resultados agregando cualquier combinación de parámetros de query: Por atributos de la transacción# Parámetro Descripción transaction_statusAPPROVED, DECLINED, INITIALIZEDtransaction_typeSALE, CAPTURE, VOID, DEFERRED, PREAUTHORIZATION, REFUND, CHARGEBACK, PAYOUT. Si lo dejas vacío, por defecto solo se devuelven pay-ins — envía PAYOUT para obtener únicamente transacciones pay-outpayment_methodcard, transfer, cashcurrency_codeCLP, UFticket_numberBúsqueda exacta por número de ticket transaction_idID interno de la transacción en Kushki approval_codeCódigo de aprobación del banco response_codeCódigo de respuesta del procesador
Por tarjeta# Parámetro Descripción card_typecredit, debitlast_four_digitsÚltimos 4 dígitos de la tarjeta (solo v1) bin_cardBIN de la tarjeta (primeros 6 dígitos) (solo v1) card_holder_nameNombre del tarjetahabiente number_of_monthsMeses de diferido (cargos diferidos)
Por monto# Parámetro Descripción approved_transaction_amountMonto aprobado en CLP request_amountMonto solicitado subtotal_iva0Subtotal sin IVA subtotal_ivaSubtotal con IVA
Por comercio / procesador# Parámetro Descripción merchant_idFiltra por un ID de comercio específico merchant_nameFiltra por nombre del comercio processor_idIdentificador del procesador processor_nameNombre del procesador subscription_idFiltra por ID de suscripción external_reference_idID de la transacción generado por el comercio (solo v2)
Estructura de la respuesta# {
"total" : 1234 ,
"data" : [
{
"ticket_number" : "319228478889680318" ,
"transaction_id" : "6f16659e-b711-4995-a9ae-161aecbd6521" ,
"transaction_status" : "APPROVED" ,
"transaction_type" : "SALE" ,
"payment_method" : "card" ,
"approved_transaction_amount" : 10000 ,
"currency_code" : "CLP" ,
"card_type" : "credit" ,
"last_four_digits" : "4242" ,
"card_holder_name" : "Catalina Fuentes" ,
"created" : "2026-05-01T10:00:00.000Z"
}
]
} Campo Descripción totalCantidad total de registros que coinciden dataArray de objetos de transacción de la página actual createdFecha en la que se creó la transacción, en formato date-time UTC
Planes de Cuotas Comercio (solo Chile, beta)# Para los planes de Cuotas Comercio, v2 devuelve estos campos adicionales — no los usa ningún otro país: Campo Descripción transaction_sub_typeinstallment (cuota que se está cobrando actualmente) o principal (monto total financiado)principal_amountMonto total financiado bajo el plan de cuotas. Solo está presente cuando transaction_sub_type es installment installment_countNúmero secuencial de la cuota que se está cobrando. Consulta number_of_months para ver el total de cuotas principal_ticket_codeticket_number de la transacción principal que originó el plan de cuotas
Paginación# Usa limit y offset para recorrer por páginas conjuntos de resultados grandes: GET /analytics/v2/transactions-list
?from=2026-05-01T00:00:00
&to=2026-05-31T23:59:59
&limit=100
&offset=100limit: registros por página (por defecto 100)
offset: índice del registro inicial (empieza en 0)
total en la respuesta te indica la cantidad total de registros que coinciden
Autenticación# Uso de la API# https://api.kushkipagos.com/Endpoints disponibles#
Listar transacciones v2
Consulta unificada de transacciones online y presenciales. Recomendada para todas las integraciones nuevas. ¿Tienes una sugerencia sobre esta documentación? Contáctanos . 