Transactions

March 18, 2025

Get a list of your transactions with helpful information for your operation. Apply filters for better results.

This service is available for integrations via Cloud terminal API, App-to-app, Terminal SDK and Raw card-present API.

Environments

Make any adjustments to your system by testing in a dev development environment. Remember that no real transactions will be processed in this environment.

When ready, you can switch to the live environment to process real transactions.

Cloud terminal API, App to app and Terminal SDK

Token

It is necessary to generate an application token through the Get token endpoint to request the API. If the request is correct, you will obtain the application token, which you must use when obtaining the transaction list.

Token request example:

{
  "token": "48d8fc2257eb61d4814e9cae3fd7385dfedf51133017b35f7a86d113620da413"
}

Response example:

{
  "token": "eyJhbGciOiJIUzI1NiIsInC5cCI6LppXVCJ9.eyJ1c2VyX3Rva2VuIjoiNDhkOGZjMjI1N2VjNjFkNDgzNGU5Y2FlM2ZkNzM4NgRmXWRmNTExOTQ8MTdiMzVmN2E4NmQxMTM2MjBkYTQxMyIsImlhdCI6MTY5NDQ3Mjc2NywiZXhwIjoxNak0NDb2Mzs3fQ.KWgOEItUQhjWQR1gp8-lU1CjugQCVRMd4_lHXGGkDac"
}

Please review the api reference for more information.

Transaction list

Get the list of transactions in a specific date range. By default, 100 items are returned per request but you can configure up to a maximum of 600 items per request. Transactions are ordered by most recent first.

There are 4 diferent versions of the Get transaction list service. Each of which has more response parameters and filters than their previous versions

Please review the Transactions reference for more information.

Raw card-present API

Transaction list

Get the list of transactions by setting the number of items to return and the results page (if there are multiple). Maximum 10,000 results returned per request.

Consume the Transaction Search endpoint by sending your private key in the Private-Credential-Id header and setting the necessary filters in the request body.

Discover all the filters you can set when sending a request to obtain the list of transactions.

Example of request with filters:

{
  "page": 1,
  "size": 10,
  "filters": {
    "bin": "541333",
    "end_date": 1712322035152,
    "start_date": 1712286000000,
    "last_four_digits": "0653",
    "transaction_type": "preAuth",
    "client_transaction_id": "5bba557f-3df8-4f07-be20-ed1ad6b28c1d",
    "transaction_reference": "62c64ab2-1b09-48bd-ab98-4fa9b1893250"
  }
}

Response

If the information submitted is correct and there are transactions in the specified range, you will receive an item with the list of available transactions:

{
  "items": [
    {
      "amount": {
        "extra_taxes": {}
      },
      "deferred": {},
      "merchant_id": "20000000106781760000",
      "pos_details": {},
      "reading_type": "ICC",
      "payment_brand": "VISA",
      "transaction_type": "PREAUTH",
      "transaction_status": "DECLINED",
      "transaction_reference": "Test_Webhook_PREAUTH_D"
    }
  ]
}

Please review the Transactions reference for more information.