Consultar listado de transacciones v4
https://api-uat.kushkipagos.com
https://api-uat.kushkipagos.com
GET
/api/v4/transactions
Ordenado de más reciente a más antiguo
Solo se devuelven transacciones con más de 60 segundos de antigüedad.
Filtros
| PROPIEDAD | DESCRIPCIÓN | VALORES PERMITIDOS | EJEMPLO |
|---|---|---|---|
| dateFrom | Busca transacciones desde una fecha específica. Formato yyyy-mm-ddthh:mm:ss. | 2022-01-11T10:20:00 | |
| dateTo | Busca transacciones hasta una fecha específica. Formato yyyy-mm-ddthh:mm:ss. | 2023-06-20T11:59:00 | |
| bin | Filtra por número de BIN. | 557908 | |
| captureMethod | Filtra por método de captura. | ec, emvf, nfc, msc, key, rec | ec |
| card | Filtra por número de tarjeta enmascarado. | 310583******5037 | |
| device | Filtra por nombre del dispositivo. | test | |
| page | Indica el número de página de los resultados. | 5 | |
| size | Número de transacciones a devolver. Por defecto: 100. Máximo: 600. | 150 | |
| timezone | Indica el desplazamiento de zona horaria respecto al tiempo universal coordinado (UTC). El valor debe estar en el rango de -12:59 a +14:59, con el formato ±HH:MM. | -05:00 (hora estándar del Este - EST) | |
| transactionStatus | Filtra por estado de la transacción. | aprobada, pendiente, rechazadaRiesgo, rechazada, rechazadaProsa | aprobada |
| transactionType | Filtra por tipo de transacción. | venta, devolucion, checkout | checkout |
| transactionId | Filtra por ID de la transacción. | TRX1234 | |
| reference | Filtra por referencia de la transacción. | reference123 | |
| uniqueReference | Filtra por el identificador único por transacción generado del lado del cliente para evitar duplicados. Por ejemplo, un UUID. | b9e46dbc-a79a-44e4-bfba-b0ed62b01788 |
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v4/transactions?dateFrom=undefined&dateTo=undefined&bin=undefined&captureMethod=undefined&card=undefined&device=undefined&page=undefined&size=undefined&transactionStatus=undefined&transactionType=undefined&transactionId=undefined&reference=undefined&uniqueReference=undefined&timezone=undefined' \
--header 'Authorization;'Response Response Example
200 - List of transactions
{
"data": [
{
"transactionId": 236671358,
"authorizationNumber": "N/D",
"bank": null,
"cardBrand": "MasterCard",
"cardType": null,
"captureMethod": "nfc",
"fee": 0.35,
"chargeback": false,
"date": "2024-12-24T10:54:28-05:00",
"details": null,
"device": "iDevPad",
"errorDetail": "",
"maskedCard": "526777******1923",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 9.59,
"msiFee": 0,
"tip": 0,
"totalAmount": 10,
"transactionType": "devolucion",
"transactionStatus": "aprobada",
"vat": 0.06,
"refundedTransactionId": 237371114,
"uniqueReference": ""
},
{
"transactionId": 2347371114,
"authorizationNumber": "218118",
"bank": "NU MEXICO FINANCIERA",
"cardBrand": "MasterCard",
"cardType": "CREDIT",
"captureMethod": "nfc",
"fee": 0.35,
"chargeback": false,
"date": "2024-12-24T10:52:13-05:00",
"details": null,
"device": "iDevPad",
"errorDetail": "",
"maskedCard": "526777******1923",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 9.59,
"msiFee": 0,
"tip": 0,
"totalAmount": 10,
"transactionType": "venta",
"transactionStatus": "aprobada",
"vat": 0.06,
"uniqueReference": ""
},
{
"transactionId": 236599516,
"authorizationNumber": "N/D",
"bank": null,
"cardBrand": "MasterCard",
"cardType": null,
"captureMethod": "nfc",
"fee": 0.35,
"chargeback": false,
"date": "2024-12-20T11:04:26-05:00",
"details": null,
"device": "iDevelop",
"errorDetail": "",
"maskedCard": "545994******3607",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 9.59,
"msiFee": 0,
"tip": 0,
"totalAmount": 10,
"transactionType": "devolucion",
"transactionStatus": "aprobada",
"vat": 0.06,
"refundedTransactionId": 236599140,
"uniqueReference": ""
},
"..... ..... ....."
],
"currentPage": 1,
"perPage": 100,
"total": 29
}Modified at 2026-09-11 15:00:57