İşlem Durumları

Bir ödeme işlemi, oluşturulmasından tamamlanmasına kadar birden fazla durumdan geçer. Bu sayfa, her durumu ve geçiş koşullarını detaylı olarak açıklar.

Durum Makinesi

Durum Detayları

Durum	Açıklama	Final mi?
created	Session oluşturuldu, ödeme henüz başlamadı	Hayır
pending	Müşteri ödeme bilgilerini girdi	Hayır
processing	İşlem bankada işleniyor (3DS dahil)	Hayır
authorized	Ön provizyon onaylandı, capture bekleniyor	Hayır
completed	Ödeme başarıyla tamamlandı	Evet*
failed	Ödeme başarısız	Evet
voided	Authorization iptal edildi	Evet
expired	Session veya authorization süresi doldu	Evet
refunded	Tam iade yapıldı	Evet
partially_refunded	Kısmi iade yapıldı	Hayır

*completed durumundan refunded veya partially_refunded durumuna geçiş mümkündür.

Durum Geçişleri

created → pending

Müşteri ödeme formunda bilgilerini girmeye başladığında.

pending → processing

Ödeme isteği bankaya iletildiğinde.

processing → completed

Banka ödemeyi onayladığında ve doğrudan çekim yapıldığında.

processing → authorized

Banka ön provizyon onayladığında (capture ayrı yapılacak).

processing → failed

Banka ödemeyi reddettiğinde. Nedenleri:

• Yetersiz bakiye
• Geçersiz kart
• 3DS doğrulama başarısız
• Kart engelli

authorized → voided

Merchant, ön provizyonu iptal ettiğinde. Bloke edilen tutar serbest bırakılır.

completed → refunded

Merchant, tam iade yaptığında.

Durum Sorgulama

GET /api/v1/payment/status/{order_id}?session_id=ses_xxx

{
  "success": true,
  "order_id": "ORD-xxx",
  "status": "completed",
  "amount": 15000,
  "currency": "TRY",
  "payment_type": "creditcard"
}