Get transaction list v4
GET
/api/v4/transactions
Sorted by most recent
Only transactions older than 60 seconds are returned.
Filters
| PROPERTY | DESCRIPTION | ALLOWED VALUES | EXAMPLE |
|---|---|---|---|
| dateFrom | Find transactions from a specific date. yyyy-mm-ddthh:mm:ss format. | 2022-01-11T10:20:00 | |
| dateTo | Find transactions up to a specific date. yyyy-mm-ddthh:mm:ss format. | 2023-06-20T11:59:00 | |
| bin | Filter by BIN number. | 557908 | |
| captureMethod | Filter by capture method. | ec, emvf, nfc, msc, key, rec | ec |
| card | Filter by masked card number. | 310583******5037 | |
| device | Filter by device name. | test | |
| page | indicates the page number of the results. | 5 | |
| size | Number of transactions to return. Default: 100. Max: 600. | 150 | |
| timezone | Indicates the time zone offset from Coordinated Universal Time (UTC). The value must be in the range of -12:59 to +14:59, following the ±HH:MM format. | -05:00 (Eastern Standard Time - EST) | |
| transactionStatus | Filter by transaction status. | aprobada, pendiente, rechazadaRiesgo, rechazada, rechazadaProsa | aprobada |
| transactionType | Filter by transaction type. | venta, devolucion, checkout | checkout |
| transactionId | Filter by transaction ID. | TRX1234 | |
| reference | Filter by transaction reference. | reference123 | |
| uniqueReference | Filter by unique identifier per transaction generated on the client side to avoid duplicates. For example, UUID. | b9e46dbc-a79a-44e4-bfba-b0ed62b01788 |
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-uat.kushkipagos.com/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-07-10 20:44:41