Get a list of your transactions with helpful information for your operation. Apply filters for better results.This service is available for integration via Raw card-present API.Product in beta version in Colombia 🔐👨We are working on our beta version. Stay tuned for its official launch! You can also contact your account manager for more information.
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.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 | 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"
}
]
}
Explore this section#
