Skip to main content
Bir işlemin oluşturulmasından final durumuna kadar gerçekleşen tüm durum geçişlerini ve banka çağrılarının ham yanıtlarını getirir. 3DS aşamaları, retry’lar, capture/refund/void tetiklemeleri burada izlenebilir.

Endpoint

GET /api/v1/transactions/{id}/histories
id parametresi UUID formatındadır — transaction_id ile aynıdır.

İstek

curl https://vpos.payven.com.tr/api/v1/transactions/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6/histories \
  -H "Authorization: Bearer $PAYVEN_TOKEN"

Yanıt

TransactionHistory kayıtlarından oluşan dizi (kronolojik):
[
  {
    "id":                          "h1-...",
    "transaction_id":              "8e3f5c12-...",
    "connector_configuration_id":  "abc123-...",
    "connector_configuration_name":"Garanti VPOS Production",
    "previous_status":             null,
    "new_status":                  "created",
    "message":                     "Ödeme oluşturuldu",
    "error_code":                  null,
    "error_message":               null,
    "provider_transaction_id":     null,
    "auth_code":                   null,
    "host_reference":              null,
    "md_status":                   null,
    "cavv":                        null,
    "eci":                         null,
    "xid":                         null,
    "md":                          null,
    "three_ds_server_trans_id":    null,
    "provider_raw_response":       null,
    "operation_amount":            15000,
    "created":                     "2026-05-03T12:34:56.789+00:00"
  },
  {
    "transaction_id":              "8e3f5c12-...",
    "previous_status":             "created",
    "new_status":                  "three_d_secure_init_processing",
    "message":                     "3D Secure init başlatıldı",
    "provider_raw_response":       "<xml>...</xml>",
    "created":                     "2026-05-03T12:34:57.123+00:00"
  },
  {
    "transaction_id":              "8e3f5c12-...",
    "previous_status":             "three_d_secure_auth_processing",
    "new_status":                  "completed",
    "message":                     "3DS başarılı, otorizasyon onaylandı",
    "auth_code":                   "123456",
    "host_reference":              "PAYVEN-REF-789",
    "md_status":                   "y",
    "cavv":                        "AAAB...",
    "eci":                         "05",
    "provider_raw_response":       "<xml>...</xml>",
    "created":                     "2026-05-03T12:34:58.456+00:00"
  }
]
AlanAçıklama
previous_status / new_statusDurum geçişi
connector_configuration_idHangi banka konnektörü kullanıldı
message, error_code, error_messageBu geçişin detayı
provider_transaction_id, auth_code, host_referenceBanka referansları
md_status, cavv, eci, xid, md, three_ds_server_trans_id3DS verifikasyon detayları
provider_raw_responseBankadan dönen ham yanıt (XML/JSON) — debug için kritik
operation_amountBu adımda işlenen tutar (kuruş)
createdAdımın gerçekleştiği zaman (UTC)

Tipik kullanım

  • Müşteri destek — “ödeme yaptım ama göremiyorum” senaryosunda neyin ne zaman olduğunu görmek
  • Debug — Smart Retry hangi konnektörden hangisine atladı, banka tarafı gerçekten ne dedi
  • Audit — bir işlemin tüm yaşam döngüsünün kalıcı kaydı (PCI-DSS uyum gereği)
Tüm bu bilgiler konsoldaki İşlem Detayı → Timeline sekmesinde görsel olarak da gösterilir.

Veri saklama

İşlem geçmişi kayıtları işlemin saklama süresi boyunca tutulur (varsayılan: 36 ay). Bu süreden sonra otomatik arşivlenir; arşivden talep için destek ekibinize ulaşın.

Hata response’ları

HTTPcodeAnlam
404payment_not_foundİşlem bulunamadı
403forbiddenYetki yok