Ana içeriğe geç

Payment Lifecycle

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ı açıklar.

Durum Şeması

Durumlar

DurumAçıklamaSonraki Olası Durumlar
createdSession oluşturuldu, henüz ödeme başlamadıpending
pendingMüşteri ödeme bilgilerini girdi, işlem bekliyorprocessing
processingBanka ödemeyi işliyor (3D Secure dahil)authorized, completed, failed
authorizedÖn provizyon onaylandı, henüz çekim yapılmadıcompleted, voided
completedÖdeme başarıyla tamamlandırefunded, partially_refunded
failedÖdeme başarısız
voidedÖn provizyon iptal edildi
refundedTam iade yapıldı
partially_refundedKısmi iade yapıldırefunded

Session Ömrü

Bir checkout session 1 saat geçerlidir. Bu süre içinde ödeme tamamlanmazsa session otomatik olarak sona erer ve expired durumuna geçer.

Durum Sorgulama

Herhangi bir ödemenin güncel durumunu sorgulamak için:

GET /api/v1/payment/status/{order_id}?session_id=ses_xxx
{
"success": true,
"order_id": "ORD-xxx",
"status": "completed",
"amount": 1000,
"message": "Odeme basarili"
}