Transactions

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.

All requests must be made from your back end.

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://valquiria.billpocket.dev	Cloud Terminal API, App to app and Terminal SDK
`dev`	https://api-uat.kushkipagos.com	Raw Card-Present API
`live`	https://valquiria.billpocket.com	Cloud Terminal API, App to app y Terminal SDK
`live`	https://api.kushkipagos.com	Raw Card-Present API

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 expiration: 6 hours.

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.

Only transactions older than 60 seconds are returned.

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.

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.

Cancel payments

Cancel a previously authorized payment.

Explore this section

Cancel paymentsRefunds, voids and reversalsRead article →

Environments#

Cloud terminal API, App to app and Terminal SDK#

Token#

Transaction list#

Raw card-present API#

Transaction list#

Response#

Explore this section#

Environments

Cloud terminal API, App to app and Terminal SDK

Token

Transaction list

Raw card-present API

Transaction list

Response

Explore this section