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 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.

Environment	Base Url	Availability
`dev`	https://api-uat.kushkipagos.com	Cloud Terminal API and Raw Card-Present API
`live`	https://api.kushkipagos.com	Cloud Terminal API and Raw Card-Present API

Cloud terminal API and 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.

Property	Required	Allowed values	Description
page	Yes		Set the page number of the results.
size	Yes		Set the number of items returned per request. Maximum 500 items per page.
filters.bin	No		Filter by BIN number.
filters.client_transaction_id	No		Filter by transaction id generated on your side.
filters.start_date	No		Find transactions from a specific date.
filters.end_date	No		Find transactions up to a specific date.
filters.last_four_digits	No		Filter by the last 4 digits of the card.
filters.transaction_reference	No		Filter by transaction id (generated by Kushki).
filters.transaction_type	No	`balanceInquiry`, `capture`, `charge`, `checkIn`, `checkout`, `preAuth`, `reAuthorization`, `tip`, `posTip`	Filter by operation type.

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.

Raw card-present API