API Reference TransactionsList Transactions

List Transactions

GET/v1/transactionsRecommended

List transactions with keyset pagination and rich filters (status, store, customer, date range, amount range).

Authentication

Signature Pattern

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/transactions\n{sha256(\"\")}")

Header	Value	Description
`X-Api-Key`	pk_live_a1b2c3d4e5f6g7h8	Merchant public API key
`X-Signature`	{hmac_sha256_hex}	Hex HMAC-SHA256 request signature
`X-Timestamp`	2026-04-13T10:00:00Z	ISO 8601 UTC request time (±5 min)

Request Parameters

Name	Type	Required	Description
`status`	string	Optional	Filter by payment status
`storeId`	string	Optional	Filter by store
`customerId`	string	Optional	Filter by customer
`from`	string	Optional	ISO 8601 lower bound (createdAt)
`to`	string	Optional	ISO 8601 upper bound (createdAt)
`amountMin`	integer	Optional	Minimum amount (kuruş)
`amountMax`	integer	Optional	Maximum amount (kuruş)
`method`	string	Optional	Payment method: card or qr
`limit`	integer	Optional	Page size
`cursor`	string	Optional	Opaque keyset cursor

Response Parameters

Field	Type	Example
`items`	array	[…]
`items[].id`	string	"pay_1a2b3c4d5e6f"
`items[].storeId`	string	"sto_5a6b7c8d"
`items[].transactionId`	string	"ORDER-2026-001"
`items[].status`	string	"captured"
`items[].amount`	integer	15000
`items[].currency`	string	"TRY"
`items[].refundsCount`	integer	0
`items[].chargebacksCount`	integer	0
`items[].createdAt`	string	"2026-04-13T10:00:00Z"
`nextCursor`	string	"eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTEzVDEwOjAw…

Response Example

JSONResponse

{
  "items": [
    {
      "id": "pay_1a2b3c4d5e6f",
      "storeId": "sto_5a6b7c8d",
      "transactionId": "ORDER-2026-001",
      "status": "captured",
      "amount": 15000,
      "currency": "TRY",
      "refundsCount": 0,
      "chargebacksCount": 0,
      "createdAt": "2026-04-13T10:00:00Z"
    }
  ],
  "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTEzVDEwOjAwOjAwWiJ9"
}

Status Codes

200Success

201Created

400Bad Request

401Unauthorized

404Not Found

429Rate Limited

Try itMock

GEThttps://api.pay.sandbox.kvell.group

Get Transaction→