Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

İşlemlerinizi tarih aralığı, durum, merchant, kart bilgileri gibi kriterlere göre listeleyin.

​
Endpoint

GET /api/v1/transactions

​
Sorgu parametreleri

ParametreTipAçıklama
from / tostringTarih aralığı (UTC, ISO-8601)
statusenum[]Success, Failed, Pending3D, vb.
currencyenumTRY, USD, EUR, GBP
minAmount / maxAmountintTutar aralığı (kuruş)
cardSchemeenumVisa, Mastercard, Troy, Amex
cardBinstringİlk 6-8 hane
connectorCodestringBelirli bir banka konnektörü
externalIdstringSizin sipariş ID’niz
merchantIduuidBelirli bir merchant
searchTermstringİşlem ID, sipariş ID, kart son 4 hane veya müşteri e-postasında arama
sortByenumcreatedAt, amount
sortDirectionenumasc, desc
pageNumber / pageSizeintSayfalama (max 100)

​
İstek

curl "https://vpos.payven.com.tr/api/v1/transactions?from=2026-05-01T00:00:00Z&to=2026-05-31T23:59:59Z&status=Success&pageSize=50" \
  -H "X-API-Key: $KEY" -H "X-API-Secret: $SECRET" -H "X-Merchant-Id: $MERCHANT"

​
Yanıt

{
  "isSuccess": true,
  "data": {
    "items": [
      {
        "id": "8e3f5c12-...",
        "externalId": "ORDER-1001",
        "status": "Success",
        "amount": 15000,
        "currency": "TRY",
        "card": { "binNumber": "454671", "lastFourDigits": "7894", "scheme": "Visa" },
        "connector": { "code": "GarantiVPOS", "responseCode": "00" },
        "createdAt": "2026-05-03T12:34:56Z"
      }
    ],
    "pageNumber": 1,
    "pageSize": 50,
    "totalCount": 1247,
    "totalPages": 25
  }
}
Yanıttaki kayıtlar özet versiyondur (kart numarası, müşteri detayları yoktur). Tam detay için ilgili id ile Ödeme Detayı endpoint’ini çağırın.

​
Export

Konsol → İşlemler ekranından CSV ve XLSX export yapabilirsiniz. Programatik export için: 
GET /api/v1/transactions/export?format=csv&from=...&to=...
İndirme linki yanıt header’ında Location olarak döner; büyük export’lar asenkron işlenir.