Skip to main content
İşlemlerinizi tarih aralığı, durum, merchant, kart bilgisi gibi kriterlere göre filtreleyip sayfalı şekilde listeleyin. Bu endpoint özet kayıtlar döner — tam detay için tek bir kaydı Ödeme Detayı endpoint’iyle açın.

​
Endpoint

GET /api/v1/transactions

​
Sorgu parametreleri

Tüm parametreler snake_case’dir.
ParametreTipAçıklama
pageintSayfa numarası (varsayılan 1)
page_sizeintSayfa başı kayıt (1–100, varsayılan 20)
start_date, end_datedatetimeTarih aralığı (UTC, ISO 8601) — t.created üzerinde filtreler
statusenumcreated, processing, three_d_secure_init_processing, three_d_secure_auth_processing, authorized, capture_processing, completed, refund_processing, refunded, canceled_processing, canceled, failed
operation_typeenumsale, pre_auth, post_auth, void, refund, recurring
payment_typeenumnon_3d, three_d_secure, three_d_pay, three_d_pay_hosting
secure_typeenum3D modu detayı
card_schema_typeenumvisa, mastercard, troy, amex
card_typeenumcredit, debit, prepaid
installment_countintTaksit sayısı
bin_numberstringİlk 1–6 hane (BIN prefix)
min_amount, max_amountint (kuruş)Tutar aralığı
merchant_idUUIDInternal merchant filtresi
external_merchant_idstringMüşteri-tanımlı merchant kimliği ile filtre
basket_idstringSepet kimliği
connector_codestringKonnektör kodu (örn. nestpay, halkbankvpos)
connector_configuration_idUUIDKonnektör konfigürasyonu
search_termstringid, basket_id, external_id, masked kart üzerinde “içerir” araması (max 200 karakter)

​
İstek

curl "https://vpos.payven.com.tr/api/v1/transactions?start_date=2026-05-01T00:00:00Z&end_date=2026-05-31T23:59:59Z&status=completed&page_size=50" \
  -H "Authorization: Bearer $PAYVEN_TOKEN"

​
Yanıt

Standart sayfalı liste yapısı: 
{
  "items": [
    {
      "id":                          "8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6",
      "merchant_id":                 "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "external_merchant_id":        "M-IST-001",
      "merchant_name":               "Acme Mağaza",
      "external_id":                 "ORDER-1001",
      "basket_id":                   "BASKET-2026-001",
      "amount":                      15000,
      "net_amount":                  10000,
      "currency":                    "TRY",
      "status":                      "completed",
      "operation_type":              "sale",
      "payment_type":                "three_d_secure",
      "bin_number":                  454671,
      "last4":                       "7894",
      "card_holder_name":            "Test Kullanici",
      "masked_card_number":          "454671******7894",
      "card_schema_type":            "visa",
      "card_brand":                  "bonus",
      "card_type":                   "credit",
      "issuer_bank_code":            "GARANTI",
      "issuer_bank_name":            "Garanti BBVA",
      "issuer_bank_logo_url":        "https://cdn.payven.com.tr/banks/garanti.svg",
      "is_3d_secure":                true,
      "secure_type":                 "three_d_secure",
      "installment_count":           3,
      "created":                     "2026-05-03T12:34:56.789+00:00",
      "completed_at":                "2026-05-03T12:34:58.123+00:00",
      "error_message":               null,
      "connector_configuration_id":  "abc123-...",
      "connector_configuration_name":"Garanti VPOS Production",
      "connector_code":              "garanti",
      "installment_amount":          5000,
      "bank_commission_amount":      150,
      "merchant_commission_amount":  100,
      "net_merchant_amount":         14750,
      "settlement_date":             "2026-05-04T00:00:00.000+00:00",
      "bank_response_code":          "00",
      "md_status":                   "y",
      "provider_transaction_id":     "9f3d2b8e-...",
      "auth_code":                   "123456",
      "host_reference":              "PAYVEN-REF-789",
      "rrn":                         "PAYVEN-REF-789",
      "extra_properties":            { }
    }
  ],
  "page":               1,
  "total_pages":        25,
  "total_count":        1247,
  "has_previous_page":  false,
  "has_next_page":      true
}
Sayfalama detayı: API Response Formatı.
Liste yanıtında card_holder_name, masked_card_number gibi PII alanlar dönebilir ama tam kart numarası, CVV asla dönmez. Production ekranlarında bu alanları loglayıp loglara yazmamaya dikkat edin.

​
Tek bir işlemin detayı

Listedeki bir kaydın id değerini kullanarak detay endpoint’ine gidin: 
curl https://vpos.payven.com.tr/api/v1/transactions/8e3f5c12-... \
  -H "Authorization: Bearer $PAYVEN_TOKEN"
Detay yanıtında ek olarak ip_address, cavv, eci, xid, md, three_ds_server_trans_id, provider_raw_request, provider_raw_response gibi alanlar bulunur.

​
Geçmiş timeline’ı

Bir işlemin durum geçiş geçmişi için: İşlem Geçmişi.

​
Export

Programatik export hâlâ konsoldan yapılır — Konsol → İşlemler ekranından CSV/XLSX indirme aktiftir. Public bir /transactions/export endpoint’i yol haritasındadır.

​
Hata response’ları

HTTPcodeAnlam
400validation_failedParametre formatı geçersiz (örn. tarih, BIN)
403forbiddenYetki yok
422validation_failedTutar aralığı hatalı (min_amount > max_amount)