Skip to content

❌ Ödeme İptali

POST /api/cardPayment/void

Bu endpoint, aynı gün içerisinde yapılan ve henüz gün sonu alınmamış (yani işlenmemiş) başarılı bir kart işlemini iptal etmek için kullanılır.


🧾 Örnek Request

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

💡 referenceCode, iptal edilmek istenen işlemin referans kodudur. Bu kod, ödeme işlemi sırasında API tarafından döndürülür.


📝 Body Parametreleri

ParametreTipiGerekliAçıklama
referenceCodestringİptal edilmek istenen işlemin referans kodu

✅ Başarılı Yanıt

HTTP KodAnlamıAçıklama
200OKİşlem başarıyla iptal edildi.

🔐 Güvenlik Uyarısı: Bu endpoint'e istek gönderebilmek için geçerli bir Bearer Token gereklidir.


🧩 JSON Şema: VoidRequest

json
{
  "referenceCode": "abc123"
}

⚠️ Önemli Notlar

  • Bu işlem yalnızca aynı gün içerisinde ve gün sonu alınmamış işlemler için geçerlidir.
  • Eğer işlem gün sonu (batch close) işlemi sonrası iptal edilmek istenirse, void yerine refund işlemi kullanılmalıdır.
  • referenceCode, ödeme işlemi başarılı olduktan sonra API cevabında yer alan koddur. Aynı kod hem iade hem de iptal işlemlerinde kullanılır.
  • İşlemin başarılı şekilde iptal edilebilmesi için, POS sağlayıcınızın bu işlemi desteklemesi gerekir.