La Analytics API te permite consultar el historial completo de transacciones de tu cuenta de comercio en México 🇲🇽. Ú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.
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_statusAPPROVAL, DECLINED, INITIALIZEDtransaction_typeSALE, CAPTURE, VOID, DEFERRED, PREAUTHORIZATION, REFUND, REVERSALpayment_methodcard, transfer, cash (solo v2) currency_codeMXNticket_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 bin_cardBIN de la tarjeta (primeros 6 dígitos) card_holder_nameNombre del tarjetahabiente number_of_monthsMeses de diferido (cargos a meses sin intereses, MSI)
Por monto# Parámetro Descripción approved_transaction_amountMonto aprobado en MXN 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" : "APPROVAL" ,
"transaction_type" : "SALE" ,
"payment_method" : "card" ,
"approved_transaction_amount" : 500 ,
"currency_code" : "MXN" ,
"card_type" : "credit" ,
"last_four_digits" : "4242" ,
"card_holder_name" : "Juan García" ,
"created" : 1748476800000
}
]
} Campo Descripción totalCantidad total de registros que coinciden dataArray de objetos de transacción de la página actual createdUnix timestamp en milisegundos
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 . 