vellTRDocs
API Referansına Dönİşlemlerİşlemleri Listele

İşlemleri Listele

GET/v1/transactionsRecommended

Keyset sayfalama ve zengin filtrelerle (durum, mağaza, müşteri, tarih aralığı, tutar aralığı) işlemleri listeler.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/transactions\n{sha256(\"\")}")
BaşlıkDeğerAçıklama
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

İstek Parametreleri

AdTürZorunluAçıklama
statusstringİsteğe BağlıFilter by payment status
storeIdstringİsteğe BağlıFilter by store
customerIdstringİsteğe BağlıFilter by customer
fromstringİsteğe BağlıISO 8601 lower bound (createdAt)
tostringİsteğe BağlıISO 8601 upper bound (createdAt)
amountMinintegerİsteğe BağlıMinimum amount (kuruş)
amountMaxintegerİsteğe BağlıMaximum amount (kuruş)
methodstringİsteğe BağlıPayment method: card or qr
limitintegerİsteğe BağlıPage size
cursorstringİsteğe BağlıOpaque keyset cursor

Yanıt Parametreleri

AlanTürÖrnek
itemsarray[…]
items[].idstring"pay_1a2b3c4d5e6f"
items[].storeIdstring"sto_5a6b7c8d"
items[].transactionIdstring"ORDER-2026-001"
items[].statusstring"captured"
items[].amountinteger15000
items[].currencystring"TRY"
items[].refundsCountinteger0
items[].chargebacksCountinteger0
items[].createdAtstring"2026-04-13T10:00:00Z"
nextCursorstring"eyJjcmVhdGVkQXQiOiIyMDI2LTA0LTEzVDEwOjAw…

Yanıt Örneği

JSONYanıt
{
  "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"
}

Durum Kodları

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
GEThttps://api.pay.sandbox.kvell.group
İşlemi Getir→