Skip to main content
Bir ödemenin mevcut durumunu ve banka tarafından dönen detayları çekmek için kullanılır.

​
Endpoint

GET /api/v1/payments/{transaction_id}
transaction_id parametresi UUID formatındadır — POST /payments veya POST /payments/3d/init çağrılarının yanıtında dönen kimlik.

​
İstek

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

​
Yanıt

PaymentStatus (genişletilmiş PaymentOperationResult) döner: 
{
  "transaction_id":      "8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6",
  "status":              "completed",
  "amount":              15000,
  "currency":            "TRY",
  "is_3d_secure":        false,
  "created":             "2026-05-03T12:34:56.789+00:00",
  "basket_id":           "BASKET-2026-001",
  "error_code":          null,
  "provider_error_code": null,
  "extra_properties": {
    "processed_at":            "2026-05-03T12:34:58.123+00:00",
    "auth_code":               "123456",
    "host_reference":          "PAYVEN-REF-789",
    "provider_transaction_id": "9f3d2b8e-..."
  }
}
Tam alan referansı: Payment Objesi.

​
Tipik kullanım

  • 3DS akışı sonrası return_url’de — sunucu tarafında final durumu doğrulamak (URL parametreleri güvenilmez)
  • Webhook gelmemiş bir ödeme için son durumu öğrenmek
  • Müşteri destek talebinde geçmiş bir işlemi incelemek
  • Durum geçişi sonrası (örn. iade, capture) güncel durum sorgusu
Polling kullanmayın. Yüksek hacimli senaryolarda her ödeme için periyodik GET çağrısı yapmayın — bunun yerine webhook entegre edin. Webhook gelmemişse konsoldan Webhook Teslim Logları ekranıyla manuel replay tetikleyebilirsiniz.

​
Hata response’ları

HTTPcodeAnlam
404payment_not_foundVerilen transaction_id bulunamadı veya bu merchant’a ait değil
403forbiddenYetki yok
Hata yanıtı RFC 9457 problem+json formatındadır.

​
Sonraki adımlar

İşlem Listesi

Sayfalı liste + filtreleme.

İşlem Geçmişi

Bir işlemin durum geçişi timeline’ı.