1. Oluştur (Sistem Seviyesi)

Tüm cüzdan yönetiminize, sistem genelinde tüm cüzdan sahiplerine ve cüzdanlarına uygulanacak komisyon oluşturma işlemini bu servisle oluşturabilirsiniz.

Sistem Genelinde Komisyon Oluştur

POST{{WalletUrl}}/api/v1/commission/by/merchant

Not: Bu servisin kullanılabilmesi için apikeypublic ve apiclientpublic parametrelerinin Header alanına eklenmiş olması zorunludur.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Servise erişim için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	Uygulamanın kimliğini temsil eden genel erişim anahtarıdır.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
TransactionType	integer	Evet	Komisyonun uygulanacağı işlem tipi
FeeType	integer	Evet	Komisyon ücret tipi. 1 = Fixed (Sabit tutar), 2 = Percentage (Yüzde)
FeeValue	decimal	Evet	Komisyon değeri. FeeType = Fixed ise sabit tutar, Percentage ise yüzde değeri. 0 ile 1000 arasında olmalıdır
CurrencyCode	string	Evet	Komisyonun geçerli olduğu para birimi kodu. 3 karakter olmalıdır.
ConditionType	integer	Hayır	Komisyonun uygulanma koşulu tipi
ConditionThreshold	decimal	Evet	Komisyon koşulunun eşik değeri. Sıfır veya sıfırdan büyük olmalıdır

İş Kuralları

• CurrencyCode sistemde tanımlı ve geçerli bir para birimine karşılık gelmelidir.

• Aynı TransactionType ve CurrencyCode kombinasyonu için yalnızca bir komisyon tanımı oluşturulabilir. Bu kombinasyon için mevcut bir kayıt varsa yeni kayıt oluşturulamaz.

• ConditionType değeri None dışında seçildiğinde ConditionThreshold alanı koşul eşik değeri olarak kullanılır.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

JSON

{
    "TransactionType": 1,
    "FeeType": 1,
    "FeeValue": 12.00,
    "CurrencyCode": "TRY",
    "ConditionType": 1,
    "ConditionThreshold": 1.00
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	İşlemin başarısız olup olmadığını belirtir. true ise hata olmuştur.
IsSuccess	bool	İşlemin başarılı olup olmadığını belirtir. true ise başarıyla tamamlanmıştır.
Errors	Array	Oluşan hata/hatalar varsa detaylarını içeren dizi.
Value	Array	Başarılı yanıt durumunda dönen asıl veri içeriğini barındırır.
Id	Guid	Komisyona ait benzersiz kimlik numarası.
Level	string	Komisyon seviyesi Bkz: Komisyon Seviyeleri
MerchantId	int	Üye işyeri (sizin) Paywall kimlik bilginiz
TransactionType	string	Komisyonun alınacağı işlemin tipi Bkz: İşlem Tipleri
FeeType	string	Komisyonun alınacağı tip bilgisi Bkz: Maliyet Tipleri
FeeValue	decimal	Komisyon maliyetinin değeri
ConditionType	string	Komisyonun koşul tipi Bkz: Koşul Tipleri
ConditionThreshold	decimal	Komisyonun koşul değeri
CurrencyCode	string	Komisyonun uygulanacağı para birimi
IsActive	bool	Komisyonun aktiflik durumu
CreatedAt	DateTime	Kaydın oluşturulma tarihi
UpdatedAt	DateTime	Kaydın güncellenme tarihi

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "ff99509c-8f41-4adf-bd43-fdfffa4c6e12",
        "Level": "Merchant",
        "TransactionType": "Withdrawal",
        "FeeType": "Fixed",
        "FeeValue": 12,
        "ConditionType": "TransactionCount",
        "ConditionThreshold": 1,
        "CurrencyCode": "EUR",
        "IsActive": true,
        "CreatedAt": "2025-08-20T15:10:30.0603275Z",
        "UpdatedAt": null
    }
}