Get transaction list v3
GET
/api/v3/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 | |
| 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 --request GET '/api/v3/transactions?dateFrom&dateTo&bin&captureMethod&card&device&page&size&transactionStatus&transactionType&transactionId&reference&uniqueReference' \
--header 'Authorization;'Response Response Example
200 - List of transactions
{
"data": [
{
"transactionId": 130001,
"authorizationNumber": "",
"bank": null,
"cardBrand": "Visa",
"cardType": null,
"captureMethod": "msc",
"fee": 0.49,
"chargeback": false,
"date": "2024-07-11T16:53:29.000Z",
"details": null,
"device": "Device 1",
"errorDetail": "",
"maskedCard": "400000******0002",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 13.48,
"msiFee": 0,
"tip": 0,
"totalAmount": 14.05,
"transactionType": "devolucion",
"transactionStatus": "pendiente",
"vat": 0.08,
"uniqueReference": "3740d203-c6fb-46fb-83f5-6b29c9195fa8"
},
{
"transactionId": 130002,
"authorizationNumber": "BP6001",
"bank": null,
"cardBrand": "Visa",
"cardType": "CREDIT",
"captureMethod": "msc",
"fee": 0.49,
"chargeback": false,
"date": "2024-07-11T16:46:18.000Z",
"details": null,
"device": "Device 1",
"errorDetail": "",
"maskedCard": "400000******0002",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 13.48,
"msiFee": 0,
"tip": 0,
"totalAmount": 14.05,
"transactionType": "venta",
"transactionStatus": "aprobada",
"vat": 0.08,
"uniqueReference": "2d20aa4b-a26e-4117-90a0-9b0c0d9a19e1"
},
{
"transactionId": 130003,
"authorizationNumber": "",
"bank": null,
"cardBrand": "Visa",
"cardType": null,
"captureMethod": "ec",
"fee": 3.5,
"chargeback": false,
"date": "2024-07-11T15:09:44.000Z",
"details": null,
"device": "ECOMMDEV00061529",
"errorDetail": "Rechazo por reglas internas",
"maskedCard": "400000******0002",
"msi": null,
"retention": 0,
"responseCode": null,
"finalAmount": 95.94,
"msiFee": 0,
"tip": 0,
"totalAmount": 100,
"transactionType": "devolucion",
"transactionStatus": "rechazada",
"vat": 0.56,
"uniqueReference": ""
}
],
"currentPage": 1,
"perPage": 100,
"total": 31
}Modified at 2026-01-30 00:43:25