Reject

Genel Bakış

Daha önce başlatılmış bir işlemi reddeder. Bu endpoint, originator KVHS işlemi onaylanmadan veya işlenmeden önce reddetmeye karar verdiğinde kullanılır.

Durum makinesi ve alternatif dallar için Transactions sayfasını inceleyin.

Endpoint

POST /v1/transactions/reject

İ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_VIOLATION",
    "description": "Transaction violates AML compliance requirements"
  }
}

Yaygın Reddetme Kategorileri

Category	Açıklama
COMPLIANCE_VIOLATION	İşlem, compliance gereksinimlerini ihlal ediyor
INSUFFICIENT_FUNDS	Originator'ın yeterli bakiyesi yok
INVALID_DESTINATION	Hedef adres geçersiz veya şüpheli
USER_CANCELLATION	Kullanıcı işlemi manuel olarak iptal etti
SYSTEM_ERROR	İşlemi engelleyen teknik hata
REGULATORY_BLOCK	Regülasyon kısıtlamaları işlemi engelliyor

Yanıt

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

{
  "transactionRef": "6f61b14a-60ec-4569-8ba9-b675dae62159",
  "status": "REJECTED",
  "reason": {
    "category": "COMPLIANCE_VIOLATION",
    "description": "Transaction violates AML compliance requirements"
  },
  "message": "Transaction rejected 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ı

Notlar

• Reddetme gönderildikten sonra geri alınamaz
• Beneficiary KVHS reddetmeden haberdar edilir
• Reddetme nedenleri compliance ve denetim amaçları için kaydedilir
• Yalnızca "NEW" veya "PENDING" durumundaki işlemler originator tarafından reddedilebilir (sadece NEW/PENDING statüsündeyken kullanılabilir).