Obtén y filtra tu historial completo de transacciones para conciliación, reportería y monitoreo operativo. La Analytics API devuelve resultados paginados con data detallada de las transacciones de todos los métodos de pago.Usa la v2 de la Analytics API. La v1 está deprecada y se eliminará en una versión futura.
Endpoint#
GET https://api.kushkipagos.com/analytics/v2/transactions-list
Autenticación#
Todos los requests requieren tu Private Key de la Kushki Console, enviada como header:| Header | Valor |
|---|
Private-Merchant-Id | Tu API key privada |
Content-Type | application/json |
Parámetros de consulta#
Obligatorios#
| Parámetro | Tipo | Descripción |
|---|
from | string | Inicio del rango de fechas — formato ISO YYYY-MM-DDTHH:MM:SS |
to | string | Fin del rango de fechas — formato ISO YYYY-MM-DDTHH:MM:SS |
Filtros#
| Parámetro | Tipo | Valores permitidos |
|---|
payment_method | string | card, transfer, cash |
transaction_status | string | APPROVAL, DECLINED, INITIALIZED |
transaction_type | string | SALE, CAPTURE, VOID, DEFERRED, PREAUTHORIZATION, REFUND |
card_type | string | debit, credit |
external_reference_id | string | Tu propio ID de orden o referencia (solo en v2) |
Paginación#
| Parámetro | Tipo | Por defecto | Descripción |
|---|
offset | integer | 0 | Número de registros a omitir |
limit | integer | 100 | Número de registros a devolver por página |
Ejemplo de request#
Respuesta#
{
"total": 342,
"data": [
{
"ticket_number": "123456789",
"transaction_id": "1234567890abcdef",
"transaction_reference": "abc123",
"transaction_status": "APPROVAL",
"payment_method": "card",
"transaction_type": "SALE",
"approved_transaction_amount": 25.00,
"currency_code": "USD",
"created": "2024-01-15T14:32:00",
"complete": "2024-01-15T14:32:05",
"card_holder_name": "Jane Doe",
"masked_credit_card": "XXXXXXXXXXXX1234",
"payment_brand": "VISA",
"card_type": "credit",
"issuing_bank": "Banco Pichincha",
"approval_code": "123456",
"response_code": "000",
"external_reference_id": "order-9876",
"contact_details": {
"email": "jane@example.com"
},
"metadata": {}
}
]
}
Campos principales de la respuesta#
| Campo | Descripción |
|---|
total | Número total de transacciones que coinciden con los filtros |
ticket_number | Número de ticket de la transacción asignado por Kushki |
transaction_id | Identificador único de la transacción |
transaction_reference | Referencia visible para el comercio |
transaction_status | APPROVAL, DECLINED o INITIALIZED |
payment_method | card, transfer o cash |
transaction_type | SALE, CAPTURE, VOID, DEFERRED, PREAUTHORIZATION o REFUND |
approved_transaction_amount | Monto aprobado en USD |
currency_code | Siempre USD para Ecuador |
created | Timestamp de creación de la transacción |
complete | Timestamp en que se completó la transacción |
masked_credit_card | Número de tarjeta enmascarado (últimos 4 dígitos visibles) |
payment_brand | Red de la tarjeta — VISA, MASTERCARD, etc. |
card_type | debit o credit |
issuing_bank | Nombre del banco emisor de la tarjeta |
approval_code | Código de aprobación del adquirente |
response_code | Código de respuesta del procesador |
external_reference_id | Tu ID de orden o referencia personalizado (si se envió al momento del cargo) |
Paginación#
Usa offset y limit para paginar conjuntos grandes de resultados. Revisa total en la respuesta para saber cuántas páginas debes solicitar.Page 1: offset=0, limit=100 → records 1–100
Page 2: offset=100, limit=100 → records 101–200
Page 3: offset=200, limit=100 → records 201–300
Requisitos#
Una cuenta de Kushki con la funcionalidad Analytics habilitada
¿Tienes una sugerencia sobre esta documentación? Escríbenos.
