İşlemler

İşlem durumunu sorgulayın, filtreleme ve keyset sayfalama ile listeleyin, defter kayıtlarını inceleyin ve kayıtları dışa aktarın.

7 endpoints

GET/v1/transactionsRecommended

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

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`status`	string	İsteğe Bağlı	Filter by payment status
`storeId`	string	İsteğe Bağlı	Filter by store
`customerId`	string	İsteğe Bağlı	Filter by customer
`from`	string	İsteğe Bağlı	ISO 8601 lower bound (createdAt)
`to`	string	İsteğe Bağlı	ISO 8601 upper bound (createdAt)
`amountMin`	integer	İsteğe Bağlı	Minimum amount (kuruş)
`amountMax`	integer	İsteğe Bağlı	Maximum amount (kuruş)
`method`	string	İsteğe Bağlı	Payment method: card or qr
`limit`	integer	İsteğe Bağlı	Page size
`cursor`	string	İsteğe Bağlı	Opaque keyset cursor

JSONYanıt Örneği

{
  "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"
}

GET/v1/transactions/{id}Recommended

İade ve ters ibraz geçmişini de içeren işlem detayı.

JSONYanıt Örneği

{
  "id": "pay_1a2b3c4d5e6f",
  "storeId": "sto_5a6b7c8d",
  "status": "captured",
  "amount": 15000,
  "currency": "TRY",
  "netAmount": 14551,
  "commission": 449,
  "refunds": [],
  "chargebacks": [],
  "createdAt": "2026-04-13T10:00:00Z"
}

GET/v1/transactions/{id}/ledgerOptional

Bir işlem için oluşturulan, hesap türleriyle ilişkilendirilmiş dengeli çift taraflı defter kayıtları.

JSONYanıt Örneği

{
  "items": [
    {
      "accountType": "buyer_pending",
      "direction": "DEBIT",
      "amount": 15000,
      "currency": "TRY"
    },
    {
      "accountType": "merchant_reserve",
      "direction": "CREDIT",
      "amount": 14551,
      "currency": "TRY"
    },
    {
      "accountType": "platform_commission",
      "direction": "CREDIT",
      "amount": 449,
      "currency": "TRY"
    }
  ]
}

POST/v1/transactions/exportsOptional

Filtrelenmiş işlemlerin PDF veya CSV dışa aktarımını kuyruğa alır. Tamamlanma durumunu dönen exportId üzerinden sorgulayın.

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`format`	string	Zorunlu	"pdf" or "csv"
`filters`	object	İsteğe Bağlı	Same filters as list: {storeId?, status?, from?, to?, amountMin?, amountMax?, customerId?, paymentId?}

JSONİstek Örneği

{
  "format": "csv",
  "filters": {
    "from": "2026-04-01T00:00:00Z",
    "to": "2026-04-30T23:59:59Z",
    "status": "captured"
  }
}

JSONYanıt Örneği

{
  "exportId": "exp_3c4d5e6f7081",
  "status": "queued"
}

GET/v1/transactions/exports/{exportId}Optional

Kuyruğa alınmış bir dışa aktarımın durumunu sorgular.

JSONYanıt Örneği

{
  "exportId": "exp_3c4d5e6f7081",
  "status": "ready",
  "downloadUrl": "/v1/transactions/exports/exp_3c4d5e6f7081/download",
  "rowCount": 128
}

GET/v1/transactions/exports/{exportId}/downloadOptional

Oluşturulan PDF veya CSV dosyasını akış olarak sunar. Dışa aktarım hazır olana kadar 409 döner.

JSONYanıt Örneği

{
  "note": "Streams application/pdf or text/csv; no JSON body."
}

GET/v1/transactions/card-accessOptional

Üye işyeri kapsamındaki card-vault denetim kayıtları (hangi kart token'ının kim tarafından ve ne zaman detokenize edildiği).

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`from`	string	İsteğe Bağlı	ISO 8601 lower bound
`to`	string	İsteğe Bağlı	ISO 8601 upper bound
`limit`	integer	İsteğe Bağlı	Page size
`cursor`	string	İsteğe Bağlı	Opaque keyset cursor

JSONYanıt Örneği

{
  "items": [
    {
      "op": "detokenize",
      "cardToken": "tok_9f8e7d6c5b4a",
      "callerService": "payment-engine",
      "result": "ok",
      "createdAt": "2026-04-13T10:00:01Z"
    }
  ]
}

Kategori Özeti

Toplam Endpoint

Ana Domain

api.pay.kvell.group