> ## 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.

# İşlem Geçmişi

> Bir işlemin yaşam döngüsündeki tüm durum geçişlerinin kronolojik kaydı.

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

```http theme={null}
GET /api/v1/transactions/{id}/histories
```

`id` parametresi UUID formatındadır — `transaction_id` ile aynıdır.

## İstek

```bash theme={null}
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):

```json theme={null}
[
  {
    "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"
  }
]
```

| Alan                                                                | Açıklama                                                |
| ------------------------------------------------------------------- | ------------------------------------------------------- |
| `previous_status` / `new_status`                                    | Durum geçişi                                            |
| `connector_configuration_id`                                        | Hangi banka konnektörü kullanıldı                       |
| `message`, `error_code`, `error_message`                            | Bu geçişin detayı                                       |
| `provider_transaction_id`, `auth_code`, `host_reference`            | Banka referansları                                      |
| `md_status`, `cavv`, `eci`, `xid`, `md`, `three_ds_server_trans_id` | 3DS verifikasyon detayları                              |
| `provider_raw_response`                                             | Bankadan dönen ham yanıt (XML/JSON) — debug için kritik |
| `operation_amount`                                                  | Bu adımda işlenen tutar (kuruş)                         |
| `created`                                                           | Adı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](/resources/support) ulaşın.

## Hata response'ları

| HTTP  | `code`              | Anlam            |
| ----- | ------------------- | ---------------- |
| `404` | `payment_not_found` | İşlem bulunamadı |
| `403` | `forbidden`         | Yetki yok        |