Decline

Genel Bakış

Başka bir KVHS'ten gelen işlemi reddeder. Bu endpoint, originator KVHS tarafından başlatılıp onaylanmış bir işlemi beneficiary KVHS'ın reddetmesi için kullanılır.

İşlem durumlarının tamamı için Transactions sayfasını inceleyin.

Endpoint

POST /v1/transactions/decline

İstek Gövdesi

Parameter	Tür	Gerekli	Açıklama
transactionRef	string	Evet	Benzersiz transaction referans ID
reason	object	Evet	Reddetme nedeni detayları
reason.category	string	Evet	Reddetme nedeni kategorisi
reason.description	string	Evet	Reddetmenin detaylı açıklaması

İstek Örneği

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "reason": {
    "category": "COMPLIANCE_CHECK_FAILED",
    "description": "Beneficiary does not meet compliance requirements"
  }
}

Yaygın Reddetme Kategorileri

Category	Açıklama
COMPLIANCE_CHECK_FAILED	Beneficiary, compliance doğrulamasından geçemedi
INSUFFICIENT_KYC	Yetersiz KYC bilgisi sağlandı
SANCTIONS_MATCH	Beneficiary, yaptırım listesiyle eşleşiyor
POLICY_VIOLATION	İşlem iç politika kurallarını ihlal ediyor
CAPACITY_EXCEEDED	Borsa kapasite limitleri aşıldı
TECHNICAL_ISSUE	İşlenmeyi engelleyen teknik problemler
USER_REQUEST	Kullanıcı işlemin reddedilmesini talep etti
REGULATORY_RESTRICTION	Regülasyon kısıtlamaları kabulü engelliyor

Yanıt

Başarılı Yanıt (200 OK)

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "status": "DECLINED",
  "reason": {
    "category": "COMPLIANCE_CHECK_FAILED",
    "description": "Beneficiary does not meet compliance requirements"
  },
  "message": "Transaction declined successfully"
}

Yanıt Alanları

Alan	Tür	Açıklama
transactionRef	string	Benzersiz transaction referans ID
status	string	Güncellenmiş transaction durumu
reason	object	Reddetme nedeni detayları
message	string	Reddetme onay mesajı

İşlem Akışı

1. Originator KVHS, /v1/transactions/initiate endpoint'ini kullanarak işlemi başlatır
2. Originator KVHS, /v1/transactions/confirm endpoint'ini kullanarak işlemi onaylar
3. Beneficiary KVHS, gelen işlem bildirimi alır
4. Beneficiary KVHS, /v1/transactions/decline endpoint'ini kullanarak işlemi reddeder
5. İşlem sonlandırılır ve originator bilgilendirilir

Notlar

• Bir işlemi yalnızca beneficiary KVHS reddedebilir
• İşlemin reddedilebilmesi için durumu "CONFIRMED" olmalıdır (sadece CONFIRMED statüsündeki işlemlerde kullanılabilir).
• Reddetme gönderildikten sonra geri alınamaz
• Originator KVHS, reddetme ve nedeni hakkında bilgilendirilir
• Reddetme nedenleri, compliance ve denetim amaçları için kaydedilir
• Reddedilen işlemler yeniden işlenemez