🔃 İade İşlemi

POST /api/cardPayment/refund

Bu endpoint, daha önce başarılı bir şekilde gerçekleşmiş bir ödemenin tamamının ya da belirtilen tutar kadar kısmının iadesini gerçekleştirmek için kullanılır.

🧾 Örnek Request

curl https://sandbox-pgw.klogs.io/api/cardPayment/refund \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer API_KEY' \
  --data '{
    "referenceCode": "abc123",
    "amount": 1.0
}'

💡 referenceCode parametresi, iadesi yapılacak işlemin referans kodunu temsil eder. Bu kod, ödeme işlemi tamamlandığında API tarafından döndürülür. 💡 amount, iade edilmek istenen tutarı temsil eder. Eğer tam iade yapılacaksa işlem tutarı kadar gönderilmelidir.

---

📝 Body Parametreleri

Parametre	Tipi	Gerekli	Açıklama
referenceCode	string	✅	İadesi yapılacak işlemin referans kodu
amount	number (double)	✅	İade edilecek tutar (₺ cinsinden)

---

✅ Başarılı Yanıt

HTTP Kod	Anlamı	Açıklama
200	OK	İade işlemi başarıyla gerçekleşti.

🔐 Güvenlik Notu: Bu endpoint’e erişim için geçerli bir Bearer Token gereklidir. Test ortamı için Klogs Test Paneli üzerinden token alabilirsiniz.

---

🧩 JSON Şema: RefundRequest

{
  "referenceCode": "abc123",
  "amount": 0.1
}

---

⚠️ Önemli Notlar

• Bu endpoint yalnızca başarılı olmuş işlemler için kullanılabilir.
• amount alanı, işlemin kalan tutarından fazla olamaz. Aksi takdirde hata mesajı döner.
• Bir işlemin birden fazla kez kısmi iadesi yapılabilir; ancak toplam iade tutarı, orijinal işlem tutarını aşamaz.
• Geliştirme ve test işlemleri için sandbox ortamı kullanılmalıdır.