İade & Tekrar

İade ve İptal

Başarılı bir ödemeyi tam veya kısmi iade edin; aynı gün içindeyse iptal (void) edin. İade akışı iki adımlıdır: talep oluşturma ve onay.

1. İade Talebi Oluştur

POST/api/RefundX-Api-Key

Alan	Tip		Açıklama
transactionId	string	zorunlu	Ödemenin referans numarası (paymentReferenceNumber)
amount	decimal	zorunlu	İade tutarı (ödeme tutarını aşamaz)
reason	string	zorunlu	İade nedeni (≤500 karakter)
refundType	string	opt	Full / Partial — varsayılan Full
description	string	opt	Ek açıklama

Talep oluşturulduğunda durum Pending olur ve bir refundId döner.

2. İadeyi Onayla

POST/api/Refund/{id}/approve

Onaylandığında iade bankaya iletilir. Yanıtta banka referansı (bankReferenceNumber) döner. Aynı gün + tam tutar iadeler otomatik olarak iptal (void) olarak işlenir.

Diğer İşlemler

İadeyi reddet	POST /api/Refund/{id}/reject
Kısmi iade (tek adım)	POST /api/Refund/partial
Ödeme iptali (24 saat içinde)	POST /api/Refund/cancellations
İadeleri listele	GET /api/Refund
İade istatistikleri	GET /api/Refund/statistics

Kısmi iade: aynı ödemeye toplam tutarı aşmayacak şekilde birden fazla kısmi iade yapılabilir. Toplam iade ödeme tutarına ulaştığında ödeme tamamen İade durumuna geçer.

Önceki← Taksitler SonrakiTekrarlı Ödemeler →

İade talebi oluştur → onayla

# 1) İade talebi oluştur (Pending)
curl -X POST https://api.yucepay.com/api/Refund \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "transactionId": "PAY-20260819-0001",
    "amount": 149.90,
    "reason": "Müşteri talebi",
    "refundType": "Full"
  }'

# 2) İadeyi onayla (bankaya gönderilir)
curl -X POST https://api.yucepay.com/api/Refund/{refundId}/approve \
  -H "X-Api-Key: pk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "approvalNote": "Onaylandı" }'

// 1) Talep oluştur
var create = new {
    transactionId = "PAY-20260819-0001",
    amount = 149.90m, reason = "Müşteri talebi", refundType = "Full"
};
var r1 = await http.PostAsJsonAsync("https://api.yucepay.com/api/Refund", create);

// 2) Onayla
var r2 = await http.PostAsJsonAsync(
    $"https://api.yucepay.com/api/Refund/{refundId}/approve",
    new { approvalNote = "Onaylandı" });

<?php
// 1) Talep oluştur
$ch = curl_init('https://api.yucepay.com/api/Refund');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ['X-Api-Key: pk_live_xxxxxxxxxxxxxxxx','Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'transactionId' => 'PAY-20260819-0001',
    'amount' => 149.90, 'reason' => 'Müşteri talebi', 'refundType' => 'Full',
  ]),
]);
$response = curl_exec($ch);

// 1) Talep oluştur
const r1 = await fetch('https://api.yucepay.com/api/Refund', {
  method: 'POST',
  headers: { 'X-Api-Key': 'pk_live_xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    transactionId: 'PAY-20260819-0001',
    amount: 149.90, reason: 'Müşteri talebi', refundType: 'Full',
  }),
});
// 2) Onayla
await fetch(`https://api.yucepay.com/api/Refund/${refundId}/approve`, {
  method: 'POST',
  headers: { 'X-Api-Key': 'pk_live_xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({ approvalNote: 'Onaylandı' }),
});

{
  "message": "İade talebi onaylandı ve bankaya gönderildi",
  "refundId": "dd7b4582-577c-4297-b68c-546b3d58667e",
  "amount": 149.90,
  "bankReferenceNumber": "REF-e1d28cb409b3",
  "integrationPending": false
}