Consultar transacciones
WARNING
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 (por ejemplo, "charge", "preAuth", "refund"). |
Respuesta
items con un objeto por transacción.{
"items": [
{
"ticket_number": "111727462978861299",
"transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250",
"client_transaction_id": "61659d20-311c-4363-991d-7cdd73d36062",
"transaction_status": "APPROVED",
"transaction_type": "charge",
"payment_brand": "VISA",
"bin_card": "403338",
"last_four_digits": "6782",
"masked_credit_card": "403338XXXXXX6782",
"approved_transaction_amount": 231,
"amount": {
"currency": "PEN",
"subtotal_iva": 0,
"subtotal_iva0": 231,
"iva": 0,
"tip": 0
},
"approval_code": "123456",
"created": 1727462978861,
"country": "Peru",
"merchant_id": "20000000107334554000",
"merchant_name": "Mi Comercio Perú"
}
]
}Campos de cada elemento de la respuesta
| Campo | Descripción |
|---|---|
ticket_number | Número de ticket único asignado por Kushki. |
transaction_id | Identificador interno de la transacción. |
transaction_reference | Referencia de la transacción visible para el comercio. |
client_transaction_id | UUID entregado por el comercio al momento de la transacción. |
approval_code | Código de autorización del emisor. |
| Campo | Descripción |
|---|---|
transaction_status | APPROVED, DECLINED, VOIDED o REFUNDED. |
transaction_type | Tipo de la transacción. |
payment_method | Medio de pago (por ejemplo, "card"). |
payment_brand | Marca de la tarjeta (por ejemplo, "VISA", "MASTERCARD"). |
created | Timestamp de creación de la transacción (Unix ms). |
country | País donde se procesó la transacción. |
mcc | Código de categoría del comercio. |
| Campo | Descripción |
|---|---|
bin_card | Primeros 6–8 dígitos de la tarjeta. |
last_four_digits | Últimos 4 dígitos de la tarjeta. |
masked_credit_card | Número de tarjeta enmascarado. |
card_country | Código ISO del país emisor de la tarjeta. |
foreign_card | true si la tarjeta se emitió fuera de Perú. |
issuing_bank | Nombre del banco emisor de la tarjeta. |
acquirer_bank | Nombre del banco adquirente. |
| Campo | Descripción |
|---|---|
request_amount | Monto solicitado originalmente. |
approved_transaction_amount | Monto realmente aprobado. |
amount | Objeto con el desglose completo del monto (moneda, subtotales, IGV, propina). |
| Campo | Descripción |
|---|---|
merchant_id | Identificador del comercio. |
merchant_name | Nombre visible del comercio. |
metadata | Metadatos adicionales asociados a la transacción. |
Autenticación
Usar la API
🟢 Producción
🧪 Sandbox (UAT)
https://api.kushkipagos.com/Endpoints disponibles
¿Tienes una sugerencia sobre esta documentación? Escríbenos.
Modified at 2026-09-11 14:41:18