1. Oluştur

Yeni bir kayıt eklemek amacıyla bu servis kullanılmalıdır.

Kayıt Oluşturma İşlemi

POST{{WalletUrl}}/api/v1/campaign

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
Name	string	Evet	Kampanyanın adı
Description	string	Evet	Kampanyanın açıklaması
MinimumDepositAmount	decimal	Evet	Kampanyanın geçerli olacağı minimum para yatırma tutarı
MaximumDepositAmount	decimal	Hayır	Kampanyanın geçerli olacağı maksimum para yatırma tutarı. null ise üst limit yoktur
BonusType	integer	Evet	Bonus tipi. 1 = Fixed (Sabit tutar), 2 = Percentage (Yüzde)
BonusValue	decimal	Evet	Bonus değeri. BonusType = Fixed ise sabit tutar, Percentage ise yüzde değeri
CampaignType	integer	Evet	Kampanya tipi. 1 = CashBack, 2 = GiftBalance
RegionId	integer	Evet	Kampanyanın geçerli olduğu bölgenin tanımlayıcısı
CurrencyCode	string	Evet	Kampanyanın geçerli olduğu para birimi kodu
StartDate	dateOnly	Evet	Kampanyanın başlangıç tarihi. Format: YYYY-MM-DD
EndDate	dateOnly	Hayır	Kampanyanın bitiş tarihi. Format: YYYY-MM-DD. null ise kampanyanın bitiş tarihi yoktur

İş Kuralları

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

• Aynı Merchant, Region ve Currency kombinasyonu için aynı kampanya tipinde yalnızca bir aktif kampanya bulunabilir. CashBack ve Bonus tipleri birbirinden bağımsız değerlendirilir.

• BonusType.Fixed ise BonusValue sabit ödül tutarını, BonusType.Percentage ise yüzdesel oranı ifade eder.

• Kampanya başlangıç ve bitiş tarihleri geçmiş bir tarihe ait olamaz. Başlangıç tarihi mevcut gün olabilir.

• Kampanya adı ve tarih alanları sistem doğrulama kurallarına uygun olmalıdır. Geçersiz değerler durumunda işlem reddedilir.

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

JSON

{
    "Name": "External Campaign",
    "Description": "External campaign description",
    "MinimumDepositAmount": 1.00,
    "MaximumDepositAmount": 1000.00,
    "BonusType": 1,
    "BonusValue": 1.00,
    "CampaignType": 1,
    "RegionId": 1,
    "CurrencyCode": "TRY",
    "StartDate": "2025-09-01",
    "EndDate": "2025-12-31"
}

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	Kampanyaya ait benzersiz kimlik numarası.
Name	string	Kampanyanın adı.
Description	string	Kampanya hakkında açıklayıcı bilgi.
MinimumDepositAmount	decimal	Kampanyanın geçerli olması için gereken minimum yatırma tutarı.
MaximumDepositAmount	decimal	Kampanyanın geçerli olacağı maksimum yatırma tutarı.
BonusType	string	Kampanyada tanımlı olan bonus tipi (ör. oran, sabit tutar).
BonusValue	decimal	Verilecek bonusun değeri.
CampaignType	string	Kampanya türü (ör. yeni kullanıcı, genel).
StartDate	DateTime	Kampanyanın başlangıç tarihi.
EndDate	DateTime	Kampanyanın bitiş tarihi.

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "86f842d6-4846-4e75-bab2-34e3beed6f5b",
        "Name": "External Campaign",
        "Description": "External campaign description",
        "MinimumDepositAmount": 1.00,
        "MaximumDepositAmount": 1000.00,
        "BonusType": "Fixed",
        "BonusValue": 1,
        "CampaignType": "Bonus",
        "StartDate": "2025-09-01",
        "EndDate": "2025-12-31"
    }
}