Ödeme Yaşam Döngüsü

Her ödemenin bir durumu vardır. Aşağıdaki tablo müşteri-görünür durumları listeler; bu değerler status alanında ve webhook event tiplerinde görünür.

Durumlar

Durum	UI etiketi	Anlam
`initiated`	Oluşturuldu	Kartsız ödeme oluşturuldu; alıcı henüz handoff’a yönlendirilmemiş/3D tamamlanmamış. Karta-bağlı alanlar (`maskedPan`, `cardFamily`, komisyon) bu aşamada `null`.
`capture_pending`	İşlem Doğrulanıyor	Sonuç belirsiz; sistem çözer. Otomatik başarısız sayılmaz.
`captured`	Başarılı	Tahsilat onaylandı.
`failed`	Başarısız	3D reddi veya tahsilat reddi.
`expired`	Süresi Doldu	Ödeme/3D süresi doldu ya da 3D terk edildi.
`voided`	İptal	Aynı işlem günü içinde iptal edildi.
`partially_refunded`	Kısmi İade	Kümülatif iade < satış tutarı.
`refunded`	İade	Kümülatif iade = satış tutarı.

Geçiş özeti

initiated ──► captured ──► (voided | partially_refunded | refunded)
   │              ▲                        │
   │              │                        └► refunded (kalan bakiye de iade edilirse)
   └► capture_pending (belirsiz; sistem çözer)
   │
   ├► failed      (3D ya da tahsilat reddi)
   └► expired     (süre doldu / 3D terk)

İptal ve iadeler İade ve İptal ile başlatılır; sonuç durumu voided, partially_refunded ya da refunded olur. Tek seferde tam tutarlı bir iade captured’dan doğrudan refunded’a geçer — arada partially_refunded görünmez; partially_refunded yalnızca kısmi iadelerde ortaya çıkar ve kalan bakiye de iade edilirse refunded’a ilerler.

Webhook event ↔ durum eşlemesi

Webhook event tipi	Sorguda göreceğiniz durum(lar)
`payment.captured`	`captured`
`payment.failed`	`failed`
`payment.expired`	`expired`
`refund.approved`	`voided`, `partially_refunded` veya `refunded`
`refund.declined`	(ödeme durumu değişmez; iadenin durumu `declined`)

İade/iptal sonuçları refund.approved / refund.declined ile bildirilir; bir refund.approved üç farklı ödeme durumuna yol açabileceği için kesin durumu GET /v1/payments ile öğrenin. Bkz. Webhooks.