Analytics

Los endpoints de Analytics te dan acceso programático a todo tu historial de transacciones. Úsalos para armar reportes de conciliación, monitorear la actividad transaccional o alimentar tus propios dashboards.

Cómo funciona

Ambos endpoints devuelven una lista paginada de transacciones filtrada por cualquier combinación de parámetros de query. Las transacciones se devuelven en orden descendente (primero las más recientes).

Versión	Endpoint	Notas
v2 (recomendada)	`GET /analytics/v2/transactions-list`	Admite transacciones presenciales y no presenciales, pay-ins, pay-outs y filtrado por `external_reference_id`.

Parámetros de query principales

Parámetro	Descripción
`from`	Inicio del rango de fechas (ISO 8601 o Unix timestamp).
`to`	Fin del rango de fechas.
`payment_method`	Filtra por `CARD`, `CASH` o `TRANSFER`.
`currency_code`	Filtra por moneda (`PEN` o `USD`).
`transaction_status`	Filtra por estado (por ejemplo, `APPROVAL`, `DECLINED`).
`transaction_type`	`SALE`, `PREAUTHORIZATION`, `CAPTURE`, `VOID`, `REFUND`, `DEFERRED`.
`ticket_number`	Busca una transacción específica por su número de ticket.
`transaction_id`	Busca una transacción específica por su ID.
`subscription_id`	Filtra todos los cargos de una suscripción.
`merchant_id`	Filtra por ID de comercio (para modelos aggregator).
`limit`	Cantidad de resultados por página.
`offset`	Desplazamiento de paginación.
`external_reference_id`	Filtra por tu propio ID de referencia de la transacción.
`sync_mode`	`api` o `file`: filtra según cómo se inició la transacción.

Monedas

Perú admite PEN (Soles) y USD.

Tipos de documento

Cuando los datos de contacto aparecen en los registros de transacciones:

Valor	Descripción
`DNI`	Documento Nacional de Identidad 🇵🇪
`CE`	Carné de Extranjería 🇵🇪
`PAS`	Pasaporte 🇵🇪
`RUC`	Registro Único de Contribuyentes 🇵🇪

Autenticación

Ambos endpoints requieren tu Private Key:

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Listar transacciones v2

Obtén una lista paginada de transacciones con soporte para transacciones presenciales y no presenciales, pay-ins, pay-outs y filtrado por referencia externa. Recomendado para todas las integraciones nuevas.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.

Cómo funciona#

Parámetros de query principales#

Monedas#

Tipos de documento#

Autenticación#

Uso de la API#