Refunds
Tamamlanmış bir ödemeyi tamamen veya k ısmen iade etmek için kullanılan endpoint'ler.
Tam İade
POST /api/v1/payment/refund
{
"order_id": "ORD-xxx",
"session_id": "ses_xxx"
}
Başarılı Yanıt
{
"success": true,
"order_id": "ORD-xxx",
"refund_id": "REF-xxx",
"status": "refunded",
"amount": 15000,
"message": "Iade basarili"
}
Kısmi İade
amount alanını ekleyerek kısmi iade yapın:
{
"order_id": "ORD-xxx",
"session_id": "ses_xxx",
"amount": 5000
}
Kısmi iade birden fazla kez yapılabilir. Toplam iade, orijinal ödeme tutarını aşamaz.
İade Durumları
| Durum | Açıklama |
|---|---|
refund_pending | İade işlemi başlatıldı, banka onayı bekleniyor |
refunded | İade tamamlandı |
partially_refunded | Kısmi iade yapıldı |
refund_failed | İade başarısız |
Void (İptal)
Henüz capture yapılmamış (authorization aşamasındaki) işlemleri iptal edin:
POST /api/v1/payment/void
{
"order_id": "ORD-xxx",
"session_id": "ses_xxx"
}
Refund vs Void
| İşlem | Ne Zaman? | Sonuç | Süre |
|---|---|---|---|
| Void | Capture öncesi | Bloke kaldırılır | Anında |
| Refund | Capture sonrası | Para iade edilir | 1-10 iş günü |
ipucu
Aynı gün içindeki iptaller için void kullanın. Void işlemi daha hızlıdır ve komisyon kesintisi olmaz.